Configuración y gestión de cloud-init para RHEL 8

1. La etapa generadora de cloud-init, a través del servicio systemd, determina si se ejecuta cloud-init en el arranque.
2. Durante la etapa local, cloud-init encuentra las fuentes de datos locales y aplica la configuración de la red.
3. Durante la etapa de red, cloud-init procesa los datos del usuario y ejecuta los módulos listados en cloud_init_modules en su archivo cloud.cfg. Puedes activar, desactivar o añadir módulos a la sección cloud_init_modules.
4. Durante la etapa de configuración, cloud-init ejecuta los módulos listados en cloud_config_modules en su archivo cloud.cfg. Puedes activar, desactivar o añadir módulos a la sección cloud_config_modules.
5. Durante la etapa final, cloud-init puede ejecutar lo que haya incluido en cloud_final_modules en su archivo cloud.cfg. Puede incluir instalaciones de paquetes que normalmente se ejecutan tras el arranque del sistema y también puede incluir complementos de gestión de la configuración y scripts de usuario. Puede habilitar, deshabilitar o añadir módulos a la sección cloud_final_modules.

Procedimiento

1. Cree un directorio llamado cloudinitiso y muévase a él.

   $ mkdir cloudinitiso
   $ cd cloudinitiso

2. Cree un archivo llamado meta-data. Añade la siguiente información al archivo.

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

3. Cree un archivo llamado user-data. Incluya la siguiente información en el archivo.

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

   Nota

   La última línea del archivo user-data hace referencia a una clave pública SSH. Encuentre sus claves públicas SSH en ~/.ssh/id_rsa.pub. Cuando intente este procedimiento de ejemplo, modifique la línea para incluir una de sus claves públicas.

4. Utilice el comando genisoimage para crear una imagen ISO que incluya user-data y 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. Descargue una imagen de invitado KVM desde el Portal del Cliente de Red Hat al directorio /var/lib/libvirt/images.

6. Cree una nueva VM a partir de la imagen huésped de KVM utilizando el comando virt-install. Incluya la imagen ISO que ha creado como archivo adjunto a la imagen.

   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 rhel8.0 \
       --virt-type kvm \
       --graphics none \
       --import

7. Acceda a su imagen como cloud-user. Su contraseña es cilogon.

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

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Cambie la línea chpasswd: {expire: False} por 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

   Esto funciona para caducar la contraseña porque password y chpasswd operan con el usuario por defecto a menos que se indique lo contrario.

   Nota

   Esta es una configuración global. Si establece chpasswd en True, todos los usuarios que cree deberán cambiar sus contraseñas cuando se conecten.

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Añade la línea user: <username>, sustituyendo <username> por el nuevo nombre de usuario por defecto.

   #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

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Cree una lista de usuarios en la sección chpasswd del archivo. El formato se muestra en el siguiente ejemplo.

   Nota

   Los espacios en blanco son importantes. No incluya espacios en blanco antes o después de los dos puntos en su lista de usuarios. Si incluye espacios en blanco, la contraseña se establece con un espacio en ella.

   #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

   Nota

   Si utiliza este método para establecer la contraseña del usuario, debe establecer all passwords en esta sección.

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Añade o modifica la sección users para añadir usuarios.

   • Si quieres que cloud-user sea el usuario creado por defecto junto con los demás usuarios que especifiques, asegúrate de añadir default como primera entrada de la sección. Si no es la primera entrada, no se crea cloud-user.

   • Por defecto, los usuarios son etiquetados como unconfined_u si no hay un valor 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

     Nota
     • El ejemplo coloca al usuario user2 en dos grupos, users y wheel.
     • A partir de cloud-init 0.7.5, la lista de grupos no admite espacios en blanco. Consulte BZ 1126365 para obtener más información.

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Añade las secciones para bootcmd y runcmd; incluye los comandos que quieras que ejecute cloud-init.

   #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

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Añada una entrada en sudo y especifique el acceso del usuario. Por ejemplo, sudo: ALL=(ALL) NOPASSWD:ALL permite a un usuario el acceso sin restricciones.

3. Añade una entrada en groups y especifica los grupos que incluyen al usuario.

   #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. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Añade una sección network-interfaces.

   network-interfaces: |
     iface eth0 inet static
     address 192.168.1.10
     network 192.168.1.0
     netmask 255.255.255.0
     broadcast 192.168.1.255
     gateway 192.168.1.254
   bootcmd:
     - ifdown eth0
     - ifup eth0

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Cree una entrada para el usuario root en la sección users.

   El sencillo ejemplo que sigue incluye una sección users con sólo la opción name.

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

