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

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

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

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

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

   CentOSシリーズ

   rpm -qa | grep -i cloud-init
   pipリスト | grep -i cloud-init 

   Ubuntuシリーズ

   dpkg -l | grep -i cloud-init
   pipリスト | grep -i cloud-init 

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

     説明

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

   • cloud-initのバージョンが18以降の場合、cloud-initはインスタンスの初期化中にネットワークを設定できます。 ネットワーク設定がビジネス要件を満たしていない場合は、設定を変更できます。 詳細については、このトピックの「ネットワーク構成のカスタマイズ」をご参照ください。

   • cloud-initのバージョンが19.1.21の場合、cloud-init 23.2.2にアップグレードすることを推奨します。 cloud-init 19.1.21と比較して、cloud-init 23.2.2は次の改善と新機能を提供します。

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

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

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

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

ネットワーク設定のカスタマイズ

Cloud-init 18以降は、次のようにネットワーク設定を自動的に初期化します。BOOTPROTO=dhcp DEVICE=eth0 ONBOOT=yes STARTMODE=auto TYPE=Ethernet USERCTL=no。 デフォルトのネットワーク設定がビジネス要件を満たしていない場合は、次の操作を実行してネットワーク設定をカスタマイズできます。

1. cloud-initをインストールしたら、/etc/cloud/cloud.cfgファイルを作成します。

   sudo vim /etc/cloud/cloud.cfg

2. Iキーを押して挿入モードに入ります。 Example datasource configの前に、次の無効設定を追加します。

   ネットワーク:
     config: 無効 

   説明

   設定を追加した後、cloud-initはネットワーク設定を管理しないため、/etc/sysconfig/network-scripts/ ディレクトリでネットワーク設定を手動で管理する必要があります。

   

3. を押してください。Esc挿入モードを終了するキー、: wq次に、Enterキーを押してファイルを保存して閉じます。

ホスト名と /etc/hosts設定ファイルの保持

デフォルトでは、cloud-init設定ファイルのホスト名は保持されません。 ECSインスタンスのホスト名および /etc/hosts設定ファイルを変更しない場合は、以下の操作を実行してcloud-init設定ファイルを変更できます。

1. cloud-initをインストールしたら、/etc/cloud/cloud.cfgファイルを作成します。

   sudo vim /etc/cloud/cloud.cfg

2. を押してください。私は挿入モードに入り、変更するキーpreserve_hostname: falseへpreserve_hostname: true.

   

3. を押してください。Esc挿入モードを終了するキー、: wq次に、Enterキーを押してファイルを保存して閉じます。

   preserve_hostname: trueは、cloud-initがインスタンスのホスト名と /etc/hosts設定ファイルを変更しないようにします。

トラブルシューティング

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

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

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

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

  エラーメッセージ	考えられる原因	トラブルシューティングコマンド
  pythonにsetuptoolsモジュールがない	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
  ファイル「 /home/testuser/cloud-init/cloudinit/log.py」、19行目、<モジュール> 6をインポート ImportError: 6という名前のモジュールはありません)	6つの依存関係ライブラリがありません。	pip3インストール6
  ファイル "/home/testuser/cloud-init/cloudinit/url_helper.py" 、20行目、<module> oauth1としてoauthlib.oauth1をインポートします。 ImportError: oauthlib.oauth1という名前のモジュールはありません。	oauthlib依存関係ライブラリがありません。	pip3インストールoauthlib
  不足している依存関係ライブラリの表示がありません。	エラーメッセージは原因を示していません。	次のコマンドを実行して、cloud-initのrequirements.txtファイルに表示されるすべての依存関係ライブラリをインストールします。 pip3インストール-r requirements.txt

• 正しいバージョンのcloud-initがインストールされていることを確認するにはどうすればよいですか?

  cloud-initをインストールしたら、cloud-init -- versionコマンドを実行してcloud-initのバージョンを確認できます。 返されたバージョンがインストールするバージョンである場合、cloud-initのバージョンは正しいです。 たとえば、Alibaba Cloud cloud-init 19.1.21をインストールするとします。 cloud-initをインストールしてcloud-init -- versionコマンドを実行すると、cloud-init 19.1.21がインストールされている場合、コマンド出力に19.1.21が含まれます。

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

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

  $cloud-init -- version
  Traceback (最後の呼び出し):
    ファイル "/usr/local/bin/cloud-init" 、33行目、<module>
      sys.exit(load_entry_point('cloud-init==19.1.9 ', 'console_scripts', 'cloud-init')())
    ファイル "/usr/local/bin/cloud-init" 、22行目、importlib_load_entry_point
      ディストリビューション内のentry_point (dist_name) の
    ファイル "/usr/lib64/python3.9/importlib/metadata.py" 、524行目、配布中
      return Distribution.from_name(distribution_name)
    ファイル "/usr/lib64/python3.9/importlib/metadata.py" 、行187、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 /最新 /ユーザーデータ

     コマンド出力:

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

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

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

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

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

     • インスタンス作成時にセキュリティ強化モードが選択されたかどうかを確認します。

       インスタンスの作成時にセキュリティ強化モードを選択した場合、cloud-initのコンポーネントを初期化できません。これは、メタデータやユーザーデータなどのインスタンス設定に影響します。 詳細については、「インスタンスメタデータの取得」をご参照ください。

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

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

       util.py[DEBUG]: コマンド ['/var/lib/cloud/instance/scripts/part-001'] を許可されたリターンコード [0] (シェル=False、キャプチャ=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有効cloud-init-local.service
     systemctl有効cloud-init.service
     systemctl有効cloud-config.service
     systemctl cloud-final.service

     を有効にする

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

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

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

     どのgroupart

  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ファイルにコンテンツが含まれていない場合は、ファイルにコンテンツを追加します。