インスタンスの作成 (create-instance)

重要

AWS OpsWorks Stacks は新規顧客を受け付けなくなりました。既存のお客様は、2024 年 5 月 26 日までは OpsWorks コンソール、 API、 CLI、および CloudFormation リソースを通常どおり使用できますが、その時点でこれらのリソースは廃止されます。この移行に備えて、できるだけ早くスタックを AWS Systems Manager に移行することをおすすめします。詳細については、AWS OpsWorks Stacks サポート終了に関する FAQ および AWS Systems Manager アプリケーションマネージャへの AWS OpsWorks Stacks アプリケーションの移行 を参照してください。

create-instance コマンドを使用して、指定したスタックにインスタンスを作成します。

デフォルトのホスト名を使用したインスタンスの作成

C:\>aws opsworks --region us-west-1 create-instance --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb
    --layer-ids 5c8c272a-f2d5-42e3-8245-5bf3927cb65b --instance-type m1.large --os "Amazon Linux"

引数は次のとおりです。

• stack-id – スタック ID は、コンソールのスタック設定ページ (「OpsWorks ID」を参照) か、[describe-stacks] を呼び出すことで、取得できます。

• layer-ids – レイヤー ID は、コンソールのレイヤー詳細ページ (「OpsWorks ID」を参照) か、[describe-layers] を呼び出すことで、取得できます。この例では、インスタンスは 1 つのレイヤーにのみ属しています。

• instance-type – インスタンス (この例では)m1.large のメモリ、CPU、ストレージ容量、および時間あたりのコストの定義を指定します。

• os - インスタンスのオペレーティングシステム (この例では Amazon Linux) です。

次に示すように、インスタンス ID を含む JSON オブジェクトがコマンドから返されます。

{
    "InstanceId": "5f9adeaa-c94c-42c6-aeef-28a5376002cd"
}

この例では、デフォルトのホスト名 (整数のみ) を持つインスタンスが作成されます。以下のセクションでは、テーマから生成されたホスト名を持つインスタンスを作成する方法を説明します。

テーマ付きホスト名のインスタンスの作成

テーマ付きホスト名のインスタンスを作成することもできます。スタックを作成する際にテーマを指定します。詳細については、「新しいスタックを作成する」を参照してください。インスタンスを作成するには、まず get-hostname-suggestion を呼び出して名前を生成します。例えば：

C:\>aws opsworks get-hostname-suggestion --region us-west-1 --layer-id 5c8c272a-f2d5-42e3-8245-5bf3927cb65b

デフォルトの Layer Dependent テーマを指定した場合は、get-hostname-suggestion によってレイヤーの短縮名に単に数字が付加されます。詳細については、「新しいスタックを作成する」を参照してください。

コマンドによって生成されたホスト名が返されます。

{
    "Hostname": "php-app2",
    "LayerId": "5c8c272a-f2d5-42e3-8245-5bf3927cb65b"
}

生成された名前を create-instance に渡すには、次のように hostname 引数を使用します。

c:\>aws --region us-west-1 opsworks create-instance --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb
   --layer-ids 5c8c272a-f2d5-42e3-8245-5bf3927cb65b --instance-type m1.large --os "Amazon Linux" --hostname "php-app2"

カスタム AMI を使用したインスタンスの作成

次の create-instance コマンドは、カスタム AMI を使用してインスタンスを作成します。これは、スタックのリージョンからのものである必要があります。AWS OpsWorks スタックのカスタム AMI を作成する方法の詳細については、「カスタム AMI の使用」を参照してください。

C:\>aws opsworks create-instance --region us-west-1 --stack-id c5ef46ce-3ccd-472c-a3de-9bec94c6028e
   --layer-ids 6ff8a2ac-c9cc-49cf-9c67-fc852539ade4 --instance-type c3.large --os Custom
   --ami-id ami-6c61f104

引数は次のとおりです。

• stack-id – スタック ID は、コンソールのスタック設定ページ (「OpsWorks ID」を参照) か、[describe-stacks] を呼び出すことで、取得できます。

• layer-ids – レイヤー ID は、コンソールのレイヤー詳細ページ (「OpsWorks ID」を参照) か、[describe-layers] を呼び出すことで、取得できます。この例では、インスタンスは 1 つのレイヤーにのみ属しています。

• instance-type - この値はインスタンスのメモリ、CPU、ストレージ容量、および時間あたりのコストを定義します。AMI と互換性がある必要があります (この例では c3.large を参照)。

• os – インスタンスのオペレーティングシステムです。カスタム AMI に対して Custom に設定する必要があります。

• ami-id – AMI ID です。ami-6c61f104 のようになります

注記

カスタム AMI を使用すると、ブロックデバイスマッピングはサポートされず、--block-device-mappings オプションに指定した値は無視されます。

次に示すように、インスタンス ID を含む JSON オブジェクトがコマンドから返されます。

{
    "InstanceId": "5f9adeaa-c94c-42c6-aeef-28a5376002cd"
}