LABEL |
Étiquette |
|---|---|
| Dockerfile | Docker |
Syntaxe
| LABEL nom=valeur |
| LABEL nom="valeur" |
| LABEL nom="valeur", nom="valeur", nom="valeur",... |
Paramètres
| Nom | Description |
|---|---|
| nom | Ce paramètre permet d'indiquer la clef ou le nom de l'étiquette |
| valeur | Ce paramètre permet d'indiquer la valeur de l'étiquette |
Description
Cette instruction permet d'indiquer une étiquette d'objet.
Remarques
- Vous pouvez ajouter des étiquettes à votre image pour organiser les images par projet, enregistrer les informations de licence, faciliter l'automatisation ou pour d'autres raisons. Pour chaque étiquette, ajoutez une ligne commençant par LABEL et par une ou plusieurs paires de clef et de valeur. Les commentaires explicatifs sont inclus en ligne.
- Si votre chaîne de caractères contient des espaces, elle doit être entre guillemets ou les espaces doivent être échappés. Si votre chaîne de caractères contient des guillemets internes ("), rajouter un échappement.
- Une image peut avoir plusieurs étiquettes. Avant la version Docker 1.10, il était recommandé de combiner toutes les étiquettes en une seule instruction LABEL, pour empêcher la création de couches supplémentaires. Ce n'est plus nécessaire, mais la combinaison d'étiquettes est toujours prise en charge.
Exemples
L'exemple suivant permet d'avoir une étiquette nommé «com.exemple.version» avec la valeur «0.0.2-beta» :
LABEL com.exemple.version="0.0.2-beta"
L'exemple suivant permet d'avoir une étiquette nommé «com.exemple.version.est-production» avec une valeur vide :
LABEL com.exemple.version.est-production=""
L'exemple suivant permet d'avoir plusieurs étiquettes sur une même ligne :
LABEL com.exemple.version="0.0.1-beta" com.exemple.date-realisation="2015-02-12"
Dernière mise à jour : Vendredi, le 7 février 2020