Bibliothèque de modèles
À quoi sert cet écran
La Templates Library est un catalogue de modèles de Dockerfile prédéfinis dont vous pouvez partir plutôt que d’écrire une construction de conteneur à la main. Choisissez le modèle correspondant à votre stack, générez, ajustez.
Avant de commencer
| Pour faire ceci | Il vous faut |
|---|---|
| Ouvrir la bibliothèque | la permission de lecture Dockerfile de local-env |
Ouvrir l’écran
- Tools › Templates Library dans la barre latérale.
URL directe : /developer-tools/predefined-templates-library
L’interface
📸 Capture d’écran : La bibliothèque de modèles. Repères : (1) la liste des modèles, (2) la carte d’un modèle, (3) l’action qui ouvre un modèle.
| # | Élément | Ce qu’il fait | Quand l’utiliser |
|---|---|---|---|
| 1 | Liste des modèles | Les modèles de Dockerfile prédéfinis | Chercher celui de votre stack |
| 2 | Carte de modèle | À quoi sert le modèle | Choisir |
| 3 | Ouvrir | Charge le modèle dans le générateur | Une fois le choix fait |
Ouvrir un modèle vous amène au générateur, sur
/developer-tools/predefined-templates-library/:template.
Procédures
Générer un Dockerfile depuis un modèle
- Tools › Templates Library.
- Trouvez le modèle correspondant à votre stack.
- Ouvrez-le. Le générateur se charge avec ce modèle appliqué.
- Ajustez le Dockerfile généré et versionnez-le dans votre dépôt.
Partir de zéro à la place
Si aucun modèle ne convient, utilisez
l’Image Builder sur
/developer-tools/from-scratch-docker-generator, accessible normalement depuis
Build › Image Builder.
Scénario
Conteneuriser un service dont vous n’avez jamais empaqueté la stack.
- Tools › Templates Library — cherchez le modèle correspondant à la stack, pas au framework. Les modèles s’organisent autour du runtime, car c’est lui qui détermine l’image de base et les étapes de build.
- Ouvrez-le et lisez ce qu’il produit avant de générer. Un modèle qui convient presque vaut la peine d’être adapté ; un modèle qui convient mal coûte plus cher que de partir de zéro.
- Générez, puis ajustez. La sortie est un point de départ, pas un Dockerfile fini : la taille de l’image et le cache de couches restent à votre charge.
- Versionnez-le dans le dépôt, puis connectez ce dépôt dans Settings › Development › Repositories s’il ne l’est pas déjà.
- Analysez l’image construite avec Security Scanner avant qu’elle n’atteigne un environnement. Une image de base venue d’un modèle reste une image de base dont vous êtes désormais responsable.
Si aucun modèle ne convient, l’Image Builder en construit un de zéro et est accessible depuis Build › Image Builder.
En cas de problème
| Symptôme | Cause | Comment vérifier | Solution |
|---|---|---|---|
| La page est vide ou refusée | Il manque la permission de lecture Dockerfile | Access Explorer | Demandez un rôle qui l’accorde |
| Aucun modèle ne correspond à votre stack | La bibliothèque est un ensemble fixe | — | Utilisez l’Image Builder |
Pour aller plus loin
- Image Builder — en construire un de zéro
- Security Scanner — analyser l’image obtenue