:Initialize an instance using custom data

Formato

A primeira linha do script deve ser #!.

Exemplos de User-Data script

• Executar um script personalizado. Este exemplo grava a hora do sistema no arquivo userdata_test.txt na primeira inicialização da instância.

  #!/bin/sh
  echo "Hello World. The time is now $(date -R)!" | tee /root/userdata_test.txt

• Personalizar o repositório yum, a configuração do DNS e o serviço de sincronização de tempo

  O exemplo a seguir usa o CentOS Stream 9. Substitua as configurações pelas correspondentes ao seu sistema operacional.

  Importante

  O sistema configura automaticamente o repositório yum padrão, o serviço NTP e o serviço DNS quando a instância é iniciada. Você pode usar dados personalizados da instância para alterar essas configurações padrão. No entanto, observe o seguinte:

  • Ao personalizar o repositório yum, a Alibaba Cloud deixará de oferecer suporte a ele.

  • Ao personalizar o serviço NTP, a Alibaba Cloud deixará de oferecer suporte à sincronização de tempo.

  #!/bin/sh
  # Modify DNS
  echo "nameserver 114.114.114.114" | tee /etc/resolv.conf
  # Modify yum repo and update
  cp /etc/yum.repos.d/centos.repo /etc/yum.repos.d/centos.repo.bak
  cp /etc/yum.repos.d/centos-addons.repo /etc/yum.repos.d/centos-addons.repo.bak
  sed -i "s@http://mirrors.cloud.aliyuncs.com/centos-stream/@https://mirror.stream.centos.org/@g" /etc/yum.repos.d/centos.repo
  sed -i "s@http://mirrors.cloud.aliyuncs.com/centos-stream/@https://mirror.stream.centos.org/@g" /etc/yum.repos.d/centos-addons.repo
  yum update -y
  # Modify NTP Server
  echo "server ntp1.aliyun.com" | tee /etc/ntp.conf
  systemctl restart ntpd.service

  Nota

  Neste exemplo, 114.114.114.114 é o endereço do servidor DNS, https://mirror.stream.centos.org é o endereço do repositório yum do CentOS Stream e server ntp1.aliyun.com é o endereço do servidor NTP da Alibaba Cloud. Substitua-os pelos valores reais do seu ambiente.

  Também é possível usar Cloud-config data para alterar o repositório yum. No entanto, esse método é menos flexível e pode não funcionar em cenários em que a Alibaba Cloud já pré-configurou determinados repositórios yum. Recomendamos usar um User-Data script.

• Criar uma conta de administrador personalizada

  Por padrão, as instâncias do RDS Custom utilizam o usuário root como administrador. Com dados personalizados, você pode criar um usuário administrativo adicional.

  #!/bin/sh
  useradd test-user
  echo "test-user   ALL=(ALL)        NOPASSWD:ALL" | tee -a /etc/sudoers
  mkdir /home/test-user/.ssh
  touch /home/test-user/.ssh/authorized_keys
  echo "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCRnnUveAis****" | tee -a /home/test-user/.ssh/authorized_keys

  Nota

  Substitua a chave pública de exemplo ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCRnnUveAis pela sua chave pública.

Formato

• A primeira linha deve ser #cloud-config, sem espaços no início.

• O conteúdo deve usar sintaxe YAML válida.

Exemplos de Cloud-config data

• Personalizar o repositório de software

  Para configurar um repositório de software personalizado, insira o conteúdo a seguir na área Custom Data. Este exemplo é para uma imagem Ubuntu. Ao usar uma imagem diferente, substitua o conteúdo pela configuração de módulo adequada.

  #cloud-config
  apt:
    preserve_sources_list: false
    disable_suites:
      - $RELEASE-updates
      - backports
      - $RELEASE
      - mysuite
    primary:
      - arches:
          - amd64
          - i386
          - default
        uri: http://us.archive.ubuntu.com/ubuntu

• Instalar o serviço nginx automaticamente

  Insira o conteúdo a seguir na área Custom Data para instalar o serviço nginx automaticamente.

  #cloud-config
  packages: 
   - nginx 
  runcmd: 
   - systemctl start nginx.service

• Configurar um hostname personalizado

  Insira o conteúdo a seguir na área Custom Data para definir um hostname personalizado.

  #cloud-config
  hostname: my-instance
  fqdn: my-instance.localdomain

• Executar um script personalizado automaticamente

  Insira o conteúdo a seguir na área Custom Data para executar um script shell automaticamente toda vez que a instância for iniciada.

  #cloud-config
  bootcmd:
  - echo "Hello World. The time is now $(date -R)!" | tee /root/userdata_test.txt

Formato

A primeira linha deve ser #include, sem espaços no início.

Exemplo de include file. Este exemplo apresenta uma URL que aponta para um script armazenado em um bucket do Object Storage Service (OSS) na região China (Hangzhou).

#include
https://ecs-image-test.oss-cn-hangzhou.aliyuncs.com/userdata/myscript.sh

Formato

A primeira linha deve ser #include, sem espaços no início.

Exemplo de Gzip compressed content. Este exemplo apresenta uma URL que aponta para um arquivo compactado em Gzip armazenado em um bucket do Object Storage Service (OSS) na região China (Hangzhou).

#include
https://rc-image-test.oss-cn-hangzhou.aliyuncs.com/userdata/myscript.gz

Formato

• A primeira linha deve ser Content-Type: multipart/mixed; boundary="****", sem espaços no início. O boundary pode ser personalizado.

• A segunda linha, MIME-Version: 1.0, especifica a versão. Esse campo geralmente é obrigatório em todas as mensagens MIME.

Exemplo de MIME multi-part file

Content-Type: multipart/mixed; boundary="//"
MIME-Version: 1.0
--//
Content-Type: text/cloud-config; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="cloud-config.txt"
#cloud-config
runcmd:
- [ mkdir, /test-cloudinit ]
write_files:
- path: /test-cloudinit/cloud-init.txt
  content: |
    Created by cloud-init
  append: true
--//
Content-Type: text/x-shellscript; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment; filename="userdata.txt"
#!/bin/bash
mkdir test-userscript
touch /test-userscript/userscript.txt
echo "Created by bash shell script" >> /test-userscript/userscript.txt
--//--

Este exemplo de MIME multi-part file contém diretivas do cloud-init e um script Bash shell:

• As diretivas do cloud-init criam um arquivo (/test-cloudinit/cloud-init.txt) e gravam Created by cloud-init nele.

• O script Bash shell cria um arquivo (/test-userscript/userscript.txt) e grava Created by bash shell script nele.