1. L'étape du générateur cloud-init, par l'intermédiaire du service systemd, détermine si cloud-init doit être exécuté au démarrage.
2. Au cours de l'étape locale, cloud-init trouve les sources de données locales et applique la configuration du réseau.
3. Pendant la phase de réseau, cloud-init traite les données de l'utilisateur et exécute les modules énumérés sous cloud_init_modules dans votre fichier cloud.cfg. Vous pouvez activer, désactiver ou ajouter des modules à la section cloud_init_modules.
4. Pendant la phase de configuration, cloud-init exécute les modules répertoriés sous cloud_config_modules dans votre fichier cloud.cfg. Vous pouvez activer, désactiver ou ajouter des modules à la section cloud_config_modules.
5. Au cours de la dernière étape, cloud-init peut exécuter ce que vous avez inclus sous cloud_final_modules dans votre fichier cloud.cfg. Vous pouvez inclure des installations de paquets que vous exécutez généralement après le démarrage d'un système, ainsi que des plug-ins de gestion de la configuration et des scripts utilisateur. Vous pouvez activer, désactiver ou ajouter des modules à la section cloud_final_modules.

1. La phase de réseau (cloud_init_modules)
2. La phase de configuration (cloud_config_modules)
3. La phase finale (cloud_final_modules)

Procédure

1. Créer un répertoire nommé cloudinitiso et s'y installer.

   $ mkdir cloudinitiso
   $ cd cloudinitiso

2. Créez un fichier nommé meta-data. Ajoutez les informations suivantes au fichier.

   instance-id: citest
   local-hostname: citest-1

3. Créez un fichier nommé user-data. Incluez les informations suivantes dans le fichier.

   #cloud-config
   password: cilogon
   chpasswd: {expire: False}
   ssh_pwauth: True
   ssh_authorized_keys:
     - ssh-rsa AAA...fhHQ== sample@redhat.com

   Note

   La dernière ligne du fichier user-data fait référence à une clé publique SSH. Vous trouverez vos clés publiques SSH à l'adresse ~/.ssh/id_rsa.pub. Lorsque vous essayez cet exemple de procédure, modifiez la ligne pour inclure l'une de vos clés publiques.

4. Utilisez la commande genisoimage pour créer une image ISO comprenant user-data et meta-data.

   # genisoimage -output ciiso.iso -volid cidata -joliet -rock user-data meta-data
   
   I: -input-charset not specified, using utf-8 (detected in locale settings)
   Total translation table size: 0
   Total rockridge attributes bytes: 331
   Total directory bytes: 0
   Path table size(bytes): 10
   Max brk space used 0
   183 extents written (0 MB)

5. Téléchargez une image d'invité KVM depuis le portail client de Red Hat dans le répertoire /var/lib/libvirt/images.

6. Créez une nouvelle VM à partir de l'image KVM Guest à l'aide de la commande virt-install. Joignez l'image ISO que vous avez créée en tant que pièce jointe à l'image.

   virt-install \
       --memory 4096 \
       --vcpus 4 \
       --name mytestcivm \
       --disk /var/lib/libvirt/images/rhel-8.1-x86_64-kvm.qcow2,device=disk,bus=virtio,format=qcow2 \
       --disk /home/sample/cloudinitiso/ciiso.iso,device=cdrom \
       --os-type Linux \
       --os-variant rhel9.0 \
       --virt-type kvm \
       --graphics none \
       --import

