Red Hat Summit4.2. Inclure les métadonnées dans les images
Définir les métadonnées d’image aide Red Hat OpenShift Service sur AWS à mieux consommer vos images conteneur, permettant à Red Hat OpenShift Service sur AWS de créer une meilleure expérience pour les développeurs utilisant votre image. À titre d’exemple, vous pouvez ajouter des métadonnées pour fournir des descriptions utiles de votre image ou proposer des suggestions sur d’autres images qui peuvent également être nécessaires.
Ce sujet définit uniquement les métadonnées nécessaires à l’ensemble actuel des cas d’utilisation. D’autres métadonnées ou cas d’utilisation peuvent être ajoutés à l’avenir.
4.2.1. Définition des métadonnées d’image
Dans un Dockerfile, vous pouvez utiliser l’instruction LABEL pour définir les métadonnées d’image. Les étiquettes sont similaires aux variables d’environnement en ce qu’elles sont des paires de valeurs clés attachées à une image ou à un conteneur. Les étiquettes sont différentes de la variable d’environnement en ce sens qu’elles ne sont pas visibles pour l’application en cours d’exécution et qu’elles peuvent également être utilisées pour une recherche rapide des images et des conteneurs.
Documentation Docker pour plus d’informations sur l’instruction LABEL.
Les noms d’étiquettes sont généralement espacés. 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. Dans le cas de Red Hat OpenShift Service sur AWS, l’espace de noms est défini sur io.openshift et pour Kubernetes, l’espace de noms est io.k8s.
Consultez la documentation des métadonnées personnalisées Docker pour plus de détails sur le format.
| La variable | Description |
|---|---|
|
| Cette étiquette contient une liste de balises représentées comme une liste de valeurs de chaîne séparées par des virgules. Les balises sont le moyen de catégoriser les images du conteneur dans de larges zones de fonctionnalité. Les balises aident l’interface utilisateur et les outils de génération à suggérer des images de conteneur pertinentes pendant le processus de création d’applications. LABEL io.openshift.tags mongodb,mongodb24,nosql |
|
| Indique 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 des balises spécifiées. Ainsi, si l’image du conteneur veut mysql et redis et que vous n’avez pas l’image du conteneur avec la balise redis, alors UI peut vous suggérer d’ajouter cette image dans votre déploiement. LABEL io.openshift.wants mongodb,redis |
|
| Cette étiquette peut être utilisée pour donner aux consommateurs d’images de conteneur des informations plus détaillées sur le service ou la fonctionnalité que cette image fournit. L’interface utilisateur peut ensuite utiliser cette description avec le nom de l’image du conteneur pour fournir des informations plus conviviales aux utilisateurs finaux. LABEL io.k8s.description The MySQL 5.5 Server with master-slave replication support |
|
| L’image peut utiliser cette variable pour suggérer qu’elle ne prend pas en charge la mise à l’échelle. L’UI communique ensuite cela aux consommateurs de cette image. Être non évolutif signifie que la valeur des répliques ne doit pas initialement être définie plus haut que 1. LABEL io.openshift.non-scalable true |
| IO.openshift.min-memory et io.openshift.min-cpu | Cette étiquette suggère combien de ressources l’image du conteneur a besoin pour fonctionner correctement. L’interface utilisateur peut avertir l’utilisateur que le déploiement de cette image conteneur peut dépasser son quota d’utilisateur. Les valeurs doivent être compatibles avec la quantité de Kubernetes. LABEL io.openshift.min-memory 16Gi LABEL io.openshift.min-cpu 4 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}