Elastic Compute Service:cloud-init のインストール

cloud-initの詳細については、「Cloud-initドキュメント」をご参照ください。

手順1: cloud-initをインストールまたはアップグレードする必要があるかどうかを確認する

1. ソースサーバーにログインします。

2. ソースサーバーにcloud-initがインストールされているかどうかを確認します。

   CentOSシリーズ

   rpm -qa | grep -i cloud-init 
   pip list | grep -i cloud-init

   Ubuntuシリーズ

   dpkg -l | grep -i cloud-init 
   pip list | grep -i cloud-init

   • バージョン番号が返されない場合、またはcloud-initのバージョンが0.7.9以前の場合は、手順2: cloud-initのインストールに進みます。

     重要

     cloud-init 0.7.9は、ネイティブcloud-initの初期バージョンであり、ECSインスタンスには適していないため、アップグレードする必要があります。

   • cloud-init 18以降が使用されている場合、cloud-initはインスタンスの初期化中にネットワークを自動的に設定できます。 ネットワーク構成がビジネス要件を満たしていない場合は、ニーズに応じてネットワーク構成をカスタマイズできます。

   • cloud-init 19.1.21が使用されている場合は、Alibaba Cloud cloud-init 23.2.2にアップグレードすることを推奨します。 Alibaba Cloud cloud-init 19.1.21と比較して、Alibaba Cloud cloud-init 23.2.2は以下の改善と新機能を提供します。

     • Cloud-init 23.2.2では、セキュリティ強化モードでインスタンスメタデータにアクセスできます。 インスタンスメタデータの詳細については、「インスタンスメタデータの取得」をご参照ください。

     • その他の機能強化、パフォーマンスの改善、エラー修正、およびコミュニティへの貢献。 詳細は、「ChangeLog」をご参照ください。

   • cloud-initの他のバージョン番号が返された場合は、このトピックの [次の操作] セクションで説明されている操作を実行します。

3. cloud-initインストール中の誤操作によるデータ損失を防ぐため、事前に移行元サーバーのデータをバックアップすることをお勧めします。 たとえば、スナップショットを作成して、ソースサーバーのデータをバックアップできます。

ステップ2: cloud-initのインストール

• (推奨) Alibaba Cloud cloud-init 23.2.2: このバージョンではPython 3.6以降が必要で、データソースとしてAliyunが使用されます。

• Alibaba Cloud cloud-init 19.1.21: このバージョンでは、Python 3.6以降が必要で、データソースとしてAliyunが使用されます。

• Alibaba Cloud cloud-init 0.7.6 a17: このバージョンのcloud-initを、CentOS 6、Debian 9、SUSE Linux Enterprise Server (SLES) 12などの以前の特定のオペレーティングシステムバージョンにインストールします。 Alibaba Cloud cloud-init 0.7.6 a17にはPython 2.7が必要で、データソースとしてAliyunを使用します。

  重要

  Pythonコミュニティは、Python 2.7のテクニカルサポートを提供しなくなりました。 依存関係ライブラリに関連するリスクを防ぐために、新しいバージョンのcloud-initを使用することを推奨します。

• Native cloud-init: コミュニティバージョンのcloud-initは、プロジェクトに貢献する開発者のコミュニティによって公開および管理されている公式バージョンです。 Alibaba Cloud cloud-initの最新バージョンは23.2.2です。 最新バージョンのcloud-initを使用する場合は、コミュニティバージョンのcloud-initをインストールします。 詳細については、公式cloud-init Webサイトをご覧ください。

Alibaba Cloud cloud-initは、Alibaba Cloudサービス向けに最適化されており、より良いサポートを提供できます。 互換性を確保するために、Alibaba Cloud cloud-initの使用を推奨します。 ビジネス要件に基づいてインストールするcloud-initバージョンを選択します。

