Piloter cloud-init sur une instance Debian ou Ubuntu neuve : user-data, status --wait et relances sans risque

Objectif

Vérifier que cloud-init a terminé la configuration d'une image cloud Debian ou Ubuntu, valider un fichier user-data avant de s'y fier, et le retester sans risque sur la même instance.

Prérequis

Une instance démarrée depuis une image cloud où cloud-init est installé (c'est le cas par défaut sur les images cloud et serveur de Debian et d'Ubuntu) ; un accès shell, idéalement via la console du fournisseur pour le premier démarrage, au cas où le user-data casserait le réseau.

Étapes

1. Après le démarrage, bloquez toute automatisation ultérieure tant que le provisionnement n'est pas terminé : cloud-init status --wait. La référence des commandes décrit --wait comme bloquant "until cloud-init completes" (jusqu'à la fin de cloud-init) ; la sous-commande status seule indique si cloud-init est running, done, disabled ou en erreur, et renvoie le code de sortie 1 en cas de plantage et 2 en cas d'erreurs récupérables.
2. En cas d'échec, consultez les deux fichiers de log vers lesquels cloud-init renvoie lui-même pour le diagnostic : /var/log/cloud-init.log (trace détaillée des modules) et /var/log/cloud-init-output.log (stdout/stderr capturés des commandes exécutées par cloud-init).
3. Avant d'associer un nouveau fichier user-data à une instance, validez-le localement : cloud-init schema --system --annotate. La sous-commande schema permet de "Validate cloud-config files using jsonschema" (valider des fichiers cloud-config avec jsonschema) ; --system la dirige vers le user-data réellement utilisé, au lieu d'un fichier passé en argument ; --annotate signale directement les lignes fautives.
4. Pour retester le provisionnement sur une instance en cours d'exécution plutôt que d'en lancer une nouvelle, réinitialisez l'état de cloud-init : cloud-init clean --logs --reboot. La sous-commande clean supprime les artefacts de cloud-init "to simulate a clean instance" (pour simuler une instance vierge) ; au démarrage suivant, cloud-init rejoue toutes les étapes comme lors du premier démarrage ; --logs efface aussi les anciens fichiers de log, afin que la sortie de la nouvelle exécution ne se mélange pas à l'ancienne.
5. Après le redémarrage, répétez l'étape 1 pour confirmer que la nouvelle exécution est terminée, puis comparez (diff) le nouveau /var/log/cloud-init.log avec le précédent si quelque chose a changé.

Résultat attendu

cloud-init status --wait rend la main après le provisionnement avec le code de sortie 0, et cloud-init schema --system ne signale aucune erreur pour le user-data actif.

Limites et base de vérification

Sur une instance de production, cloud-init clean ne supprime pas lui-même de données utilisateur, mais il réinitialise les marqueurs d'identité de l'hôte qui servent à déterminer « est-ce le premier démarrage » (avec --machine-id, il réinitialise aussi /etc/machine-id). Cette commande est destinée au clonage d'images de référence et aux tests, pas à l'exploitation courante : considérez-la comme une étape de laboratoire. --reboot est nécessaire pour que la réexécution démarre automatiquement ; sans cette option, il faut lancer manuellement cloud-init init.