Elastic Compute Service:Install cloud-init

Para obtener más información sobre cloud-init, consulte la documentación oficial de cloud-init.

Escenarios

Paso 1: Comprobar si necesita instalar o actualizar cloud-init

1. Inicie sesión en el servidor de origen.

2. Ejecute los siguientes comandos para comprobar si cloud-init está instalado.

   Serie CentOS

   rpm -qa | grep -i cloud-init 
   pip list | grep -i cloud-init

   Serie Ubuntu

   dpkg -l | grep -i cloud-init 
   pip list | grep -i cloud-init

   • Si no se devuelve ninguna salida o la versión es anterior a la 0.7.9: Debe Step 2: Install cloud-init.

     Importante

     La versión 0.7.9 es una edición comunitaria temprana de cloud-init y no sirve para inicializar instancias ECS. Debe actualizar a una versión posterior.

   • Si la versión es la 18 o posterior: No necesita instalar cloud-init. Sin embargo, cloud-init configura automáticamente la red durante la inicialización de la instancia. Si la configuración predeterminada no cumple con sus requisitos, puede deshabilitar la función de inicialización de red. Para obtener más información, consulte Disable automatic network initialization by Alibaba Cloud.

   • Si la versión es la 19.1.21: Le recomendamos actualizar a Alibaba Cloud cloud-init 23.2.2. En comparación con Alibaba Cloud cloud-init 19.1.21, la versión 23.2.2 ofrece las siguientes mejoras y funciones:

     • Si la versión de cloud-init de una instancia es la 23.2.2, la instancia admite el acceso a metadatos en modo de refuerzo de seguridad. Para obtener más información sobre los metadatos de la instancia, consulte Instance metadata.

     • Otras mejoras de funciones y rendimiento, correcciones de bugs y contribuciones de la comunidad. Para obtener más información, consulte el archivo ChangeLog.

   • Otros casos: No necesita instalar cloud-init. Puede ejecutar directamente las operaciones descritas en What to do next.

3. Para evitar la pérdida de datos por operaciones accidentales durante la instalación de cloud-init, le recomendamos respaldar primero los datos del servidor de origen. Por ejemplo, puede crear instantáneas.

Paso 2: Instalar cloud-init

• Alibaba Cloud cloud-init 23.2.2: versión recomendada. Depende de Python 3.6 o posterior y utiliza el origen de datos Aliyun.

• Alibaba Cloud cloud-init 19.1.21: depende de Python 3.6 o posterior y utiliza el origen de datos Aliyun.

• Alibaba Cloud cloud-init 0.7.6a18: necesaria para ciertos sistemas operativos antiguos, como CentOS 6, Debian 9 y SUSE Linux Enterprise Server 12. Depende de Python 2.7 y utiliza el origen de datos Aliyun.

  Importante

  La comunidad de Python dejó de dar soporte técnico a Python 2.7. Le recomendamos usar una versión más reciente de cloud-init siempre que sea posible para evitar posibles problemas con las bibliotecas de dependencias.

• Edición comunitaria de cloud-init: la mantiene la propia comunidad. La versión más reciente de Alibaba Cloud cloud-init es la 23.2.2. Si requiere una versión posterior de cloud-init, puede instalar la edición comunitaria. Para obtener más información sobre las versiones, consulte el sitio web oficial de cloud-init.

La edición comunitaria es la versión oficial del proyecto cloud-init, mientras que Alibaba Cloud cloud-init está optimizada para la plataforma de Alibaba Cloud y ofrece mejor compatibilidad con sus servicios. Por ello, le recomendamos utilizar Alibaba Cloud cloud-init. Seleccione la edición de cloud-init que va a instalar según sus necesidades reales.

# Check and install python3-pip
if ! python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Back up the earlier version of cloud-init
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress Alibaba Cloud cloud-init
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install cloud-init
issue_major=$( cat /etc/redhat-release | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh centos "$issue_major"

# Check and install python3-pip
if ! python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Back up the earlier version of cloud-init
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress Alibaba Cloud cloud-init
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install cloud-init
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh rhel "$issue_major"

# Check and install python3-pip
if ! python3 -c 'import setuptools' >& /dev/null; then
  apt-get install python36 python3-pip -y
fi
# Back up the earlier version of cloud-init
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress Alibaba Cloud cloud-init
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install cloud-init
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh ubuntu "$issue_major"

# Check and install python3-pip
if ! python3 -c 'import setuptools' >& /dev/null; then
  apt-get -y install python3-pip
fi
# Back up the earlier version of cloud-init
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress Alibaba Cloud cloud-init
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install cloud-init
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh debian "$issue_major"

# Check and install python3-pip
if ! python3 -c 'import setuptools'>& /dev/null; then
  zypper -n install python3-pip
fi
# Back up the earlier version of cloud-init
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress Alibaba Cloud cloud-init
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install cloud-init
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh sles "$issue_major"

# Check and install python3-pip
if ! python3 -c 'import setuptools'>& /dev/null; then
  zypper -n install python3-pip
fi
# Back up the earlier version of cloud-init
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress Alibaba Cloud cloud-init
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install cloud-init
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh opensuse "$issue_major"

(Opcional) Paso 3: Configurar cloud-init

Qué hacer a continuación

• Para los servidores Linux que migrará a la nube, utilice Server Migration Center (SMC). Para obtener más información, consulte Migrate servers to ECS.

• En las instancias ECS que ejecutan imágenes personalizadas de Linux en Alibaba Cloud, reinicie el sistema para comprobar los resultados. Si el sistema configura automáticamente el nombre de host, la red y los ajustes de NTP, significa que cloud-init está instalado correctamente. Por ejemplo, ejecute los siguientes comandos para consultar el archivo de configuración de red:

  sudo reboot
  cat /etc/sysconfig/network-scripts/ifcfg-eth0

  El siguiente resultado indica que el sistema configuró automáticamente los ajustes de red mediante cloud-init, como el protocolo DHCP, el dispositivo de red y el tipo de dispositivo.

  BOOTPROTO=dhcp
  DEVICE=eth0
  ONBOOT=yes
  STARTMODE=auto
  TYPE=Ethernet
  USERCTL=no

Preguntas frecuentes

• ¿Qué debo hacer si faltan bibliotecas de dependencias al instalar cloud-init con Python 3?

  Cada imagen puede requerir bibliotecas distintas. Instale las bibliotecas faltantes mediante pip y vuelva a instalar cloud-init.

• ¿Qué debo hacer si cloud-init funciona de manera anómala y muestra un mensaje de error?

  Si el gestor de paquetes predeterminado del sistema (como yum) y el gestor pip instalaron versiones distintas de las bibliotecas de dependencias, pueden surgir conflictos de versiones que provoquen un funcionamiento anómalo de cloud-init. Se recomienda descargar las bibliotecas de dependencias necesarias según los mensajes de error.

  Mensaje de error	Causa	Comando de solución de problemas
  no setuptools module in python	Falta el módulo setuptools de Python	Tomando Python 3.6 como ejemplo: CentOS/Red Hat: yum -y install python3-pip Ubuntu/Debian: apt-get -y install python3-pip OpenSUSE/SUSE: zypper -n install python3-pip
  File "/home/testuser/cloud-init/cloudinit/log.py", line 19, in <module> import six ImportError: No module named six )	Falta la biblioteca de dependencias six	pip3 install six
  File "/home/testuser/cloud-init/cloudinit/url_helper.py", line 20, in <module> import oauthlib.oauth1 as oauth1 ImportError: No module named oauthlib.oauth1 )	Falta la biblioteca de dependencias oauthlib	pip3 install oauthlib
  El mensaje de error no especifica la biblioteca de dependencias faltante	El mensaje de error no tiene correspondencia	Con base en las bibliotecas listadas en el archivo requirements.txt de cloud-init, ejecute el siguiente comando para instalar todas las bibliotecas de dependencias: pip3 install -r requirements.txt