# Check whether the python3-pip dependency library is installed. If the python3-pip dependency library is not installed, install the dependency library.
if !  python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Back up cloud-init of an earlier version.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init installation package.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install Alibaba Cloud cloud-init.
issue_major=$( cat /etc/redhat-release | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh centos "$issue_major"

# Check whether the python3-pip dependency library is installed. If the python3-pip dependency library is not installed, install the dependency library.
if !  python3 -c 'import setuptools' >& /dev/null; then
  yum -y install python3-pip
fi
# Back up cloud-init of an earlier version.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init installation package.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install Alibaba Cloud cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh rhel "$issue_major"

# Check whether the python3-pip dependency library is installed. If the python3-pip dependency library is not installed, install the dependency library.
if !  python3 -c 'import setuptools' >& /dev/null; then
  apt-get install python36 python3-pip -y
fi
# Back up cloud-init of an earlier version.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init installation package.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install Alibaba Cloud cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh ubuntu "$issue_major"

# Check whether the python3-pip dependency library is installed. If the python3-pip dependency library is not installed, install the dependency library.
if !  python3 -c 'import setuptools' >& /dev/null; then
  apt-get -y install python3-pip
fi
# Back up cloud-init of an earlier version.
test -d /etc/cloud && mv /etc/cloud /etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init installation package.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install Alibaba Cloud cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh debian "$issue_major"

# Check whether the python3-pip dependency library is installed. If the python3-pip dependency library is not installed, install the dependency library.
if !  python3 -c 'import setuptools'>& /dev/null; then
  zypper -n install python3-pip
fi
# Back up cloud-init of an earlier version.
test -d /etc/cloud && mv /etc/cloud/etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init installation package.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install Alibaba Cloud cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh sles "$issue_major"

# Check whether the python3-pip dependency library is installed. If the python3-pip dependency library is not installed, install the dependency library.
if !  python3 -c 'import setuptools'>& /dev/null; then
  zypper -n install python3-pip
fi
# Back up cloud-init of an earlier version.
test -d /etc/cloud && mv /etc/cloud/etc/cloud-old
# Download and decompress the Alibaba Cloud cloud-init installation package.
wget https://ecs-image-tools.oss-cn-hangzhou.aliyuncs.com/cloudinit/cloud-init-19.1.21.tgz
tar -zxvf ./cloud-init-19.1.21.tgz
# Install Alibaba Cloud cloud-init.
issue_major=$( cat /etc/os-release | grep VERSION_ID | grep -Eo '[0-9]+\.?[0-9]+' | head -1 | awk -F'.' '{printf $1}')
bash ./cloud-init-*/tools/deploy.sh opensuse"$issue_major"

(オプション) 手順3: cloud-initの設定

よくある質問

• Python 3を使用してcloud-initをインストールした後、必要な依存関係ライブラリがない場合はどうすればよいですか?

  欠落している依存関係ライブラリは、イメージによって異なる場合があります。 pipを使用して、不足している依存関係ライブラリをインストールし、cloud-initを再インストールできます。

• cloud-initが期待どおりに実行されず、エラーメッセージが返された場合はどうすればよいですか?

  デフォルトのソフトウェアパッケージマネージャー (YUMなど) とpipマネージャーを使用して異なるバージョンの依存関係ライブラリをインストールすると、ライブラリのバージョンが競合し、cloud-initでエラーが発生する可能性があります。 エラーメッセージに基づいて依存関係ライブラリをダウンロードすることを推奨します。

  エラーメッセージ	原因	トラブルシューティングコマンド
  no setuptools module in python	python setuptoolsモジュールがありません。	たとえば、Python 3.6を使用する場合は、オペレーティングシステムに基づいて次のいずれかのコマンドを実行して、python setuptoolsモジュールをインストールします。 CentOSとRed Hat: yum -y install python3-pip UbuntuとDebian: apt-get -y install python3-pip openSUSEとSUSE: zypper -n install python3-pip
  File "/home/testuser/cloud-init/cloudinit/log.py", line 19, in <module> import six ImportError: No module named six )	6つの依存関係ライブラリがありません。	pip3 install six
  File "/home/testuser/cloud-init/cloudinit/url_helper.py", line 20, in <module> import oauthlib.oauth1 as oauth1 ImportError: No module named oauthlib.oauth1 )	oauthlib依存関係ライブラリがありません。	pip3 install oauthlib
  依存関係ライブラリの欠落の表示はありません。	エラーメッセージは原因を示していません。	次のコマンドを実行して、cloud-initのrequirements.txtファイルに表示されるすべての依存関係ライブラリをインストールします。 pip3 install -r requirements.txt

