1. cloud-init ジェネレーターステージでは、systemd サービスを介して、起動時に cloud-init を実行するかどうかを判断します。
2. ローカルステージでは、cloud-init はローカルデータソースを検索し、ネットワーク設定を適用します。
3. ネットワークステージでは、cloud-init はユーザーデータを処理し、cloud.cfg ファイルの cloud_init_modules の下に一覧表示されるモジュールを実行します。cloud_init_modules セクションにモジュールを有効化、無効化、または追加できます。
4. config ステージでは、cloud-init は cloud.cfg ファイルの cloud_config_modules の下に一覧表示されるモジュールを実行します。cloud_config_modules セクションにモジュールを有効化、無効化、または追加できます。
5. 最終ステージでは、cloud-init は cloud.cfg ファイルの cloud_final_modules に追加したものを実行できます。システムの起動後に通常実行するパッケージインストールを追加できます。また、設定管理プラグインおよびユーザースクリプトを追加することもできます。cloud_final_modules セクションにモジュールを有効化、無効化、または追加できます。

手順

1. cloudinitiso という名前のディレクトリーを作成し、これに移動します。

   $ mkdir cloudinitiso
   $ cd cloudinitiso

2. meta-data という名前のファイルを作成します。以下の情報をファイルに追加します。

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

3. user-data という名前のファイルを作成します。ファイルに以下の情報を追加します。

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

   注記

   user-data ファイルの最後の行は、SSH 公開鍵を参照します。~/.ssh/id_rsa.pub で SSH 公開鍵を検索します。このサンプル手順を行う場合は、行を変更して公開鍵の 1 つを含めます。

4. genisoimage コマンドを使用して、user-data および meta-data を含む ISO イメージを作成します。

   # 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. Red Hat カスタマーポータルから、/var/lib/libvirt/images ディレクトリーに KVM ゲストイメージをダウンロードします。

6. virt-install コマンドを使用して、KVM ゲストイメージから新しい仮想マシンを作成します。イメージへの添付として、作成した ISO イメージを含めます。

   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. cloud-user としてイメージにログインします。パスワードは cilogon です。

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

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. 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

   これはパスワードを失効させます。なぜなら、password と chpasswd は特に指定がない限り、デフォルトのユーザーで動作するからです。

   注記

   これはグローバル設定です。chpasswd を True に設定すると、作成するすべてのユーザーが、ログイン時にパスワードを変更する必要があります。

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. 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

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. ファイルの 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

   注記

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

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. users セクションを追加または変更し、ユーザーを追加します。

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

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

     #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

     注記

     • この例では、ユーザー user2 を 2 つのグループ (users と wheel) に配置します。
     • cloud-init 0.7.5 の時点では、グループの一覧は空白をサポートしません。詳細は、BZ 1126365 を参照してください。

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. bootcmd および runcmd のセクションを追加します。cloud-init が実行するコマンドを含めます。

   #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

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

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

3. 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

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. 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

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. users セクションに、ユーザー root のエントリーを作成します。

   以下の簡単な例には、name オプションのみを持つ users セクションが含まれます。

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

3. オプションで、root ユーザーの SSH 鍵を設定します。

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

手順

1. データソースの要件に応じて、user-data ファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg.d ディレクトリーに追加します。

   注記

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

2. write_files モジュールを追加または変更して、container-storage-setup ユーティリティーへのパスを追加します。

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

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

   注記

   RHEL 7.4 より前のバージョンでは、container-storage-setup は docker-storage-setup と呼ばれていました。RHEL 7.4 の時点で、ストレージに OverlayFS を使用している場合は、SELinux でのこのタイプのファイルシステムを Enforcing モードで使用できるようになりました。

手順

1. データソースの要件に応じて、メタデータファイルを開いて編集します。編集しない場合は、以下のディレクティブを cloud.cfg ファイルまたは cloud.cfg.d ディレクトリーに追加します。
2. 場所を指定して locale ディレクティブを追加します。以下の例では、UTF-8 エンコーディングで locale を ja_JP (日本) に設定しています。

手順

1. /etc/cloud/cloud.cfg ファイルを開いて編集します。

2. インスタンスの復元時に、cloud-init が更新しない設定をコメントアウトまたは削除します。

   たとえば、SSH 鍵ファイルの更新を回避するには、cloud_init_modules セクションから -ssh を削除します。

   cloud_init_modules:
    - disk_setup
    - migrator
    - bootcmd
    - write-files
    - growpart
    - resizefs
    - set_hostname
    - update_hostname
    - update_etc_hosts
    - rsyslog
    - users-groups
    # - ssh

手順

1. 仮想マシンにログインします。
2. ディレクティブを追加または変更します。たとえば、/etc/cloud ディレクトリーの cloud.cfg ファイルを変更するか、ディレクティブを /etc/cloud/cloud.cfg.d ディレクトリーに追加します。

3. cloud-init clean コマンドを実行してディレクトリーをクリーンアップし、cloud-init が再実行できるようにします。root で以下のコマンドを実行して、仮想マシンをクリーンアップすることもできます。

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

   注記

   クリーニングしたイメージを新しいイメージとして保存し、そのイメージを複数の仮想マシンに使用できます。新しい仮想マシンは、更新された cloud-init 設定を使用して、cloud-init を実行します。

4. cloud-init を再実行するか、仮想マシンを再起動します。

   cloud-init が再実行し、変更した設定を実装します。

手順

1. OpenStack Platform のインスタンスを作成して起動します。OpenStack のインスタンス作成に関する詳細は、「仮想マシンインスタンス」 を参照してください。この例では、仮想マシンには cloud-init が含まれており、これは仮想マシンの起動時に実行されます。
2. ディレクティブを追加または変更します。たとえば、OpenStack HTTP サーバー上に保管されている user-data.file ファイルを変更します。

3. 仮想マシンをクリーンアップします。以下のコマンドを root 権限で実行します。

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

   注記

   クリーニングしたイメージを新しいイメージとして保存し、そのイメージを複数の仮想マシンに使用できます。新しい仮想マシンは、更新された cloud-init 設定を使用して、cloud-init を実行します。

4. cloud-init を再実行するか、仮想マシンを再起動します。

   cloud-init が再実行し、設定変更を実装します。

手順

1. cloud-init 設定ファイルを確認します。

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

2. 特定の問題の詳細については、/var/log/cloud-init.log ファイルおよび /var/log/cloud-init-output.log ファイルを確認してください。たとえば、root パーティションが自動的に拡張されないという問題があった場合は、growpart のログメッセージを確認してください。ファイルシステムが拡張されなかった場合は、ログメッセージで resizefs を確認します。resizefs の grep コマンドの例を以下に示します。

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

   注記

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

3. cloud-init を再実行します。サンプルシナリオを以下に示します。root でコマンドを実行します。

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

     /usr/bin/cloud-init -d init

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

     /usr/bin/cloud-init -d modules

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

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

   • 以下のコマンドを実行してディレクトリーをクリーンアップし、クリーンなインスタンスをシミュレートします。

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

   • 以下のコマンドを実行して、cloud-init を再実行します。

     cloud-init init --local
     cloud-init init