// travaux pratiques · Administration système
TP05 - Standardiser les instances avec profils et cloud-init
- TP 5 / 6
- 7 étapes
- ≈ 50 min
- Accès libre
Objectif : créer un profil « web » qui regroupe limites de ressources et configuration cloud-init, lancer à partir de lui un serveur web prêt à l’emploi sans aucune commande manuelle dans l’instance, puis observer comment profils et configuration propre à l’instance se combinent.
Contexte
Installer nginx à la main dans un conteneur, comme au TP02, ne pose pas de problème pour une instance. À la dixième, les écarts apparaissent : un paquet oublié, une limite non posée, un fichier de configuration différent. Les profils et cloud-init répondent à ce problème : on décrit une fois ce qu’est un « serveur web standard » et chaque nouvelle instance naît conforme.
Dans une petite structure, c’est un gain de temps et une documentation vivante ; dans un grand groupe, c’est la condition pour gérer des centaines d’instances, car ces fichiers YAML se versionnent, se relisent et s’intègrent aux outils d’automatisation. À la fin du TP, vous saurez écrire un profil, y placer un document cloud-config et expliquer l’ordre d’application des réglages.
Prérequis : TP01 à TP04 terminés, un éditeur de texte sur l’hôte (nano ou vim), accès Internet pour les paquets.
Durée estimée : 50 minutes.
Actions à réaliser
Étape 1 : examiner les profils existants
Avant de créer un profil, on regarde ce que contient celui qui est appliqué partout.
incus profile list
incus profile show default
Résultat attendu : la liste montre le profil default et le nombre d’instances qui l’utilisent ; son contenu se limite aux périphériques root et eth0, sans clé de configuration. Toute instance créée sans profil explicite en hérite.
Étape 2 : créer le profil et rédiger sa définition
On crée un profil vide, puis on écrit sa définition dans un fichier YAML, plus facile à relire et à versionner qu’une suite de commandes.
incus profile create web
nano web.yaml
Contenu du fichier web.yaml :
description: Serveur web standard
config:
limits.cpu: "1"
limits.memory: 512MiB
cloud-init.user-data: |
#cloud-config
package_update: true
packages:
- nginx
write_files:
- path: /var/www/html/index.html
content: |
<h1>Instance creee par le profil web</h1>
devices: {}
La clé cloud-init.user-data contient un document qui doit commencer par #cloud-config : mise à jour des index de paquets, installation de nginx, création d’une page d’accueil. Les guillemets autour de "1" imposent une chaîne, format attendu par Incus pour les valeurs de configuration. Le profil ne déclare aucun périphérique : disque et carte réseau viendront du profil default.
Étape 3 : charger la définition dans le profil
incus profile edit web < web.yaml
incus profile show web
profile edit remplace tout le contenu du profil par celui du fichier. Résultat attendu : profile show affiche la description, les deux limites et le document cloud-init, sans erreur de syntaxe. Une indentation incorrecte dans le YAML provoque un refus explicite de la commande.
Étape 4 : lancer une instance à partir du profil
cloud-init ne s’exécute que si l’image l’embarque : on utilise donc la variante /cloud de l’image Debian. On applique les deux profils dans l’ordre : default puis web.
incus launch images:debian/12/cloud web02 --profile default --profile web
incus exec web02 -- cloud-init status --wait
curl http://<adresse-IP-de-web02>
L’option --wait bloque jusqu’à la fin de l’exécution de cloud-init. Résultat attendu : l’état final est done ; curl renvoie le titre « Instance creee par le profil web ». Aucune commande n’a été tapée dans l’instance : tout vient du profil.
Étape 5 : observer la priorité des réglages
Une clé définie directement sur l’instance l’emporte sur celle des profils. On le vérifie sur la mémoire.
incus config set web02 limits.memory=1GiB
incus config show web02 --expanded
incus exec web02 -- free -m
Résultat attendu : la configuration effective indique limits.memory: 1GiB et free affiche environ 1 Gio, alors que le profil prévoit 512 Mio. Le profil reste la règle générale, l’instance l’exception.
Étape 6 : faire évoluer le profil
Modifier un profil modifie toutes les instances qui l’utilisent, à chaud pour les clés qui le permettent.
incus profile set web limits.cpu=2
incus exec web02 -- nproc
Résultat attendu : nproc renvoie désormais 2, sans redémarrage. Ce mécanisme est puissant : une modification de profil peut toucher des dizaines d’instances à la fois, d’où l’importance de la relecture.
Étape 7 : appliquer le profil à une instance existante
incus profile add web01 web
incus config show web01 --expanded
incus profile list
Résultat attendu : web01 reçoit les limites du profil, et la liste indique deux instances utilisant web. En revanche, le document cloud-init n’est pas exécuté sur web01 : cloud-init n’agit qu’au premier démarrage, et l’image utilisée au TP02 ne l’embarque pas.
Vérification
Le TP est réussi si incus profile show web affiche votre définition, si web02 sert la page créée par cloud-init sans intervention manuelle, si sa configuration effective montre 1 Gio de mémoire et 2 processeurs, et si incus profile list indique deux instances utilisant le profil web.
Problèmes fréquents
cloud-init statusest introuvable ou rien ne s’installe. Cause : l’instance a été créée à partir d’une image sans cloud-init (images:debian/12au lieu deimages:debian/12/cloud). Correction : recréer l’instance avec la variante/cloud.profile editrefuse le fichier. Cause : erreur d’indentation YAML ou tabulations à la place d’espaces. Correction : réindenter avec des espaces et vérifier que le bloc cloud-init est bien introduit par|.- cloud-init se termine en erreur. Cause : document qui ne commence pas par
#cloud-config, nom de paquet erroné ou absence d’accès aux dépôts. Correction : lire/var/log/cloud-init-output.logdans l’instance. - L’instance n’a pas de carte réseau. Cause : seul le profil
weba été indiqué, sansdefaultqui apporte disque et carte. Correction : lancer avec--profile default --profile web.
Bonnes pratiques et sécurité
- Versionnez les fichiers de profil dans un dépôt Git et faites relire toute modification : un profil s’applique à toutes les instances qui l’utilisent.
- Ne placez aucun mot de passe en clair dans cloud-init : préférez les clés SSH publiques et les secrets injectés par un outil dédié.
- Gardez des profils petits et spécialisés (limites, réseau, rôle) que l’on combine, plutôt qu’un profil unique qui fait tout.
- Créez les instances de production avec
incus initquand vous devez encore ajuster leur configuration : cloud-init ne s’exécute qu’au premier démarrage.
Questions de contrôle
1. Dans quel ordre s’appliquent les réglages d’une instance ?
Voir la réponse
Les profils s’appliquent dans l’ordre indiqué, chacun pouvant écraser le précédent, puis la configuration propre à l’instance l’emporte sur tous les profils.
2. Pourquoi utiliser l’image images:debian/12/cloud ?
Voir la réponse
Parce que seules les variantes /cloud du serveur images: embarquent cloud-init, nécessaire pour exécuter la clé cloud-init.user-data.
3. Pourquoi le document cloud-init n’a-t-il rien fait sur web01 ?
Voir la réponse
Parce que cloud-init ne s’exécute qu’au premier démarrage d’une instance et que l’image de web01 ne l’embarque pas.
Pour aller plus loin
Les profils décrivent l’état initial ; pour la configuration continue des instances, un outil comme Ansible prend le relais : voir le cours Introduction à Ansible. Sur un grand parc, les profils eux-mêmes se déclarent avec le fournisseur Terraform/OpenTofu d’Incus, ce qui permet de revoir chaque changement avant application. L’article du blog sur Incus présente d’autres cas d’usage.
Conservez web01, web02 et db01 pour le dernier TP.
// formation sur mesure
Former votre équipe sur ce sujet ?
Azur Secure anime des sessions intra-entreprise, à distance ou dans vos locaux sur la Côte d'Azur, adaptées au niveau de vos équipes.