• ¿Qué debo hacer si una nueva versión de Python 3 instalada en la instancia provoca que cloud-init funcione de manera anómala?

  Si instala una nueva versión de Python 3 (como Python 3.9) en la instancia y la establece como versión predeterminada (es decir, crea un enlace simbólico para la nueva versión de Python 3, por ejemplo, ln -s /usr/bin/python3.9 /usr/bin/python3), el cloud-init instalado funcionará de manera anómala. Por ejemplo, al ejecutar cloud-init --version se mostrará el siguiente error:

  $cloud-init --version
  Traceback (most recent call last):
    File "/usr/local/bin/cloud-init", line 33, in <module>
      sys.exit(load_entry_point('cloud-init==19.1.9', 'console_scripts', 'cloud-init')())
    File "/usr/local/bin/cloud-init", line 22, in importlib_load_entry_point
      for entry_point in distribution(dist_name).entry_points
    File "/usr/lib64/python3.9/importlib/metadata.py", line 524, in distribution
      return Distribution.from_name(distribution_name)
    File "/usr/lib64/python3.9/importlib/metadata.py", line 187, in from_name
      raise PackageNotFoundError(name)
  importlib.metadata.PackageNotFoundError: cloud-init

  Utilice cualquiera de los siguientes métodos para resolver este problema:

  • Método 1: Reinstale cloud-init con la nueva versión de Python 3.

  • Método 2: Modifique el archivo ejecutable de cloud-init para cambiar la ruta del intérprete de Python a la versión anterior de Python 3. Tomando Python 3.6 como ejemplo, siga estos pasos para modificar el intérprete en el archivo ejecutable de cloud-init:

    1. Ejecute el siguiente comando para abrir el archivo de cloud-init.

       vim   /usr/local/bin/cloud-init

    2. Presione i para entrar al modo de edición y cambie el contenido después de #! al inicio del archivo por la ruta de Python 3.6.

       Después de la modificación, la línea #! quedará así:

       #!/usr/bin/python3.6

    3. Presione la tecla Esc para salir del modo de edición, introduzca :wq y luego presione Enter para guardar y salir del archivo.

• ¿Qué debo hacer si los datos de usuario especificados en los metadatos de la instancia durante su creación no se ejecutan o fallan tras instalar cloud-init?

  1. Ejecute el siguiente comando dentro de la instancia para comprobar si user-data existe en los metadatos de la instancia.

     curl http://100.100.100.200/latest/user-data

     Descripción del resultado de la comprobación:

     • Si user-data está configurado, se devuelve la información correspondiente. Continúe con el siguiente paso para solucionar el problema.

     • Si no se devuelve ninguna información, user-data no está configurado.

  2. Utilice los siguientes métodos para identificar por qué user-data no se ejecuta o falla.

     • Compruebe si el formato de user-data es correcto.

       cloud-init se encarga de ejecutar user-data. Asegúrese de que el formato de los datos sea correcto. Por ejemplo, la primera línea de user-data debe comenzar con #!. Para obtener más información, consulte Customize instance initialization configurations.

     • Consulte los resultados de ejecución de user-data en el archivo de registro de cloud-init /var/log/cloud-init.log y resuelva el problema con base en los mensajes de error.

       El siguiente ejemplo muestra la información registrada en el archivo de registro:

        util.py[DEBUG]: Running command ['/var/lib/cloud/instance/scripts/part-001'] with allowed return codes [0] (shell=False, capture=False)

     • Consulte la salida estándar y la salida de error estándar del proceso de ejecución de user-data.

       En systemd, la herramienta de inicialización del sistema Linux, cloud-final.service ejecuta user-data. Ejecute el siguiente comando para consultar la salida estándar y la salida de error estándar del proceso de ejecución de user-data, y resuelva el problema con base en dicha salida.

       journalctl -u cloud-final.service

     • Si ninguno de los métodos anteriores permite identificar por qué user-data no se ejecuta o falla, se recomienda copiar el contenido de user-data a un host local para depurarlo y comprobar si se ejecuta correctamente.

• ¿Qué debo hacer si las configuraciones de inicialización del sistema y los scripts de datos de usuario de la instancia no se ejecutan como se espera tras instalar cloud-init?

  1. Ejecute los siguientes comandos para comprobar si los cuatro servicios de cloud-init están configurados para iniciarse con el sistema.

     systemctl is-enabled cloud-init-local.service
     systemctl is-enabled cloud-init.service
     systemctl is-enabled cloud-config.service
     systemctl is-enabled cloud-final.service

     Si se devuelve un mensaje de error o disabled, cloud-init no está configurado para iniciarse con el sistema.

  2. Ejecute los siguientes comandos para configurar cloud-init de modo que se inicie con el sistema.

     systemctl enable cloud-init-local.service
     systemctl enable cloud-init.service
     systemctl enable cloud-config.service
     systemctl enable cloud-final.service

