4.2. Inclure des métadonnées dans les images
Définir des métadonnées d'image aide OpenShift Container Platform à mieux consommer vos images de conteneurs, permettant à OpenShift Container Platform de créer une meilleure expérience pour les développeurs qui utilisent votre image. Par exemple, vous pouvez ajouter des métadonnées pour fournir des descriptions utiles de votre image, ou offrir des suggestions sur d'autres images qui pourraient également être nécessaires.
Cette rubrique ne définit que les métadonnées nécessaires à la série actuelle de cas d'utilisation. D'autres métadonnées ou cas d'utilisation pourront être ajoutés à l'avenir.
4.2.1. Définition des métadonnées de l'image
Vous pouvez utiliser l'instruction LABEL
dans une page Dockerfile
pour définir les métadonnées de l'image. Les étiquettes sont similaires aux variables d'environnement en ce sens qu'il s'agit de paires clé-valeur attachées à une image ou à un conteneur. Les étiquettes sont différentes des variables d'environnement en ce sens qu'elles ne sont pas visibles par l'application en cours d'exécution et qu'elles peuvent également être utilisées pour la recherche rapide d'images et de conteneurs.
Documentation Docker pour plus d'informations sur l'instruction LABEL
.
Les noms des étiquettes sont généralement associés à un espace de noms. L'espace de noms est défini en conséquence pour refléter le projet qui va récupérer les étiquettes et les utiliser. Pour OpenShift Container Platform, l'espace de noms est défini sur io.openshift
et pour Kubernetes, l'espace de noms est io.k8s
.
Voir la documentation sur les métadonnées personnalisées de Docker pour plus de détails sur le format.
Variable | Description |
---|---|
| Cette étiquette contient une liste de balises représentées sous la forme d'une liste de valeurs séparées par des virgules. Les balises permettent de classer les images de conteneurs dans de vastes domaines de fonctionnalité. Les balises aident les outils d'interface utilisateur et de génération à suggérer des images de conteneur pertinentes au cours du processus de création de l'application. LABEL io.openshift.tags mongodb,mongodb24,nosql |
|
Spécifie une liste de balises que les outils de génération et l'interface utilisateur utilisent pour fournir des suggestions pertinentes si vous n'avez pas déjà les images de conteneur avec les balises spécifiées. Par exemple, si l'image de conteneur veut LABEL io.openshift.wants mongodb,redis |
| Cette étiquette peut être utilisée pour donner aux consommateurs de l'image de conteneur des informations plus détaillées sur le service ou la fonctionnalité que cette image fournit. L'interface utilisateur peut alors utiliser cette description avec le nom de l'image de conteneur pour fournir des informations plus conviviales aux utilisateurs finaux. LABEL io.k8s.description The MySQL 5.5 Server with master-slave replication support |
|
Une image peut utiliser cette variable pour indiquer qu'elle ne prend pas en charge la mise à l'échelle. L'interface utilisateur le communique alors aux consommateurs de cette image. Le fait que l'image ne soit pas extensible signifie que la valeur de LABEL io.openshift.non-scalable true |
| Cette étiquette indique la quantité de ressources dont l'image du conteneur a besoin pour fonctionner correctement. L'interface utilisateur peut avertir l'utilisateur que le déploiement de cette image de conteneur peut dépasser son quota. Les valeurs doivent être compatibles avec la quantité de Kubernetes. LABEL io.openshift.min-memory 16Gi LABEL io.openshift.min-cpu 4 |