3. Opcionalmente, configure las claves SSH para el usuario root.

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

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de datos de usuario para editarlo, o bien añada la siguiente directiva al directorio cloud.cfg.d.

   Nota

   Todas las directivas de usuario incluyen #cloud-config al principio del archivo para que cloud-init reconozca que el archivo contiene directivas de usuario. Cuando incluya directivas en el directorio cloud.cfg.d, nombre el archivo *.cfg, e incluya siempre #cloud-config al principio del archivo.

2. Añada o modifique el módulo write_files para incluir la ruta de acceso a la utilidad container-storage-setup.

   El siguiente ejemplo establece el tamaño del volumen lógico raíz a 6GB en lugar de los 3GB por defecto.

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

   Nota

   Antes de RHEL 7.4, container-storage-setup se llamaba docker-storage-setup. Si está utilizando OverlayFS para el almacenamiento, a partir de RHEL 7.4 puede utilizar ese tipo de sistema de archivos con SELinux en modo de refuerzo.

Procedimiento

1. Dependiendo de los requisitos de su fuente de datos, abra su archivo de metadatos para editarlo, o bien añada la siguiente directiva al archivo cloud.cfg o al directorio cloud.cfg.d.
2. Añade la directiva locale, especificando la ubicación. El siguiente ejemplo establece el locale a ja_JP (Japón) con codificación UTF-8.

Procedimiento

1. Abra el archivo /etc/cloud/cloud.cfg para editarlo.

2. Comente o elimine la configuración que no desea que cloud-init actualice cuando restaure su instancia.

   Por ejemplo, para evitar la actualización del archivo de claves SSH, elimine -ssh de la sección 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

Procedimiento

1. Inicie sesión en su máquina virtual.
2. Añada o cambie las directivas, por ejemplo, modifique el archivo cloud.cfg en el directorio /etc/cloud o añada directivas al directorio /etc/cloud/cloud.cfg.d.

3. Ejecute el comando cloud-init clean para limpiar los directorios y así poder volver a ejecutar cloud-init. También puede ejecutar los siguientes comandos como root para limpiar la VM.

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

   Nota

   Puede guardar la imagen limpiada como una nueva imagen y utilizarla para varias máquinas virtuales. Las nuevas máquinas virtuales se ejecutan en cloud-init utilizando la configuración actualizada de cloud-init.

4. Vuelva a ejecutar cloud-init o reinicie la máquina virtual.

   cloud-init vuelve a ejecutarse, implementando los cambios de configuración que ha realizado.

Procedimiento

1. Cree y lance una instancia para la plataforma OpenStack. Consulte Instancias de máquinas vir tuales para obtener información sobre la creación de instancias para OpenStack. En este ejemplo, nuestra máquina virtual incluye cloud-init, que se ejecuta al arrancar la máquina virtual.
2. Agregue o cambie las directivas. Por ejemplo, modificar el archivo user-data.file que se almacena en el servidor HTTP de OpenStack.

3. Limpie la máquina virtual. Ejecute los siguientes comandos como 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`

   Nota

   Puede guardar la imagen limpiada como una nueva imagen y utilizarla para varias máquinas virtuales. Las nuevas máquinas virtuales ejecutan cloud-init utilizando su configuración actualizada de cloud-init.

4. Vuelva a ejecutar cloud-init o reinicie la máquina virtual.

   Cloud-init se vuelve a ejecutar, implementando los cambios de configuración realizados.

Procedimiento

1. Revise los archivos de configuración de cloud-init.

   1. Examine el archivo de configuración /etc/cloud/cloud.cfg. Compruebe qué módulos están incluidos en cloud_init_modules, cloud_config_modules, y cloud_final_modules.
   2. Compruebe las directivas (archivos*.cfg ) en el directorio /etc/cloud/cloud.cfg.d.

2. Revise los archivos /var/log/cloud-init.log y /var/log/cloud-init-output.log para obtener detalles sobre un problema específico. Por ejemplo, si el problema era que la partición raíz no se extendía automáticamente, compruebe los mensajes de registro de growpart. Si el sistema de archivos no se extendió, revise los mensajes de registro para resizefs. A continuación se muestra un ejemplo de comando grep para resizefs.

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

   Nota

   growpart no soporta LVM. Si su partición raíz está basada en LVM, la partición raíz no se extiende automáticamente en el primer arranque.

3. Vuelva a ejecutar cloud-init. A continuación se presentan ejemplos de escenarios. Ejecute los comandos como root.

   • Vuelva a ejecutar cloud-init sólo con los módulos init.

     /usr/bin/cloud-init -d init

   • Vuelva a ejecutar cloud-init con todos los módulos de su configuración.

     /usr/bin/cloud-init -d módulos

   • Borrar la caché de cloud-init y forzar la ejecución de cloud-init tras el arranque.

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

   • Ejecute los siguientes comandos para limpiar los directorios y simular una instancia limpia.

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

   • Ejecute los siguientes comandos para volver a ejecutar cloud-init.

     cloud-init init --local
     cloud-init init