• ¿Qué debo hacer si la partición raíz no se expande automáticamente dentro de la instancia después de ampliar el disco del sistema durante la creación de la instancia?

  cloud-init admite la expansión automática de particiones en instancias Linux. Asegúrese de que la herramienta growpart esté instalada en el sistema y de que el archivo cloud.cfg esté configurado correctamente.

  1. Ejecute el siguiente comando para comprobar si la herramienta growpart está instalada en el sistema.

     which growpart

  2. (Requisito condicional) Si la herramienta no está instalada, ejecute los siguientes comandos para instalarla.

     • Familia RHEL:

       sudo yum -y install cloud-utils-growpart

     • Familia Debian:

       sudo apt -y install cloud-guest-utils

  3. Ejecute el siguiente comando para comprobar si el archivo /etc/cloud/cloud.cfg contiene el siguiente contenido.

     cat /etc/cloud/cloud.cfg

     Asegúrese de que la frecuencia de growpart y resizefs sea once-per-instance:

     # The modules that run in the 'init' stage
     cloud_init_modules:
      - migrator
      - source-address
      - pip-source
      - seed_random
      - bootcmd
      - write-files
      - [ growpart, once-per-instance ]
      - [ resizefs, once-per-instance ]
      - set_hostname
      - update_hostname
      - update_etc_hosts
      - rsyslog
      - users-groups
      - ssh

  4. (Requisito condicional) Si el contenido no existe, agréguelo al archivo /etc/cloud/cloud.cfg.

• ¿Qué debo hacer si el nuevo nombre de host no surte efecto después de actualizarlo en la consola y reiniciar una instancia ECS cuya versión de cloud-init es 0.7.6a16 o anterior?

  • Descripción del problema

    Después de actualizar el nombre de host en la consola de ECS y reiniciar la instancia ECS, el nuevo nombre de host no se aplica. Al ejecutar el comando cloud-init --version, se observa que la versión de cloud-init es 0.7.6a16 o anterior.

  • Causa

    Cuando cloud-init actualiza el nombre de host mediante el módulo update_hostname, ejecuta el comando hostname para obtener el nombre de host actual del sistema. Luego lee el archivo /var/lib/cloud/data/previous-hostname para obtener el nombre de host almacenado en la caché de datos de cloud-init y comprueba si ambos coinciden. Si coinciden, actualiza el nombre de host. Si no coinciden, cloud-init asume que el nombre de host se modificó manualmente y no lo actualiza.

    En los sistemas operativos de la familia Red Hat, se procesa el salto de línea del archivo /var/lib/cloud/data/previous-hostname al leerlo, pero no se procesa el salto de línea en la salida del comando hostname. Como resultado, ambos valores difieren y el nombre de host no se actualiza.

  • Solución

    Utilice cualquiera de las siguientes soluciones para resolver este problema:

    • Actualice la versión de cloud-init. Para obtener más información, consulte Step 2: Install cloud-init.

      • Si utiliza CentOS 6 o anterior, emplee cloud-init 0.7.6a18.

      • Si utiliza CentOS 7, emplee cloud-init 19.1.21.

      • Si utiliza CentOS 8 o posterior, se recomienda emplear cloud-init 23.2.2 o posterior.

    • Procese el salto de línea manualmente.

      Modifique manualmente el archivo defectuoso de cloud-init cloudinit/distros/rhel.py (obtenga la ruta del archivo ejecutando el comando find / -name rhel.py). Consulte distros/rhel.py: _read_hostname() missing strip on "hostname" para procesar el salto de línea en la salida del comando hostname. El siguiente ejemplo muestra cómo procesar el salto de línea:

      diff --git a/cloudinit/distros/rhel.py b/cloudinit/distros/rhel.py
      index 0b68414e..65176e99 100644
      --- a/cloudinit/distros/rhel.py
      +++ b/cloudinit/distros/rhel.py
      @@ -143,6 +143,7 @@ class Distro(distros.Distro):
                   return util.load_file(filename).strip()
               elif self.uses_systemd():
                   (out, _err) = util.subp(['hostname'])
      +            out = out.strip()
                   if len(out):
                       return out
                   else: