使用自定义数据进行实例初始化

格式

首行均以#!开头。

User-Data脚本示例

• 运行自定义脚本（在实例首次启动时，向userdata_test.txt文件写入系统时间）

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

• 自定义实例软件源、DNS解析配置及时间同步服务

  以下示例以CentOS Stream 9为例，实际使用中请根据您的操作系统进行相应配置替换。

  重要

  系统会在实例启动时自动配置默认的yum源、NTP服务和DNS服务，您可以使用实例自定义数据更改默认的yum源、NTP服务和DNS服务，但请注意：

  • 如果您自定义了yum源，阿里云官方不再提供yum源相关支持。

  • 如果您自定义了NTP服务，阿里云官方不再提供相关时间同步服务。

  #!/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

  说明

  其中114.114.114.114为DNS服务器地址、https://mirror.stream.centos.org为CentOS Stream的yum仓库地址、server ntp1.aliyun.com为阿里云的NTP服务器地址，请您根据实际环境替换。

  您也可以使用Cloud Config数据更改yum源，但是不够灵活，不能适配阿里云已对部分yum源进行预配置的情况，建议使用User-Data脚本。

• 自定义管理员账号

  RDS Custom实例默认使用root用户作为管理员，您可通过实例自定义数据创建并配置其他用户作为管理员。

  #!/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

  说明

  请使用您的公钥替换示例中的公钥ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCRnnUveAis****。

格式

• 首行为#cloud-config，且起始位置不能有空格。

• 必须遵循YAML语法编写内容。

Cloud Config数据示例

• 自定义实例软件源

  在自定义数据区域输入以下内容，以配置自定义实例软件源。示例中使用Ubuntu镜像创建实例，如果您使用其他镜像，请替换为对应模块的配置内容。

  #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

• 配置自动安装nginx服务

  在自定义数据区域输入如下内容，以配置实例自动安装nginx服务。

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

• 配置自定义主机名

  在自定义数据区域输入如下内容，以自定义设置主机名。

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

• 配置自动运行自定义脚本

  在自定义数据区域输入如下内容，以配置实例每次启动时自动运行Shell脚本。

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

格式

• 首行为Content-Type：multipart/mixed：boundary="****"，boundary可自定义，且起始位置不能有空格。

• 第二行指定版本MIME-Version：1.0，该字段通常在每个MIME消息中是必需的。

MIME multi-part文件示例

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
--//--

示例MIME multi-part文件包含cloud-init指令和一个Bash Shell脚本：

• cloud-init指令创建一个文件（/test-cloudinit/cloud-init.txt），并写入Created by cloud-init。

• Bash Shell脚本创建一个文件（/test-userscript/userscript.txt），并写入Created by bash shell script 。