Elastic Compute Service:Instalar cloud-init

Consulte a documentação oficial do cloud-init.

Casos de uso

Etapa 1: Verificar a versão do cloud-init

1. Faça login no servidor de origem.

2. Verifique se o cloud-init está instalado.

   Série CentOS

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

   Série Ubuntu

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

   • Se nenhum resultado for retornado ou a versão for anterior à 0.7.9, consulte a Etapa 2: Instalar cloud-init.

     Importante

     A versão 0.7.9 é uma versão antiga da comunidade, inadequada para inicialização de ECS. Atualize para uma versão mais recente.

   • Se a versão for 18 ou superior, nenhuma instalação é necessária. Para personalizar a configuração de rede padrão, consulte Desativar a inicialização automática de rede pela Alibaba Cloud.

   • Se a versão for 19.1.21, atualize para o cloud-init da Alibaba Cloud 23.2.2. Principais melhorias em relação à 19.1.21:

     • Suporte a acesso a metadados no modo de reforço de segurança. Consulte Metadados da instância.

     • Outras alterações incluem aprimoramentos de recursos, melhorias de desempenho e correções de bugs. Consulte o arquivo ChangeLog.

   • Outras versões: nenhuma instalação necessária. Consulte os Próximos passos.

3. Para evitar perda de dados, faça backup dos dados do servidor de origem antes da instalação. Por exemplo, crie um snapshot.

Etapa 2: Instalar cloud-init

• (Recomendado) Alibaba Cloud cloud-init 23.2.2: Requer Python 3.6 ou superior. Fonte de dados: Aliyun.

• Alibaba Cloud cloud-init 19.1.21: Requer Python 3.6 ou superior. Fonte de dados: Aliyun.

• Alibaba Cloud cloud-init 0.7.6a18: Esta versão é necessária para alguns sistemas operacionais mais antigos, como CentOS 6, Debian 9 e SUSE Linux Enterprise Server 12. Ela requer Python 2.7 e utiliza a fonte de dados Aliyun.

  Importante

  A comunidade Python não oferece mais suporte ao Python 2.7. Utilize uma versão mais recente do cloud-init para evitar possíveis problemas com bibliotecas de dependência.

• Versão comunitária do cloud-init: Mantida pela comunidade cloud-init. A versão mais recente da Alibaba Cloud é a 23.2.2. Para uma versão posterior, instale a versão comunitária a partir do site oficial do cloud-init.

A versão da Alibaba Cloud é otimizada para os serviços da Alibaba Cloud. Use a versão da Alibaba Cloud, a menos que você precise de uma versão comunitária mais recente.

# Check and install python3-pip.
if ! python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Back up the old version of cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init package.
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 old version of cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init package.
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 old version of cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init package.
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 old version of cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init package.
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 old version of cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init package.
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 old version of cloud-init.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init package.
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) Etapa 3: Configurar cloud-init

Próximos passos

• Para migrar servidores Linux para a nuvem, utilize o Server Migration Center (SMC). Consulte Migrar servidores para instâncias ECS.

• Para instâncias ECS executando uma imagem personalizada Linux na Alibaba Cloud, reinicie o sistema para verificar a instalação. Se o hostname, a rede e o NTP forem configurados automaticamente, o cloud-init foi instalado com sucesso. Visualize o arquivo de configuração de rede:

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

  A saída a seguir indica que o cloud-init configurou definições de rede, como protocolo DHCP, dispositivo de rede e tipo de dispositivo.

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

Perguntas frequentes

• O que devo fazer se houver bibliotecas de dependência ausentes ao instalar o cloud-init usando Python 3?

  As bibliotecas ausentes variam conforme a imagem. Instale-as usando pip e, em seguida, instale o cloud-init novamente.

• O que devo fazer se o cloud-init apresentar execução anormal e retornar uma mensagem de erro?

  Se o gerenciador de pacotes padrão (como yum) e o pip instalaram versões diferentes da mesma biblioteca de dependência, conflitos de versão podem causar execução anormal do cloud-init. Baixe as bibliotecas de dependência necessárias com base na mensagem de erro.

  Mensagem de erro	Causa	Comando de solução de problemas
  no setuptools module in python	O módulo python setuptools está ausente.	Para Python 3.6: 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 )	A biblioteca de dependência six está ausente.	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 )	A biblioteca de dependência oauthlib está ausente.	pip3 install oauthlib
  A mensagem de erro não especifica uma biblioteca de dependência ausente.	A mensagem de erro relacionada não está mapeada.	Com base nas bibliotecas listadas no arquivo requirements.txt, instale todas as bibliotecas de dependência: pip3 install -r requirements.txt

• O que devo fazer se o cloud-init funcionar anormalmente após a instalação de uma nova versão do Python 3 na instância?

  Se você instalar uma nova versão do Python 3, como Python 3.9, e defini-la como versão padrão criando um link simbólico (por exemplo, ln -s /usr/bin/python3.9 /usr/bin/python3), o cloud-init instalado poderá apresentar funcionamento anormal. Por exemplo, executar cloud-init --version retorna um erro:

  $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

  Utilize um dos métodos a seguir para resolver esse problema:

  • Método 1: Reinstale o cloud-init usando a nova versão do Python 3.

  • Método 2: Modifique o arquivo executável do cloud-init para alterar o caminho do interpretador Python para a versão anterior do Python 3. O exemplo a seguir altera o interpretador para Python 3.6:

    1. Abra o arquivo cloud-init.

       vim   /usr/local/bin/cloud-init

    2. Pressione i para entrar no modo de edição. No início do arquivo, altere o conteúdo após #! para o caminho do Python 3.6.

       Após a modificação, a linha iniciada com #! ficará assim:

       #!/usr/bin/python3.6

    3. Pressione a tecla Esc para sair do modo de edição. Insira :wq e pressione Enter para salvar e fechar o arquivo.

• Após instalar o cloud-init, por que os dados do usuário da instância definidos durante a criação da instância falham ao executar?

  1. Verifique se existem dados do usuário nos metadados da instância.

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

     Resultado:

     • Se dados do usuário forem retornados, prossiga para a próxima etapa de solução de problemas.

     • Se nenhum dado for retornado, os dados do usuário não foram definidos.

  2. Use um dos métodos a seguir para identificar a causa.

     • Verifique se o formato dos dados do usuário está correto.

       Os dados do usuário são executados pelo cloud-init e devem estar no formato correto. Por exemplo, a primeira linha deve começar com #!. Consulte Personalizar configurações de inicialização da instância.

     • Verifique o arquivo de log /var/log/cloud-init.log em busca de erros e solucione o problema com base na mensagem de erro.

       Exemplo de entrada de log:

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

     • Visualize a saída padrão e a saída de erro padrão da execução dos dados do usuário.

       No systemd, os dados do usuário são executados através do cloud-final.service. Visualize sua saída padrão e saída de erro para solucionar problemas:

       journalctl -u cloud-final.service

     • Se os métodos anteriores não identificarem o problema, copie os dados do usuário para um host local para depuração.

• Após instalar o cloud-init, por que as configurações de inicialização do sistema e o script de dados do usuário da instância não são executados conforme esperado?

  1. Verifique se os quatro serviços do cloud-init estão habilitados na inicialização.

     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

     Se for retornado um erro ou disabled, o cloud-init não está habilitado na inicialização.

  2. Habilite o cloud-init na inicialização.

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

• Redimensionei o disco do sistema ao criar uma instância, mas a partição raiz não foi redimensionada automaticamente. O que devo fazer?

  O redimensionamento automático de partições para instâncias Linux requer o cloud-init. Certifique-se de que o growpart esteja instalado e que o arquivo cloud.cfg esteja configurado corretamente.

  1. Verifique se o growpart está instalado.

     which growpart

  2. (Obrigatório, se aplicável) Se não estiver instalado, instale-o.

     • Para a série RHEL:

       sudo yum -y install cloud-utils-growpart

     • Para a série Debian:

       sudo apt -y install cloud-guest-utils

  3. Verifique se o arquivo /etc/cloud/cloud.cfg contém o conteúdo mostrado abaixo.

     cat /etc/cloud/cloud.cfg

     

  4. (Obrigatório, se aplicável) Se o conteúdo estiver ausente, adicione-o ao arquivo /etc/cloud/cloud.cfg.

• Para uma instância ECS com cloud-init 0.7.6a16 ou anterior, o hostname não é atualizado após eu alterá-lo no console e reiniciar a instância. O que devo fazer?

  • Descrição do problema

    Após atualizar o hostname no console ECS e reiniciar a instância, o novo hostname não entra em vigor. O comando cloud-init --version mostra a versão 0.7.6a16 ou anterior.

  • Causa

    Quando o cloud-init usa o módulo update_hostname para atualizar o hostname, ele executa o comando hostname para obter o hostname atual do sistema e lê /var/lib/cloud/data/previous-hostname para obter o hostname em cache. Ele compara os dois: se coincidirem, atualiza o hostname; se diferirem, assume que o hostname foi alterado manualmente e ignora a atualização.

    Em sistemas operacionais baseados em Red Hat, o conteúdo lido de /var/lib/cloud/data/previous-hostname contém uma quebra de linha, mas a saída do comando hostname não. Essa incompatibilidade impede que o hostname seja atualizado.

  • Solução

    Utilize uma das soluções a seguir:

    • Atualize a versão do cloud-init. Consulte a Etapa 2: Instalar cloud-init.

      • Para CentOS 6 e anteriores, use cloud-init 0.7.6a18.

      • Para CentOS 7, use cloud-init 19.1.21.

      • Para CentOS 8 ou superior, use cloud-init 23.2.2 ou uma versão posterior.

    • Trate a quebra de linha manualmente.

      Corrija manualmente o arquivo defeituoso cloudinit/distros/rhel.py no cloud-init (use find / -name rhel.py para localizar o arquivo). Consulte distros/rhel.py: _read_hostname() missing strip on "hostname" para processar a quebra de linha na saída do comando hostname:

      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: