:カスタムデータを使用したインスタンスの初期化

形式

スクリプトの最初の行は #! である必要があります。

ユーザーデータスクリプトの例

• カスタムスクリプトの実行。この例では、インスタンスの初回起動時にシステム時刻を userdata_test.txt ファイルに書き込みます。

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

• yum リポジトリ、DNS 設定、および時刻同期サービスのカスタマイズ

  次の例では CentOS Stream 9 を使用します。ご使用のオペレーティングシステムに合わせて設定を置き換えてください。

  重要

  インスタンスの起動時に、システムはデフォルトの yum リポジトリ、NTP サービス、DNS サービスを自動的に設定します。インスタンスのカスタムデータを使用してこれらのデフォルト設定を変更できます。ただし、次の点にご注意ください。

  • yum リポジトリをカスタマイズした場合、Alibaba Cloud は yum リポジトリのサポートを提供しなくなります。

  • NTP サービスをカスタマイズした場合、Alibaba Cloud は時刻同期のサポートを提供しなくなります。

  #!/bin/sh
  # DNS の変更
  echo "nameserver 114.114.114.114" | tee /etc/resolv.conf
  # yum リポジトリの変更と更新
  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
  # NTP サーバーの変更
  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 は Alibaba Cloud NTP サーバーアドレスです。ご使用の環境の実際の値に置き換えてください。

  Cloud-config データを使用して yum リポジトリを変更することもできます。ただし、この方法は柔軟性に欠け、Alibaba Cloud が特定の yum リポジトリを事前設定しているシナリオでは機能しない場合があります。代わりにユーザーデータスクリプトを使用することを推奨します。

• カスタム管理者アカウントの作成

  デフォルトでは、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

• カスタムスクリプトの自動実行

  インスタンスが起動するたびにシェルスクリプトを自動的に実行するには、カスタムデータ エリアに次の内容を入力します。

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

形式

• 最初の行は、先頭にスペースを入れずに Content-Type: multipart/mixed; boundary="****" にする必要があります。バウンダリはカスタマイズ可能です。

• 2 行目の MIME-Version: 1.0 はバージョンを指定します。このフィールドは通常、すべての MIME メッセージで必須です。

MIME マルチパートファイルの例

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 マルチパートファイルの例には、cloud-init ディレクティブと Bash シェルスクリプトが含まれています。

• cloud-init ディレクティブはファイル (/test-cloudinit/cloud-init.txt) を作成し、そこに Created by cloud-init と書き込みます。

• Bash シェルスクリプトはファイル (/test-userscript/userscript.txt) を作成し、そこに Created by bash shell script と書き込みます。