• インスタンスにPython 3の新しいバージョンをインストールした後、ECSインスタンスでcloud-initが期待どおりに実行されない場合はどうすればよいですか?

  Python 3.9などのPython 3の新しいバージョンをECSインスタンスにインストールし、そのバージョンにシンボリックリンク (ln -s /usr/bin/python3.9 /usr/bin/python3など) を作成してインストールされたバージョンをデフォルトバージョンとして設定した場合、cloud-initはインスタンスで期待どおりに実行されません。 たとえば、cloud-init -- versionコマンドを実行すると、エラーが報告されます。

  $cloud-init --version
  Traceback (most recent call last):
    File "/usr/local/bin/cloud-init", line 33, in <module>
      sys.exit(load_entry_point('cloud-init==19.1.9', 'console_scripts', 'cloud-init')())
    File "/usr/local/bin/cloud-init", line 22, in importlib_load_entry_point
      for entry_point in distribution(dist_name).entry_points
    File "/usr/lib64/python3.9/importlib/metadata.py", line 524, in distribution
      return Distribution.from_name(distribution_name)
    File "/usr/lib64/python3.9/importlib/metadata.py", line 187, in from_name
      raise PackageNotFoundError(name)
  importlib.metadata.PackageNotFoundError: cloud-init

  以下のいずれかの方法を使用して問題を解決できます。

  • 方法1: 新しいバージョンのPython 3を使用してcloud-initを再インストールします。

  • 方法2: cloud-init実行可能ファイルを変更して、Pythonインタープリターのパスを以前のPython 3バージョンのパスに設定します。 この例では、Python 3.6が使用されます。 cloud-init実行可能ファイルのPythonインタプリタパスを変更するには、次の操作を実行します。

    1. 次のコマンドを実行して、cloud-init実行可能ファイルを開きます。

       vim   /usr/local/bin/cloud-init

    2. Iキーを押して挿入モードに入ります。 実行可能ファイルの先頭で、次の内容を置き換えます #! をPython 3.6のパスに置き換えます。

       #! で始まる行の新しいコンテンツの例:

       #!/usr/bin/python3.6

    3. Escキーを押して挿入モードを終了し、:wqと入力し、enterキーを押してファイルを保存して閉じます。

• インスタンスの作成中にインスタンスに指定したユーザーデータが、インスタンスにcloud-initをインストールした後に実行されない、または実行できない場合はどうすればよいですか。

  1. インスタンスで次のコマンドを実行して、インスタンスメタデータにユーザーデータが存在するかどうかを確認します。

     curl http://100.100.100.200/latest/user-data

     コマンド出力:

     • ユーザーデータがインスタンスメタデータに存在する場合、コマンド出力にはユーザーデータが含まれます。 この場合、他の操作を実行して問題をトラブルシューティングします。

     • ユーザーデータがインスタンスメタデータに存在しない場合、コマンド出力は返されません。

  2. ユーザーデータが実行されない、または実行できない理由を特定します。

     • ユーザーデータが有効な形式であるかどうかを確認します。

       cloud-initがユーザーデータを実行できるようにするには、ユーザーデータが有効な形式である必要があります。 たとえば、ユーザーデータの最初の行は #! で始まる必要があります。 詳細については、「インスタンスユーザーデータ」トピックの「インスタンスの初期化設定のカスタマイズ」セクションをご参照ください。

     • cloud-initの /var/log/cloud-init.logファイルのユーザーデータの実行結果を確認し、返されたエラーメッセージに基づいて問題をトラブルシューティングします。

       ログファイル内のユーザーデータの実行结果の例:

        util.py[DEBUG]: Running command ['/var/lib/cloud/instance/scripts/part-001'] with allowed return codes [0] (shell=False, capture=False)

     • ユーザーデータの実行時に生成される標準出力 (stdout) および標準エラー (stderr) を確認してください。

       systemd (Linuxのシステム初期化ツール) では、ユーザーデータはcloud-final.serviceシステムサービスによって実行されます。 次のコマンドを実行して、ユーザーデータの実行時に生成されたstdoutとstderrを確認できます。 次に、コマンド出力に基づいて問題をトラブルシューティングできます。

       journalctl -u cloud-final.service

     • 上記の操作を実行した後、ユーザーデータが実行されない、または実行されない理由を特定できない場合は、ユーザーデータをオンプレミスのコンピューターにコピーして、ユーザーデータが実行できるかどうかを確認することをお勧めします。

• インスタンスのシステム設定を初期化できず、インスタンスにcloud-initがインストールされた後にユーザーデータスクリプトを実行できない場合はどうすればよいですか。

  1. 次のコマンドを実行して、4つのcloud-initサービスがシステム起動時に自動的に実行されるように設定されているかどうかを確認します。

     systemctl is-enabled cloud-init-local.service
     systemctl is-enabled cloud-init.service
     systemctl is-enabled cloud-config.service
     systemctl is-enabled cloud-final.service

     cloud-initサービスに対してエラーメッセージまたはdisabledが表示された場合、サービスはシステム起動時に自動的に実行されるように構成されていません。

  2. 次のコマンドを実行して、システムの起動時に自動的に実行される4つのcloud-initサービスを設定します。

     systemctl enable cloud-init-local.service
     systemctl enable cloud-init.service
     systemctl enable cloud-config.service
     systemctl enable cloud-final.service

• インスタンスの作成時にディスクのサイズを変更した後、システムディスクのルートパーティションが自動的に拡張されない場合はどうすればよいですか?

  Cloud-initは、Linuxインスタンスのパーティションのサイズを自動的に変更します。 growpartツールがインストールされていること、およびcloud.cfgファイルの設定が正しいことを確認してください。

  1. 次のコマンドを実行して、growpartツールがインスタンスオペレーティングシステムにインストールされているかどうかを確認します。

     which growpart

  2. (条件付きで必要) groupartツールがインスタンスオペレーティングシステムにインストールされていない場合は、オペレーティングシステムに基づいて次のいずれかのコマンドを実行してgroupartツールをインストールします。

     • RHELシリーズ:

       sudo yum -y install cloud-utils-growpart

     • Debianシリーズ:

       sudo apt -y install cloud-guest-utils

  3. 次のコマンドを実行して、/etc/cloud/cloud.cfgファイルに次の図に示す内容が含まれているかどうかを確認します。

     cat /etc/cloud/cloud.cfg

     

  4. (条件付きで必要) /etc/cloud/cloud.cfgファイルにコンテンツが含まれていない場合は、ファイルにコンテンツを追加します。

• ECSコンソールでインスタンスのホスト名を変更してインスタンスを再起動した後、cloud-init 0.7.6 a16以前がインストールされているECSインスタンスの新しいホスト名が有効にならない場合はどうすればよいですか。

  • 問題の内容

    ECSコンソールでECSインスタンスのホスト名を変更してインスタンスを再起動した後、新しいホスト名は有効になりません。 ECSインスタンスでcloud-init -- versionコマンドを実行すると、インスタンスにインストールされているcloud-initのバージョンが0.7.6 a16以前であることがコマンド出力に示されます。

  • 原因

    cloud-initがupdate_hostnameモジュールを使用してホスト名を更新する場合、cloud-initはhostnameコマンドを実行して現在のシステムホスト名を取得し、cloud-initキャッシュ内のホスト名を /var/lib/cloud/data/previous-hostnameファイルから読み取りホスト名と照合します。 ホスト名が同じ場合、cloud-initはホスト名の更新を実行します。 ホスト名が異なる場合、cloud-initはホスト名が手動で変更されたと判断し、ホスト名の更新を実行しません。

    Red Hatオペレーティングシステムでは、/var/lib/cloud/data/previous-hostnameファイルから読み取られたコンテンツに改行が追加されますが、改行はhostnameコマンドの出力には追加されません。 その結果、読み取り内容がコマンド出力と異なり、ホスト名の更新に失敗します。

  • ソリューション

    以下のいずれかの方法を使用して問題を解決できます。

    • cloud-initバージョンをアップグレードします。 詳細については、このトピックの手順2: Install cloud-initセクションを参照してください。

      • CentOS 6以前の場合、cloud-init 0.7.6 a17にアップグレードします。

      • CentOS 7の場合、cloud-init 19.1.21にアップグレードします。

      • CentOS 8以降の場合、cloud-init 23.2.2以降にアップグレードします。

    • ラインフィードを追加します。

      cloud-initのcloudinit/distros/rhel.pyファイルを変更し、hostnameコマンド出力に改行を追加します。 find / -name rhel.pyコマンドを実行して、cloudinit/distros/rhel.pyファイルのパスを取得できます。 hostnameコマンド出力に改行を追加する方法については、「distros/rhel.py: _read_hostname() missing strip on "hostname" 」をご参照ください。 hostnameコマンド出力にラインフィードを追加する方法の例:

      diff --git a/cloudinit/distros/rhel.py b/cloudinit/distros/rhel.py
      index 0b68414e..65176e99 100644
      --- a/cloudinit/distros/rhel.py
      +++ b/cloudinit/distros/rhel.py
      @@ -143,6 +143,7 @@ class Distro(distros.Distro):
                   return util.load_file(filename).strip()
               elif self.uses_systemd():
                   (out, _err) = util.subp(['hostname'])
      +            out = out.strip()
                   if len(out):
                       return out
                   else: