すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:初期化ツール

最終更新日:Apr 28, 2026

Elastic Compute Service (ECS) インスタンスでは、作成時または起動時に初期化ツールを使用して、ネットワーキング、ホスト名、スクリプトを自動的に構成します。Linux では cloud-init を使用し、Windows では Vminit を使用します。

cloud-init

Linux インスタンスでは、オープンソースの cloud-init ツールを使用して自動で初期化します。cloud-init のドキュメントをご参照ください。

  • cloud-init はモジュールを定義します。各モジュールには名前、実行頻度、構成パラメーターがあります。主な実行頻度は once-per-instance (初回起動時のみ実行) と always (起動のたびに実行) の 2 つです。モジュールリファレンスをご参照ください。

  • cloud-init は /etc/cloud/cloud.cfg を使用して、実行するモジュールなどの初期化動作を制御します。モジュールはメタデータサービスからメタデータ (インスタンス ID、ホスト名など) を取得します。たとえば Set Hostname モジュールは、起動時にメタデータサービスからホスト名を取得して適用します。

説明

cloud-init は、Alibaba Cloud のすべてのパブリックイメージ、およびそれらから派生したカスタムイメージにプリインストールされています。オンプレミスデバイスから作成したカスタムイメージの場合は、cloud-init を手動でインストールする必要があります。cloud-init のインストールをご参照ください。

Vminit

Windows インスタンスでは、Vminit を使用して自動で初期化します。Vminit は一連のプラグインを順番に実行します。一部のプラグインは初回起動時のみ実行され、その他のプラグインは起動のたびに実行されます。Windows イメージからインスタンスを作成すると、すべてのプラグインが自動的に実行されます。

説明

Vminit は、2023 年 9 月以降にリリースされた Windows パブリックイメージ、およびそれらから派生したカスタムイメージにプリインストールされています。オンプレミスデバイスから作成したカスタムイメージの場合は、Vminit を手動でインストールする必要があります。Vminit のインストールをご参照ください。

次の表に、10 個の Vminit プラグインを示します。

説明

このプラグインリストは、2023 年 9 月以降にリリースされた Windows パブリックイメージ、およびそれらから派生したカスタムイメージに適用されます。その他のイメージには、異なるプラグインが含まれる場合があります。

Vminit プラグイン

プラグイン名

実行頻度

機能

説明

Plugin_Main_StartDepend

初回起動時のみ

IP Helper サービス、DHCP クライアント、Windows Time サービス (W32Time) を起動します。

これらのサービスは Windows イメージではデフォルトで有効になっています。カスタムイメージで無効化されている場合、このプラグインが再度有効化し、ネットワークおよび NTP の例外の発生を防ぎます。

Plugin_Main_OpenRDP

インスタンスへのリモートデスクトッププロトコル (RDP) 接続を有効にします。

RDP はデフォルトで有効です。カスタムイメージで無効化されている場合、このプラグインが RDP を再度有効化します。

Plugin_Main_NetworkClean

ネットワーク構成を初期化します。DHCP を使用して、すべてのネットワークインターフェイスの IP アドレスと DNS 設定を取得します。

IP Helper または DHCP のサービスが実行されていない場合、このプラグインが失敗し、内部ネットワーク経由でインスタンスメタデータにアクセスできなくなる可能性があります。

Plugin_Main_ConfigDisk

インスタンスとともに作成されたデータディスクを初期化します。ディスクをパーティション分割し、ドライブ文字を割り当てます。デフォルトでは GPT パーティション形式を使用します。

  • インスタンスの作成時に新しい (空の) データディスクをアタッチした場合、このプラグインが自動的に初期化してオンラインにします。

  • インスタンスの作成時に既存のデータを含むデータディスクをアタッチした場合、Vminit は初期化をスキップします。

Plugin_Main_ExtendVolume

システムディスクの使用可能な領域を検出し、diskpart を実行して拡張します。

なし

Plugin_Main_CloudinitUserData

メタデータサービスからインスタンスユーザーデータを取得し、システムアカウントでユーザーデータスクリプトを実行します。

Plugin_Main_ConfigHostname

起動のたび

インスタンスにホスト名を割り当てます。インスタンスの作成時にホスト名を指定した場合は、そのホスト名が使用されます。指定しない場合は、ランダムなホスト名が割り当てられます。

  • このプラグインの実行後、OS が直ちに再起動します。

  • 自動割り当てされたホスト名が指定したホスト名と一致する場合、再度の割り当ては行われません。

  • カスタムイメージ独自の起動スクリプトとのホスト名競合を防ぐには、カスタムイメージでこのプラグインを無効化してください。

Plugin_Main_ConfigWsus

メタデータサービスから WSUS アドレスを取得し、インスタンスに設定します。アドレスがすでに設定されている場合は、設定をスキップします。

内部ネットワークへのアクセスが必要です。

Plugin_Main_ConfigKms

メタデータサービスから KMS エンドポイントを取得し、KMS をアクティブ化します。同じエンドポイントで KMS がすでにアクティブ化されている場合は、アクティブ化をスキップします。

内部ネットワークへのアクセスが必要です。

Plugin_Main_ConfigNtp

メタデータサービスから NTP サーバーアドレスを取得し、時刻同期を構成します。アドレスがすでに設定されている場合は、構成をスキップします。

  • 内部ネットワークへのアクセスが必要です。

  • W32Time サービスが必要です。

リリースノート

次の表に、Vminit のバージョン履歴を示します。

Vminit バージョン

リリース内容

リリース日

2.0.1.8

  • 複数の問題を修正し、安定性と信頼性を向上させました。

  • Windows デスクトップ OS (Windows 7、Windows 8、Windows 10、Windows 11) に対応しました。

2025 年 7 月

2.0.1.6

  • Alibaba Cloud イメージからインスタンスを作成する際の再起動回数を削減しました。

  • ホスト名を変更する起動スクリプトを含むカスタムイメージの場合に、インスタンスが継続的に再起動する場合がある問題を修正しました。

2024 年 9 月

2.0.1.2

  • Windows イベントビューアーのエラーアラートをクリアしました。

  • ユーザーデータのバッチスクリプトで、環境変数の遅延展開に対応しました。

2024 年 1 月

2.0.1.0

初回リリース。構成可能なプラグインを導入しました。

2023 年 9 月

関連ドキュメント

インスタンスユーザーデータによる初期化では、インスタンスの作成時にインスタンスを構成できます。

カスタムイメージ向けに初期化ツールをインストールおよび構成する方法については、cloud-init のインストールおよび Vminit のインストールをご参照ください。