1. A etapa do gerador cloud-init, através do serviço systemd, determina se deve executar cloud-init no momento da inicialização.
2. Durante a etapa local, cloud-init encontra fontes de dados locais e aplica a configuração da rede.
3. Durante a etapa da rede, cloud-init processa os dados do usuário e executa os módulos listados em cloud_init_modules em seu arquivo cloud.cfg. Você pode ativar, desativar ou adicionar módulos à seção cloud_init_modules.
4. Durante a etapa de configuração, cloud-init executa os módulos listados em cloud_config_modules em seu arquivo cloud.cfg. Você pode ativar, desativar ou adicionar módulos à seção cloud_config_modules.
5. Durante a etapa final, cloud-init pode executar o que você incluiu em cloud_final_modules em seu arquivo cloud.cfg. Você pode incluir instalações de pacotes que você normalmente executaria após a inicialização de um sistema e também pode incluir plug-ins de gerenciamento de configuração e scripts do usuário. Você pode ativar, desativar ou adicionar módulos à seção cloud_final_modules.

Procedimento

1. Crie um diretório com o nome cloudinitiso e vá para ele.

   $ mkdir cloudinitiso
   $ cd cloudinitiso

2. Crie um arquivo chamado meta-data. Adicione as seguintes informações ao arquivo.

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

3. Crie um arquivo chamado user-data. Inclua as seguintes informações no arquivo.

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

   Nota

   A linha final do arquivo user-data faz referência a uma chave pública SSH. Encontre suas chaves públicas SSH em ~/.ssh/id_rsa.pub. Ao tentar este procedimento de amostra, modifique a linha para incluir uma de suas chaves públicas.

4. Use o comando genisoimage para criar uma imagem ISO que inclua user-data e 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. Baixe uma imagem do KVM Guest Image do Portal do Cliente da Red Hat para o diretório /var/lib/libvirt/images.

6. Criar uma nova VM da KVM Guest Image usando o comando virt-install. Inclua a imagem ISO que você criou como anexo à imagem.

   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. Acesse sua imagem como cloud-user. Sua senha é cilogon.

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

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Mude a linha chpasswd: {expire: False} para 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

   Isto funciona para expirar a senha porque password e chpasswd operam no usuário padrão, a menos que você indique o contrário.

   Nota

   Este é um cenário global. Quando você define chpasswd para True, todos os usuários que você cria precisam mudar suas senhas quando fazem o login.

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Adicione a linha user: <username>, substituindo <username> pelo novo nome de usuário padrão.

   #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

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Crie uma lista de usuários na seção chpasswd do arquivo. O formato é mostrado no exemplo a seguir.

   Nota

   O espaço branco é significativo. Não inclua o espaço branco antes ou depois dos dois pontos em sua lista de usuários. Se você incluir espaço em branco, a senha é definida com um espaço dentro.

   #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

   Se você usar este método para definir a senha do usuário, você deve definir all passwords nesta seção.

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Adicionar ou modificar a seção users para adicionar usuários.

   • Se você quiser que cloud-user seja o usuário padrão criado junto com os outros usuários especificados, certifique-se de adicionar default como a primeira entrada na seção. Se não for a primeira entrada, cloud-user não será criado.

   • Por padrão, os usuários são rotulados como unconfined_u se não houver um 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

     • O exemplo coloca o usuário user2 em dois grupos, users e wheel.
     • A partir de cloud-init 0.7.5, a lista de grupos não suporta o espaço branco. Consulte a BZ 1126365 para mais informações.

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Adicione as seções para bootcmd e runcmd; inclua comandos que você deseja que cloud-init execute.

   #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

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Adicione uma entrada em sudo e especifique o acesso do usuário. Por exemplo, sudo: ALL=(ALL) NOPASSWD:ALL permite o acesso irrestrito de um usuário.

3. Adicione uma entrada em groups e especifique os grupos que incluem o usuário.

   #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. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Adicione uma seção 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

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Criar uma entrada para o usuário root na seção users.

   O exemplo simples que se segue inclui uma seção users com apenas a opção name.

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

3. Opcionalmente, configure chaves SSH para o usuário root.

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

Procedimento

1. Dependendo das exigências de sua fonte de dados, abra seu arquivo de dados do usuário para edição, ou adicione a seguinte diretiva ao diretório cloud.cfg.d.

   Nota

   Todas as diretrizes de usuário incluem #cloud-config no topo do arquivo para que cloud-init reconheça o arquivo como contendo as diretrizes de usuário. Quando você incluir diretivas no diretório cloud.cfg.d, nomeie o arquivo *.cfg, e inclua sempre #cloud-config no topo do arquivo.

2. Adicionar ou modificar o módulo write_files para incluir o caminho para o utilitário container-storage-setup.

   O exemplo a seguir define o tamanho do volume lógico raiz para 6GB, em vez dos 3GB padrão.

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

   Nota

   Antes da RHEL 7.4, container-storage-setup foi chamado docker-storage-setup. Se você estiver usando OverlayFS para armazenamento, a partir da RHEL 7.4 você pode agora usar esse tipo de sistema de arquivo com SELinux em modo de aplicação.

Procedimento

1. Dependendo dos requisitos de sua fonte de dados, abra seu arquivo de meta-dados para edição, ou adicione a seguinte diretiva ao arquivo cloud.cfg ou ao diretório cloud.cfg.d.
2. Adicionar a diretiva locale, especificando a localização. A seguinte amostra estabelece o locale para ja_JP (Japão) com a codificação UTF-8.

Procedimento

1. Abra o arquivo /etc/cloud/cloud.cfg para edição.

2. Comente ou remova a configuração que você não deseja que cloud-init atualize ao restaurar sua instância.

   Por exemplo, para evitar a atualização do arquivo chave SSH, remova -ssh da seção 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

Procedimento

1. Faça o login em seu VM.
2. Adicionar ou alterar diretivas, por exemplo, modificar o arquivo cloud.cfg no diretório /etc/cloud ou adicionar diretivas ao diretório /etc/cloud/cloud.cfg.d.

3. Execute o comando cloud-init clean para limpar os diretórios de forma que cloud-init possa ser executado novamente. Você também pode executar os seguintes comandos como root para limpar o VM.

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

   Nota

   Você pode salvar a imagem limpa como uma nova imagem e usar essa imagem para várias VMs. As novas VMs rodam cloud-init usando sua configuração atualizada cloud-init.

4. Repetição cloud-init ou reinicialização da VM.

   cloud-init, implementando as mudanças de configuração que você fez.

Procedimento

1. Criar e lançar uma instância para a Plataforma OpenStack. Consulte Instâncias de Máquina Virtual para obter informações sobre como criar instâncias para o OpenStack. Neste exemplo, nossa máquina virtual inclui cloud-init, que funciona na inicialização da máquina virtual.
2. Adicionar ou alterar diretrizes. Por exemplo, modificar o arquivo user-data.file que está armazenado no servidor HTTP OpenStack.

3. Limpar a máquina virtual. Execute os seguintes comandos como raiz.

   `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

   Você pode salvar a imagem limpa como uma nova imagem e usar essa imagem para várias máquinas virtuais. As novas máquinas virtuais rodam cloud-init usando sua configuração atualizada cloud-init.

4. Re-executar cloud-init ou reiniciar a máquina virtual.

   A nuvem volta a funcionar, implementando as mudanças de configuração que você fez.

Procedimento

1. Reveja os arquivos de configuração do cloud-init.

   1. Examine o arquivo de configuração /etc/cloud/cloud.cfg. Verifique quais módulos estão incluídos em cloud_init_modules, cloud_config_modules, e cloud_final_modules.
   2. Verifique as diretrizes (arquivos*.cfg ) no diretório /etc/cloud/cloud.cfg.d.

2. Consulte os arquivos /var/log/cloud-init.log e /var/log/cloud-init-output.log para obter detalhes sobre uma questão específica. Por exemplo, se o problema foi que a partição raiz não foi automaticamente estendida, verifique as mensagens de registro para growpart. Se o sistema de arquivo não foi estendido, verifique as mensagens de log para resizefs. Segue um exemplo de comando grep para resizefs.

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

   Nota

   growpart não suporta LVM. Se sua partição raiz for baseada em LVM, a partição raiz não é automaticamente estendida na primeira inicialização.

3. Rerun cloud-init. A seguir, exemplos de cenários. Executar comandos como raiz.

   • Repetição cloud-init apenas com os módulos init.

     /usr/bin/cloud-init -d init

   • Reexecutar cloud-init com todos os módulos em sua configuração.

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

   • Eliminar o cache cloud-init e forçar cloud-init a funcionar após a inicialização.

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

   • Execute os seguintes comandos para limpar diretórios e simular uma instância limpa.

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

   • Execute os seguintes comandos para reexecutar cloud-init.

     cloud-init init --local
     cloud-init init