7. Connectez-vous à votre image en tant que cloud-user. Votre mot de passe est cilogon.

   citest-1 login: cloud-user
   Password:
   [cloud-user@citest-1 ~]$

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Remplacer la ligne chpasswd: {expire: False} par chpasswd: {expire: True}.

   #cloud-config
   password: mypassword
   chpasswd: {expire: True}
   ssh_pwauth: True
   ssh_authorized_keys:
     - ssh-rsa AAA...SDvz user1@yourdomain.com
     - ssh-rsa AAB...QTuo user2@yourdomain.com

   Cela permet d'expirer le mot de passe, car password et chpasswd fonctionnent avec l'utilisateur par défaut, sauf indication contraire.

   Note

   Il s'agit d'un paramètre global. Lorsque vous définissez chpasswd sur True, tous les utilisateurs que vous créez doivent modifier leur mot de passe lorsqu'ils se connectent.

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Ajoutez la ligne user: <username>, en remplaçant <username> par le nouveau nom d'utilisateur par défaut.

   #cloud-config
   user: username
   password: mypassword
   chpasswd: {expire: False}
   ssh_pwauth: True
   ssh_authorized_keys:
     - ssh-rsa AAA...SDvz user1@yourdomain.com
     - ssh-rsa AAB...QTuo user2@yourdomain.com

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Créez une liste d'utilisateurs dans la section chpasswd du fichier. Le format est présenté dans l'exemple suivant.

   Note

   Les espaces blancs sont importants. N'incluez pas d'espace blanc avant ou après les deux points dans votre liste d'utilisateurs. Si vous incluez des espaces, le mot de passe est défini avec un espace.

   #cloud-config
   ssh_pwauth: True
   ssh_authorized_keys:
     - ssh-rsa AAA...SDvz user1@yourdomain.com
     - ssh-rsa AAB...QTuo user2@yourdomain.com
   chpasswd:
     list: |
        root:myrootpassword
        cloud-user:mypassword
     expire: False

   Note

   Si vous utilisez cette méthode pour définir le mot de passe utilisateur, vous devez définir all passwords dans cette section.

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Ajouter ou modifier la section users pour ajouter des utilisateurs.

   • Si vous souhaitez que cloud-user soit l'utilisateur par défaut créé avec les autres utilisateurs que vous spécifiez, veillez à ajouter default comme première entrée de la section. S'il ne s'agit pas de la première entrée, cloud-user n'est pas créé.

   • Par défaut, les utilisateurs sont étiquetés comme unconfined_u s'il n'y a pas de valeur selinux-user.

     #cloud-config
     users:
       - default
       - name: user2
         gecos: User N. Ame
         selinux-user: staff_u
         groups: users,wheel
         ssh_pwauth: True
         ssh_authorized_keys:
           - ssh-rsa AA..vz user@domain.com
     chpasswd:
       list: |
         root:password
         cloud-user:mypassword
         user2:mypassword2
       expire: False

     Note

     • L'exemple place l'utilisateur user2 dans deux groupes, users et wheel.

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Ajoutez les sections pour bootcmd et runcmd; incluez les commandes que vous voulez que cloud-init exécute.

   #cloud-config
   users:
     - default
     - name: user2
       gecos: User N. Ame
       groups: users
   chpasswd:
     list: |
       root:password
       fedora:myfedpassword
       user2:mypassword2
     expire: False
   bootcmd:
    - echo New MOTD >> /etc/motd
   runcmd:
    - echo New MOTD2 >> /etc/motd

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Ajoutez une entrée sudo et spécifiez l'accès de l'utilisateur. Par exemple, sudo: ALL=(ALL) NOPASSWD:ALL permet à un utilisateur d'avoir un accès illimité.

3. Ajoutez une entrée groups et spécifiez les groupes qui incluent l'utilisateur.

   #cloud-config
   users:
     - default
     - name: user2
       gecos: User D. Two
       sudo: ["ALL=(ALL) NOPASSWD:ALL"]
       groups: wheel,adm,systemd-journal
       ssh_pwauth: True
       ssh_authorized_keys:
         - ssh-rsa AA...vz user@domain.com
   chpasswd:
     list: |
       root:password
       cloud-user:mypassword
       user2:mypassword2
     expire: False

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Ajouter une section network-interfaces.

   network:
     version: 1
     config:
       - type: physical
         name: eth0
         subnets:
           - type: static
             address: 192.168.1.10/24
             gateway: 192.168.1.254

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Créez une entrée pour l'utilisateur root dans la section users.

   L'exemple simple qui suit inclut une section users avec uniquement l'option name.

   users:
     - name: root
   chpasswd:
     list: |
       root:password
     expire: False

3. Optionnellement, configurez les clés SSH pour l'utilisateur root.

   users:
     - name: root
       ssh_pwauth: True
       ssh_authorized_keys:
         - ssh-rsa AA..vz user@domain.com

Procédure

1. En fonction des exigences de votre source de données, ouvrez votre fichier de données utilisateur pour l'éditer ou ajoutez la directive suivante au répertoire cloud.cfg.d.

   Note

   Toutes les directives utilisateur incluent #cloud-config en tête de fichier afin que cloud-init reconnaisse le fichier comme contenant des directives utilisateur. Lorsque vous incluez des directives dans le répertoire cloud.cfg.d, nommez le fichier *.cfg et incluez toujours #cloud-config en tête du fichier.

2. Ajoutez ou modifiez le module write_files pour inclure le chemin d'accès à l'utilitaire container-storage-setup.

   L'exemple suivant définit la taille du volume logique racine à 6 Go au lieu des 3 Go par défaut.

   write_files:
     - path: /etc/sysconfig/docker-storage-setup
       permissions: 0644
       owner: root
       content: |
       ROOT_SIZE=6G

   Note

   Avant RHEL 7.4, container-storage-setup s'appelait docker-storage-setup. Si vous utilisez OverlayFS pour le stockage, à partir de RHEL 7.4, vous pouvez désormais utiliser ce type de système de fichiers avec SELinux en mode d'application.

Procédure

1. Selon les exigences de votre source de données, ouvrez votre fichier de métadonnées pour l'éditer ou ajoutez la directive suivante au fichier cloud.cfg ou au répertoire cloud.cfg.d.
2. Ajoutez la directive locale, en spécifiant l'emplacement. L'exemple suivant définit locale comme étant ja_JP (Japon) avec l'encodage UTF-8.

Procédure

1. Ouvrez le fichier /etc/cloud/cloud.cfg pour le modifier.

2. Commentez ou supprimez la configuration que vous ne voulez pas que cloud-init mette à jour lorsque vous restaurez votre instance.

   Par exemple, pour éviter de mettre à jour le fichier de clés SSH, supprimez -ssh de la section cloud_init_modules.

   cloud_init_modules:
    - disk_setup
    - migrator
    - bootcmd
    - write-files
    - growpart
    - resizefs
    - set_hostname
    - update_hostname
    - update_etc_hosts
    - rsyslog
    - users-groups
    # - ssh

Procédure

1. Connectez-vous à votre VM.
2. Ajouter ou modifier des directives, par exemple, modifier le fichier cloud.cfg dans le répertoire /etc/cloud ou ajouter des directives dans le répertoire /etc/cloud/cloud.cfg.d.

3. Exécutez la commande cloud-init clean pour nettoyer les répertoires afin que cloud-init puisse être réexécuté. Vous pouvez également exécuter les commandes suivantes en tant que root pour nettoyer la VM.

   `rm -Rf /var/lib/cloud/instances/*`
   `rm -Rf /var/lib/cloud/instance`
   `rm -Rf /var/lib/cloud/data/*`

   Note

   Vous pouvez enregistrer l'image nettoyée en tant que nouvelle image et utiliser cette image pour plusieurs machines virtuelles. Les nouvelles machines virtuelles exécutent cloud-init en utilisant votre configuration cloud-init mise à jour.

4. Réexécutez cloud-init ou redémarrez la VM.

   cloud-init s'exécute à nouveau, en appliquant les changements de configuration que vous avez apportés.

Procédure

1. Créer et lancer une instance pour la plateforme OpenStack. Pour plus d'informations sur la création d'instances pour OpenStack, voir Créer une instance. Dans cet exemple, notre machine virtuelle inclut cloud-init, qui s'exécute au démarrage de la machine virtuelle.
2. Ajouter ou modifier des directives. Par exemple, modifier le fichier user-data.file qui est stocké sur le serveur HTTP OpenStack.

3. Nettoyez la machine virtuelle. Exécutez les commandes suivantes en tant que root.

   `rm -rf /etc/resolv.conf /run/cloud-init`
   `userdel -rf cloud-user`
   `hostnamectl set-hostname localhost.localdomain`
   `rm /etc/NetworkManager/conf.d/99-cloud-init.conf`

   Note

   Vous pouvez enregistrer l'image nettoyée en tant que nouvelle image et utiliser cette image pour plusieurs machines virtuelles. Les nouvelles machines virtuelles exécutent cloud-init en utilisant votre configuration cloud-init mise à jour.

4. Réexécutez cloud-init ou redémarrez la machine virtuelle.

   Cloud-init est réexécuté et met en œuvre les modifications de configuration que vous avez apportées.

Procédure

1. Examinez les fichiers de configuration de cloud-init.

   1. Examinez le fichier de configuration /etc/cloud/cloud.cfg. Vérifiez quels modules sont inclus sous cloud_init_modules, cloud_config_modules, et cloud_final_modules.
   2. Vérifier les directives (fichiers*.cfg ) dans le répertoire /etc/cloud/cloud.cfg.d.

2. Consultez les fichiers /var/log/cloud-init.log et /var/log/cloud-init-output.log pour obtenir des détails sur un problème spécifique. Par exemple, si le problème est que la partition racine n'a pas été automatiquement étendue, consultez les messages du journal growpart. Si le système de fichiers n'a pas été étendu, consultez les messages de resizefs. Par exemple, si le système de fichiers n'a pas été étendu, vérifiez les messages du journal :

   # grep resizefs /var/log/cloud-init.log

   Note

   growpart ne prend pas en charge LVM. Si votre partition racine est basée sur LVM, la partition racine n'est pas automatiquement étendue au premier démarrage.

3. Réexécuter cloud-init. Voici des exemples de scénarios. Exécutez les commandes en tant que root.

   • Réexécuter cloud-init avec seulement les modules init.

     /usr/bin/cloud-init -d init

   • Relancez cloud-init avec tous les modules de votre configuration.

     /usr/bin/cloud-init -d modules

   • Supprimer le cache de cloud-init et forcer cloud-init à s'exécuter après le démarrage.

     rm -rf /var/lib/cloud/* && /usr/bin/cloud-init -d init

   • Exécutez les commandes suivantes pour nettoyer les répertoires et simuler une instance propre.

     rm -Rf /var/lib/cloud/instances/*
     rm -Rf /var/lib/cloud/instance
     rm -Rf /var/lib/cloud/data/*
     reboot

   • Exécutez les commandes suivantes pour réexécuter cloud-init.

     cloud-init init --local
     cloud-init init