RHEL の cloud-init の設定と管理

• ホスト名、ネットワークインターフェイス、およびユーザーアカウントの設定
• インスタンスへのパッケージのインストール
• スクリプトの実行
• デフォルトの仮想マシン (VM) アクションの変更

• Red Hat アカウント が作成されている。

• KVM 用の qcow2 ゲストイメージ には、cloud-init がプリインストールされています。インスタンスを起動すると、cloud-init ユーティリティーが自動的に有効になります。Red Hat カスタマーポータルの KVM ゲストイメージは、Red Hat Virtualization、Red Hat OpenStack Platform (RHOSP)、および Red Hat OpenShift Virtualization で使用できます。
• Red Hat カスタマーポータルから Red Hat ISO イメージ をダウンロードしてカスタムゲストイメージを作成する場合は、そのカスタマイズされたゲストイメージに cloud-init パッケージをインストールしておく。

• Amazon Web Services (AWS)、Google Cloud、Microsoft Azure などの認定クラウドサービスプロバイダー (CCSP) のイメージを使用する場合は、RHEL Image Builder を使用してイメージを作成できます。RHEL Image Builder は、特定のクラウドプロバイダー向けにイメージをカスタマイズします。次の形式のイメージには、プリインストールされた cloud-init が付属しています。

  • Amazon Machine Image (AMI)
  • Virtual Hard Drive (VHD)
  • QEMU copy-on-write (QCOW2)

• meta-data ファイルには、インスタンスの詳細が含まれます。
• user-data ファイルには、ユーザーを作成し、アクセスを付与するための情報が含まれます。

検証

• cloud-init サービスのステータスをチェックして、ユーティリティーが定義されたタスクを完了したことを確認します。

  [cloud-user@citest-1 instance]$ cloud-init status
  status: done

  Copy to Clipboard Toggle word wrap

  cloud-init ユーティリティーは、実行時に /var/lib/cloud の下の cloud-init ディレクトリーレイアウトを作成し、指定したディレクティブに基づいて特定のディレクトリーコンテンツを更新または変更します。

• たとえば、データソースファイルをチェックして、データソースが NoCloud であることを確認できます。

  $ cd /var/lib/cloud/instance
  $ cat datasource
  
  DataSourceNoCloud: DataSourceNoCloud [seed=/dev/sr0][dsmode=net]

  Copy to Clipboard Toggle word wrap

• cloud-init は、user-data を /var/lib/cloud/instance/user-data.txt にコピーします。

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

  Copy to Clipboard Toggle word wrap

• bootcmd セクションは、初期化プロセスの早い段階で実行され、デフォルトでは起動ごとに実行されます。
• runcmd セクションは、プロセスの最後の方で実行され、初回起動時および初期化中にのみ実行されます。

前提条件

• データソースの要件に応じて、user-data ファイルを編集するか、次のディレクティブを cloud.cfg.d ディレクトリーに追加する。

  注記

  cloud-init が、ユーザーディレクティブを含むファイルを認識できるように、すべてのユーザーディレクティブはファイルの最上部に #cloud-config が含まれます。cloud.cfg.d ディレクトリーにディレクティブを含める場合は、ファイル名を *.cfg とし、ファイルの最上部に常に #cloud-config を含めます。

• users セクションでユーザーを作成して、記述します。users セクションを追加する場合は、そのセクションでデフォルトのユーザーオプションも設定する必要があります。セクションを変更して、初期システム設定にユーザーを追加したり、追加のユーザーオプションを設定したりすることもできます。
• users セクションに sudo および groups エントリーを追加して、ユーザーを sudoer として設定します。
• 自分だけが root ユーザーの権限を所有するようにユーザーデータを設定します。
• パスワードをリセットするには、最初のログイン時に cloud-user に cloud-user のパスワードを強制的に変更させます。
• ユーザーリストを作成して、root パスワードを設定します。

前提条件

• データソースの要件に応じて、user-data ファイルを編集するか、次のディレクティブを cloud.cfg.d ディレクトリーに追加する。

  注記

  cloud-init が、ユーザーディレクティブを含むファイルを認識できるように、すべてのユーザーディレクティブはファイルの最上部に #cloud-config が含まれます。cloud.cfg.d ディレクトリーにディレクティブを含める場合は、ファイル名を *.cfg とし、ファイルの最上部に常に #cloud-config を含めます。

手順

• ユーザーとユーザーオプションを追加 します。

  • デフォルトでは、selinux-user 値がない場合、ユーザーは unconfined_u とラベル付けされます。

    注記

    この例では、ユーザー user2 を users と wheel の 2 つのグループに配置します。

  • users セクションを追加または変更し、ユーザーを追加します。以下に例を示します。

    #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

    Copy to Clipboard Toggle word wrap
  • cloud-user を、指定する他のユーザーと共に作成したデフォルトユーザーにするには、セクションの最初のエントリーとして default を追加することを確認してください。これが最初のエントリーでない場合は、cloud-user は作成されません。

• sudo ユーザーをユーザーリストに追加 します。

  • sudo エントリーを追加し、ユーザーアクセスを指定します。たとえば、sudo: ALL=(ALL) NOPASSWD:ALL は、ユーザーに無制限のユーザーアクセスを許可します。

  • groups エントリーを追加し、ユーザーを含むグループを指定します。

    #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

    Copy to Clipboard Toggle word wrap

• ユーザーに排他的な root アクセスを設定 します。

  • name オプションを変更して、users セクションにユーザー root のエントリーを作成します。

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

    Copy to Clipboard Toggle word wrap

  • オプション: root ユーザーの SSH 鍵を設定します。

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

    Copy to Clipboard Toggle word wrap

• デフォルトの cloud-init ユーザー名を変更するには、次の手順に従います。

  • user: <username> の行を追加します。<username> は新しいデフォルトのユーザー名に置き換えます。

    #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

    Copy to Clipboard Toggle word wrap

• 新しいユーザーのパスワードをリセット します。

  • chpasswd: {expire: False} の行を 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

    Copy to Clipboard Toggle word wrap
    注記
    • これはパスワードを失効させます。なぜなら、password と chpasswd は特に指定がない限り、デフォルトのユーザーで動作するからです。
    • これはグローバル設定です。chpasswd を True に設定すると、作成するすべてのユーザーが、ログイン時にパスワードを変更する必要があります。

• root パスワードを設定 します。

  • chpasswd セクションにユーザーリストを作成します。

    注記

    空白は重要です。ユーザーリストのコロンの前後に空白を含めないでください。空白が含まれている場合、パスワードは空白を入れた設定となります。

    #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

    Copy to Clipboard Toggle word wrap
    注記

    この方法を使用してユーザーパスワードを設定する場合は、このセクションの すべてのパスワード を設定する必要があります。

前提条件

• データソースの要件に応じて、user-data ファイルを編集するか、次のディレクティブを cloud.cfg.d ディレクトリーに追加する。

  注記

  cloud-init が、ユーザーディレクティブを含むファイルを認識できるように、すべてのユーザーディレクティブはファイルの最上部に #cloud-config が含まれます。cloud.cfg.d ディレクトリーにディレクティブを含める場合は、ファイル名を *.cfg とし、ファイルの最上部に常に #cloud-config を含めます。

手順

• network-interfaces セクションを追加します。以下に例を示します。

  network:
    version: 1
    config:
      - type: physical
        name: eth0
        subnets:
          - type: static
            address: 192.0.2.1/24
            gateway: 192.0.2.254

  Copy to Clipboard Toggle word wrap

前提条件

• データソースの要件に応じて、user-data ファイルを編集するか、次のディレクティブを cloud.cfg.d ディレクトリーに追加する。

  注記

  cloud-init が、ユーザーディレクティブを含むファイルを認識できるように、すべてのユーザーディレクティブはファイルの最上部に #cloud-config が含まれます。cloud.cfg.d ディレクトリーにディレクティブを含める場合は、ファイル名を *.cfg とし、ファイルの最上部に常に #cloud-config を含めます。

手順

• container-storage-setup ユーティリティーへのパスを含めるように write_files モジュールを追加または変更します。

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

  Copy to Clipboard Toggle word wrap

  この例では、ルート論理ボリュームのサイズをデフォルトの 3 GB ではなく 6 GB に設定します。

• 文字列値を使用する場合、文字列全体がシェルスクリプトとして実行されます。
• bootcmd または runcmd のリスト値を使用する場合、各リスト項目は execve を使用して順番に実行されます。
• cloud-init を使用してシェルスクリプトを実行する場合は、cloud-init に .yaml ファイルを指定する代わりに、シェルスクリプト (シバン #! を追加すること) を指定できます。

前提条件

• データソースの要件に応じて、meta-data ファイルを編集します。次のディレクティブを cloud.cfg ファイルまたは cloud.cfg.d ディレクトリーに追加することもできます。

手順

• 場所を指定して locale ディレクティブを追加します。以下の例では、UTF-8 エンコーディングで locale を ja_JP (日本) に設定しています。

検証

• cloud-init によって更新された設定ファイルを確認するには、/var/log/cloud/cloud-init.log ファイルを調べます。更新されたファイルは、インスタンスの起動時に Writing to で始まるメッセージでログに記録されます。

  2019-09-03 00:16:07,XXX - util.py[DEBUG]: Writing to /root/.ssh/authorized_keys - wb: [XXX] 554 bytes
  2019-09-03 00:16:08,XXX - util.py[DEBUG]: Writing to /etc/ssh/sshd_config - wb: [XXX] 3905 bytes

  Copy to Clipboard Toggle word wrap

• 一般的な設定の問題は、cloud-init 設定ファイルを確認してください。

  1. /etc/cloud/cloud.cfg 設定ファイルを検証します。cloud_init_modules、cloud_config_modules、および cloud_final_modules に含まれるモジュールを確認します。
  2. /etc/cloud/cloud.cfg.d ディレクトリーで、ディレクティブ (*.cfg files) を確認します。

• root パーティションが自動的に拡張されなかった場合は、growpart ユーティリティーのログメッセージを確認します。

  注記

  growpart は LVM をサポートしません。root パーティションが LVM をベースとしている場合は、root パーティションは初回起動時に自動的に拡張されません。

  • 特定の問題の詳細は、/var/log/cloud-init.log ファイルおよび /var/log/cloud-init-output.log ファイルを確認してください。

• ファイルシステムが拡張されなかった場合は、ログメッセージで resizefs を確認します。

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

  Copy to Clipboard Toggle word wrap

• init モジュールのみで cloud-init を再実行します。

  # /usr/bin/cloud-init -d init

  Copy to Clipboard Toggle word wrap

• 設定内のすべてのモジュールで cloud-init を再実行します。

  # /usr/bin/cloud-init -d modules

  Copy to Clipboard Toggle word wrap

• cloud-init キャッシュを削除し、起動後に cloud-init を強制的に実行します。

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

  Copy to Clipboard Toggle word wrap

• ディレクトリーをクリーンアップし、クリーンなインスタンスをシミュレートします。

  # rm -rf /var/lib/cloud/instances/
  # rm -rf /var/lib/cloud/instance
  # rm -rf /var/lib/cloud/data/
  # reboot

  Copy to Clipboard Toggle word wrap

• cloud-init ユーティリティーを再実行します。

  # cloud-init init --local
  # cloud-init init

  Copy to Clipboard Toggle word wrap