AWS OpsWorks を使用した の例 AWS CLI

登録されたインスタンスをレイヤーに割り当てるには

次の例では、登録されたインスタンスをカスタムレイヤーに割り当てます。

aws opsworks --region us-east-1 assign-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2 --layer-ids 26cf1d32-6876-42fa-bbf1-9cadc0bff938

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Assigning a Registered Instance to a Layer」を参照してください。

登録されたボリュームをインスタンスに割り当てるには

次の例では、登録済みの Amazon Elastic Block Store (Amazon EBS) ボリュームをインスタンスに割り当てます。ボリュームはボリューム ID によって識別されます。ボリューム ID は、Amazon Elastic Compute Cloud (Amazon EC2) ボリューム ID ではなく、スタックにボリュームを登録するときに AWS OpsWorks が割り当てる GUID です。assign-volume を実行する前に、まず update-volume を実行してマウントポイントをボリュームに割り当てる必要があります。

aws opsworks --region us-east-1 assign-volume --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2 --volume-id 26cf1d32-6876-42fa-bbf1-9cadc0bff938

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Assigning Amazon EBS Volumes to an Instance」を参照してください。

Elastic IP アドレスをインスタンスに関連付けるには

次の例では、Elastic IP アドレスを指定されたインスタンスと関連付けます。

aws opsworks --region us-east-1 associate-elastic-ip --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f --elastic-ip 54.148.130.96

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Resource Management」を参照してください。

ロードバランサーをレイヤーにアタッチするには

次の例では、名前で識別されるロードバランサーを指定されたレイヤーにアタッチします。

aws opsworks --region us-east-1 attach-elastic-load-balancer --elastic-load-balancer-name Java-LB --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Elastic Load Balancing」を参照してください。

例 1: アプリケーションを作成するには

次の例では、GitHub リポジトリに保存されているコードから SimplePHPApp という名前の PHP アプリケーションを作成します。このコマンドは、アプリケーションソース定義の短縮形式を使用します。

aws opsworks create-app \
    --region us-east-1 \
    --stack-id f6673d70-32e6-4425-8999-265dd002fec7 \
    --name SimplePHPApp \
    --type php \
    --app-source Type=git,Url=git://github.com/amazonwebservices/opsworks-demo-php-simple-app.git,Revision=version1

出力:

{
    "AppId": "6cf5163c-a951-444f-a8f7-3716be75f2a2"
}

例 2: データベースがアタッチされたアプリケーションを作成するには

次の例では、パブリック S3 バケットの .zip アーカイブに保存されているコードから JSP アプリケーションを作成します。RDS DB インスタンスをアタッチして、アプリケーションのデータストアとして機能させます。アプリケーションソースとデータベースソースは、コマンドを実行するディレクトリにある個別の JSON ファイルで定義されます。

aws opsworks create-app \
    --region us-east-1 \
    --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 \
    --name SimpleJSP \
    --type java \
    --app-source file://appsource.json \
    --data-sources file://datasource.json

アプリケーションソース情報は appsource.json にあり、以下が含まれています。

{
    "Type": "archive",
    "Url": "https://s3.amazonaws.com/opsworks-demo-assets/simplejsp.zip"
}

データベースソース情報は datasource.json にあり、以下が含まれています。

[
    {
        "Type": "RdsDbInstance",
        "Arn": "arn:aws:rds:us-west-2:123456789012:db:clitestdb",
        "DatabaseName": "mydb"
    }
]

注: RDS DB インスタンスの場合は、まず register-rds-db-instance を使用してインスタンスをスタックに登録する必要があります。MySQL App Server インスタンスの場合は、Type を OpsworksMysqlInstance に設定します。これらのインスタンスは AWS OpsWorks によって作成されるため、登録する必要はありません。

出力:

{
    "AppId": "26a61ead-d201-47e3-b55c-2a7c666942f8"
}

詳細については、「AWS OpsWorks User Guide」の「Adding Apps」を参照してください。

例 1: アプリケーションをデプロイし、スタックコマンドを実行するには

次の例は、create-deployment コマンドを使用してアプリケーションをデプロイし、スタックコマンドを実行する方法を示しています。コマンドを指定する JSON オブジェクトの引用符 (") 文字の前には、すべてエスケープ文字 (\) が付いていることに注意してください。エスケープ文字がないと、コマンドは無効な JSON エラーを返す可能性があります。

次の create-deployment の例では、指定されたスタックにアプリケーションをデプロイします。

aws opsworks create-deployment \
    --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \
    --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb
    --command "{\"Name\":\"deploy\"}"

出力:

{
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
}

例 2: Rails アプリケーションをデプロイしてデータベースを移行するには

次の create-deployment コマンドは、Ruby on Rails アプリケーションを指定されたスタックにデプロイし、データベースを移行します。

aws opsworks create-deployment \
    --stack-id cfb7e082-ad1d-4599-8e81-de1c39ab45bf \
    --app-id 307be5c8-d55d-47b5-bd6e-7bd417c6c7eb \
    --command "{\"Name\":\"deploy\", \"Args\":{\"migrate\":[\"true\"]}}"

出力:

{
    "DeploymentId": "5746c781-df7f-4c87-84a7-65a119880560"
}

デプロイの詳細については、「AWS OpsWorks User Guide」の「Deploying Apps」を参照してください。

例 3: レシピを実行する

次の create-deployment コマンドは、指定されたスタックのインスタンスでカスタムレシピ phpapp::appsetup を実行します。

aws opsworks create-deployment \
    --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \
    --command "{\"Name\":\"execute_recipes\", \"Args\":{\"recipes\":[\"phpapp::appsetup\"]}}"

出力:

{
    "DeploymentId": "5cbaa7b9-4e09-4e53-aa1b-314fbd106038"
}

詳細については、「AWS OpsWorks User Guide」の「Run Stack Commands」を参照してください。

例 4: 依存関係をインストールする

次の create-deployment コマンドは、パッケージや Ruby gem などの依存関係を、指定されたスタックのインスタンスにインストールします。

aws opsworks create-deployment \
    --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb \
    --command "{\"Name\":\"install_dependencies\"}"

出力:

{
    "DeploymentId": "aef5b255-8604-4928-81b3-9b0187f962ff"
}

詳細については、「AWS OpsWorks User Guide」の「Run Stack Commands」を参照してください。

インスタンスを作成するには

次の create-instance コマンドは、指定されたスタックに myinstance1 という名前の m1.large Amazon Linux インスタンスを作成します。インスタンスは 1 つのレイヤーに割り当てられます。

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

自動生成された名前を使用するには、get-hostname-suggestion を呼び出します。これは、スタックの作成時に指定したテーマに基づいてホスト名が生成されます。次に、その名前をホスト名引数に渡します。

出力:

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

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Adding an Instance to a Layer」を参照してください。

レイヤーを作成するには

次の create-layer コマンドは、指定されたスタックに MyPHPLayer という名前の PHP App Server レイヤーを作成します。

aws opsworks create-layer --region us-east-1 --stack-id f6673d70-32e6-4425-8999-265dd002fec7 --type php-app --name MyPHPLayer --shortname myphplayer

出力:

{
  "LayerId": "0b212672-6b4b-40e4-8a34-5a943cf2e07a"
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「How to Create a Layer」を参照してください。

サーバーを作成するには

次の create-server の例では、デフォルトのリージョンに automate-06 という名前の新しい Chef Automate サーバーを作成します。デフォルト値は、保持するバックアップの数、メンテナンスとバックアップの開始時間など、他のほとんどの設定で使用されます。create-server コマンドを実行する前に、AWS OpsWorks for Chef Automate ユーザーガイド」のAWS 「OpsWorks for Chef Automate の開始方法」の前提条件を完了してください。

aws opsworks-cm create-server \
    --engine "ChefAutomate" \
    --instance-profile-arn "arn:aws:iam::012345678901:instance-profile/aws-opsworks-cm-ec2-role" \
    --instance-type "t2.medium" \
    --server-name "automate-06" \
    --service-role-arn "arn:aws:iam::012345678901:role/aws-opsworks-cm-service-role"

出力:

{
    "Server": {
        "AssociatePublicIpAddress": true,
        "BackupRetentionCount": 10,
        "CreatedAt": 2019-12-29T13:38:47.520Z,
        "DisableAutomatedBackup": FALSE,
        "Endpoint": "https://opsworks-cm.us-east-1.amazonaws.com",
        "Engine": "ChefAutomate",
        "EngineAttributes": [
            {
                "Name": "CHEF_AUTOMATE_ADMIN_PASSWORD",
                "Value": "1Example1"
            }
        ],
        "EngineModel": "Single",
        "EngineVersion": "2019-08",
        "InstanceProfileArn": "arn:aws:iam::012345678901:instance-profile/aws-opsworks-cm-ec2-role",
        "InstanceType": "t2.medium",
        "PreferredBackupWindow": "Sun:02:00",
        "PreferredMaintenanceWindow": "00:00",
        "SecurityGroupIds": [ "sg-12345678" ],
        "ServerArn": "arn:aws:iam::012345678901:instance/automate-06-1010V4UU2WRM2",
        "ServerName": "automate-06",
        "ServiceRoleArn": "arn:aws:iam::012345678901:role/aws-opsworks-cm-service-role",
        "Status": "CREATING",
        "SubnetIds": [ "subnet-12345678" ]
    }
}

詳細については、「AWS OpsWorks for Chef Automate API Reference」の「CreateServer」を参照してください。

スタックを作成するには

次の create-stack コマンドは、CLI スタックという名前のスタックを作成します。

aws opsworks create-stack --name "CLI Stack" --stack-region "us-east-1" --service-role-arn arn:aws:iam::123456789012:role/aws-opsworks-service-role --default-instance-profile-arn arn:aws:iam::123456789012:instance-profile/aws-opsworks-ec2-role --region us-east-1

service-role-arn および default-instance-profile-arn パラメータが必要です。通常、最初のスタックを作成するときに、 AWS OpsWorks が作成するものを使用します。アカウントの Amazon リソースネーム (ARN) を取得するには、IAM コンソールに移動し、ナビゲーションパネルで [Roles] を選択し、ロールまたはプロファイルを選択して、[Summary] タブを選択します。

出力:

{
  "StackId": "f6673d70-32e6-4425-8999-265dd002fec7"
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Create a New Stack」を参照してください。

ユーザープロファイルを作成するには

AWS Identity and Access Manager (IAM) ユーザーを AWS OpsWorks にインポートするには、create-user-profile を呼び出してユーザープロファイルを作成します。次の例では、Amazon リソースネーム (ARN) で識別される cli-user-test IAM ユーザーのユーザープロファイルを作成します。この例では、ユーザーに SSH ユーザー名 myusername を割り当て、自己管理を有効にします。これにより、ユーザーは SSH パブリックキーを指定できます。

aws opsworks --region us-east-1 create-user-profile --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test --ssh-username myusername --allow-self-management

出力:

{
  "IamUserArn": "arn:aws:iam::123456789102:user/cli-user-test"
}

ヒント: このコマンドは IAM ユーザーを AWS OpsWorks にインポートしますが、アタッチされたポリシーによって付与されたアクセス許可を持つ必要があります。set-permissions コマンドを使用して、stack AWS OpsWorks ごとのアクセス許可を付与できます。

詳細情報

詳細については、「 AWS OpsWorks AWS ユーザーガイド」のOpsWorks へのユーザーのインポート」を参照してください。

アプリケーションを削除するには

次の例では、アプリケーション ID で識別される、指定されたアプリケーションを削除します。アプリ ID を取得するには、 AWS OpsWorks コンソールのアプリの詳細ページに移動するか、 describe-apps コマンドを実行します。

aws opsworks delete-app --region us-east-1 --app-id 577943b9-2ec1-4baf-a7bf-1d347601edc5

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Apps」を参照してください。

インスタンスを削除するには

次の delete-instance の例では、インスタンス ID で識別される、指定されたインスタンスを削除します。インスタンス ID を見つけるには、 AWS OpsWorks コンソールでインスタンスの詳細ページを開くか、 describe-instances コマンドを実行します。

インスタンスがオンラインの場合は、まず stop-instance を呼び出してインスタンスを停止し、インスタンスが停止するまで待つ必要があります。describe-instances を実行してインスタンスのステータスを確認します。

インスタンスの Amazon EBS ボリュームまたは Elastic IP アドレスを削除するには、それぞれ --delete-volumes または --delete-elastic-ip 引数を追加します。

aws opsworks delete-instance \
    --region us-east-1 \
    --instance-id 3a21cfac-4a1f-4ce2-a921-b2cfba6f7771

このコマンドでは何も出力されません。

詳細については、AWS 「 OpsWorks ユーザーガイド」の「DeletingOpsWorks Instances」を参照してください。 AWS OpsWorks

レイヤーを削除するには

次の例では、レイヤー ID で識別される指定されたレイヤーを削除します。レイヤー ID を取得するには、 AWS OpsWorks コンソールのレイヤーの詳細ページに移動するか、 describe-layers コマンドを実行します。

注: レイヤーを削除する前に、delete-instance を使用してレイヤーのすべてのインスタンスを削除する必要があります。

aws opsworks delete-layer --region us-east-1 --layer-id a919454e-b816-4598-b29a-5796afb498ed

出力: なし。

詳細情報

詳細については、 AWS 「 OpsWorks AWS ユーザーガイド」の「DeletingOpsWorks Instances」を参照してください。

スタックを削除するには

次の例では、スタック ID で識別される、指定されたスタックを削除します。スタック ID を取得するには、 AWS OpsWorks コンソールで スタック設定 をクリックするか、 describe-stacks コマンドを実行します。

注: レイヤーを削除する前に、delete-app、delete-instance、および delete-layer を使用して、スタックのすべてのアプリケーション、インスタンス、およびレイヤーを削除する必要があります。

aws opsworks delete-stack --region us-east-1 --stack-id 154a9d89-7e9e-433b-8de8-617e53756c84

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Shut Down a Stack」を参照してください。

ユーザープロファイルを削除し、 AWS OpsWorks から IAM ユーザーを削除するには

次の の例では、Amazon リソースネーム (ARN) で識別される、指定された AWS Identity and Access Management (IAM) ユーザーのユーザープロファイルを削除します。オペレーションは、 AWS OpsWorks からユーザーを削除しますが、IAM ユーザーを削除しません。そのタスクには、IAM コンソール、CLI、または API を使用する必要があります。

aws opsworks --region us-east-1 delete-user-profile --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test

出力: なし。

詳細情報

詳細については、「 AWS OpsWorks AWS ユーザーガイド」のOpsWorks へのユーザーのインポート」を参照してください。

スタックから Elastic IP アドレスの登録を解除するには

次の例では、IP アドレスによって識別される Elastic IP アドレスをスタックから登録解除します。

aws opsworks deregister-elastic-ip --region us-east-1 --elastic-ip 54.148.130.96

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Deregistering Elastic IP Addresses」を参照してください。

スタックから登録済みインスタンスの登録を解除するには

次の deregister-instance コマンドは、登録済みインスタンスの登録をスタックから解除します。

aws opsworks --region us-east-1 deregister-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Deregistering a Registered Instance」を参照してください。

スタックから Amazon RDS DB インスタンスの登録を解除するには

次の例では、ARN によって識別される RDS DB インスタンスの登録をスタックから解除します。

aws opsworks deregister-rds-db-instance --region us-east-1 --rds-db-instance-arn arn:aws:rds:us-west-2:123456789012:db:clitestdb

出力: なし。

詳細情報

詳細については、「ASW OpsWorks User Guide」の「Deregistering Amazon RDS Instances」を参照してください。

インスタンス ID: clitestdb Master usernams: cliuser Master PWD: some23!pwd DB Name: mydb aws opsworks deregister-rds-db-instance --region us-east-1 --rds-db-instance-arn arn:aws:rds:us-west-2:645732743964:db:clitestdb

Amazon EBS ボリュームの登録を解除するには

次の例では、EBS ボリュームをスタックから登録解除します。ボリュームは、ボリューム ID によって識別されます。ボリューム ID は、EC2 ボリューム ID ではなく、スタックにボリュームを登録したときに AWS OpsWorks が割り当てた GUID です。

aws opsworks deregister-volume --region us-east-1 --volume-id 5c48ef52-3144-4bf5-beaa-fda4deb23d4d

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Deregistering Amazon EBS Volumes」を参照してください。

アプリケーションについて説明するには

次の describe-apps コマンドは、指定されたスタック内のアプリケーションについて説明します。

aws opsworks describe-apps \
    --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a \
    --region us-east-1

出力:

{
    "Apps": [
        {
            "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
            "AppSource": {
            "Url": "https://s3-us-west-2.amazonaws.com/opsworks-demo-assets/simplejsp.zip",
            "Type": "archive"
        },
            "Name": "SimpleJSP",
            "EnableSsl": false,
            "SslConfiguration": {},
            "AppId": "da1decc1-0dff-43ea-ad7c-bb667cd87c8b",
            "Attributes": {
            "RailsEnv": null,
            "AutoBundleOnDeploy": "true",
            "DocumentRoot": "ROOT"
        },
            "Shortname": "simplejsp",
            "Type": "other",
            "CreatedAt": "2013-08-01T21:46:54+00:00"
        }
    ]
}

詳細については、「AWS OpsWorks User Guide」の「Apps」を参照してください。

コマンドについて説明するには

次の describe-commands コマンドは、指定されたインスタンス内のコマンドについて説明します。

aws opsworks describe-commands \
    --instance-id 8c2673b9-3fe5-420d-9cfa-78d875ee7687 \
    --region us-east-1

出力:

{
    "Commands": [
        {
            "Status": "successful",
            "CompletedAt": "2013-07-25T18:57:47+00:00",
            "InstanceId": "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
            "DeploymentId": "6ed0df4c-9ef7-4812-8dac-d54a05be1029",
            "AcknowledgedAt": "2013-07-25T18:57:41+00:00",
            "LogUrl": "https://s3.amazonaws.com/<bucket-name>/logs/008c1a91-ec59-4d51-971d-3adff54b00cc?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE &Expires=1375394373&Signature=HkXil6UuNfxTCC37EPQAa462E1E%3D&response-cache-control=private&response-content-encoding=gzip&response-content- type=text%2Fplain",
            "Type": "undeploy",
            "CommandId": "008c1a91-ec59-4d51-971d-3adff54b00cc",
            "CreatedAt": "2013-07-25T18:57:34+00:00",
            "ExitCode": 0
        },
        {
            "Status": "successful",
            "CompletedAt": "2013-07-25T18:55:40+00:00",
            "InstanceId": "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
            "DeploymentId": "19d3121e-d949-4ff2-9f9d-94eac087862a",
            "AcknowledgedAt": "2013-07-25T18:55:32+00:00",
            "LogUrl": "https://s3.amazonaws.com/<bucket-name>/logs/899d3d64-0384-47b6-a586-33433aad117c?AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE &Expires=1375394373&Signature=xMsJvtLuUqWmsr8s%2FAjVru0BtRs%3D&response-cache-control=private&response-content-encoding=gzip&response-conten t-type=text%2Fplain",
            "Type": "deploy",
            "CommandId": "899d3d64-0384-47b6-a586-33433aad117c",
            "CreatedAt": "2013-07-25T18:55:29+00:00",
            "ExitCode": 0
        }
    ]
}

詳細については、 AWS 「 OpsWorks AWS ユーザーガイド」のOpsWorks ライフサイクルイベント」を参照してください。

デプロイについて説明するには

次の describe-deployments コマンドは、指定されたスタック内のデプロイについて説明します。

aws opsworks --region us-east-1 describe-deployments --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a

出力:

{
  "Deployments": [
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Status": "successful",
          "CompletedAt": "2013-07-25T18:57:49+00:00",
          "DeploymentId": "6ed0df4c-9ef7-4812-8dac-d54a05be1029",
          "Command": {
              "Args": {},
              "Name": "undeploy"
          },
          "CreatedAt": "2013-07-25T18:57:34+00:00",
          "Duration": 15,
          "InstanceIds": [
              "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
              "9e588a25-35b2-4804-bd43-488f85ebe5b7"
          ]
      },
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Status": "successful",
          "CompletedAt": "2013-07-25T18:56:41+00:00",
          "IamUserArn": "arn:aws:iam::123456789012:user/someuser",
          "DeploymentId": "19d3121e-d949-4ff2-9f9d-94eac087862a",
          "Command": {
              "Args": {},
              "Name": "deploy"
          },
          "InstanceIds": [
              "8c2673b9-3fe5-420d-9cfa-78d875ee7687",
              "9e588a25-35b2-4804-bd43-488f85ebe5b7"
          ],
          "Duration": 72,
          "CreatedAt": "2013-07-25T18:55:29+00:00"
      }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Deploying Apps」を参照してください。

Elastic IP インスタンスについて説明するには

次の describe-elastic-ips コマンドは、指定されたインスタンスの Elastic IP アドレスについて説明します。

aws opsworks --region us-east-1 describe-elastic-ips --instance-id b62f3e04-e9eb-436c-a91f-d9e9a396b7b0

出力:

{
  "ElasticIps": [
      {
          "Ip": "192.0.2.0",
          "Domain": "standard",
          "Region": "us-west-2"
      }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Instances」を参照してください。

スタックの Elastic ロードバランサーについて説明するには

次の describe-elastic-load-balancers コマンドは、指定されたスタックのロードバランサーについて説明します。

aws opsworks --region us-west-2 describe-elastic-load-balancers --stack-id 6f4660e5-37a6-4e42-bfa0-1358ebd9c182

出力: この特定のスタックにはロードバランサーが 1 つあります。

{
  "ElasticLoadBalancers": [
      {
          "SubnetIds": [
              "subnet-60e4ea04",
              "subnet-66e1c110"
          ],
          "Ec2InstanceIds": [],
          "ElasticLoadBalancerName": "my-balancer",
          "Region": "us-west-2",
          "LayerId": "344973cb-bf2b-4cd0-8d93-51cd819bab04",
          "AvailabilityZones": [
              "us-west-2a",
              "us-west-2b"
          ],
          "VpcId": "vpc-b319f9d4",
          "StackId": "6f4660e5-37a6-4e42-bfa0-1358ebd9c182",
          "DnsName": "my-balancer-2094040179.us-west-2.elb.amazonaws.com"
      }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Apps」を参照してください。

インスタンスについて説明するには

次の describe-instances コマンドは、指定されたスタック内のインスタンスについて説明します。

aws opsworks --region us-east-1 describe-instances --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

出力: 次の出力例は、2 つのインスタンスを持つスタックの場合です。1 つ目は登録された EC2 インスタンスで、2 つ目は AWS OpsWorks によって作成されました。

{
  "Instances": [
    {
      "StackId": "71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f",
      "PrivateDns": "ip-10-31-39-66.us-west-2.compute.internal",
      "LayerIds": [
        "26cf1d32-6876-42fa-bbf1-9cadc0bff938"
      ],
      "EbsOptimized": false,
      "ReportedOs": {
        "Version": "14.04",
        "Name": "ubuntu",
        "Family": "debian"
      },
      "Status": "online",
      "InstanceId": "4d6d1710-ded9-42a1-b08e-b043ad7af1e2",
      "SshKeyName": "US-West-2",
      "InfrastructureClass": "ec2",
      "RootDeviceVolumeId": "vol-d08ec6c1",
      "SubnetId": "subnet-b8de0ddd",
      "InstanceType": "t1.micro",
      "CreatedAt": "2015-02-24T20:52:49+00:00",
      "AmiId": "ami-35501205",
      "Hostname": "ip-192-0-2-0",
      "Ec2InstanceId": "i-5cd23551",
      "PublicDns": "ec2-192-0-2-0.us-west-2.compute.amazonaws.com",
      "SecurityGroupIds": [
        "sg-c4d3f0a1"
      ],
      "Architecture": "x86_64",
      "RootDeviceType": "ebs",
      "InstallUpdatesOnBoot": true,
      "Os": "Custom",
      "VirtualizationType": "paravirtual",
      "AvailabilityZone": "us-west-2a",
      "PrivateIp": "10.31.39.66",
      "PublicIp": "192.0.2.06",
      "RegisteredBy": "arn:aws:iam::123456789102:user/AWS/OpsWorks/OpsWorks-EC2Register-i-5cd23551"
    },
    {
      "StackId": "71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f",
      "PrivateDns": "ip-10-31-39-158.us-west-2.compute.internal",
      "SshHostRsaKeyFingerprint": "69:6b:7b:8b:72:f3:ed:23:01:00:05:bc:9f:a4:60:c1",
      "LayerIds": [
        "26cf1d32-6876-42fa-bbf1-9cadc0bff938"
      ],
      "EbsOptimized": false,
      "ReportedOs": {},
      "Status": "booting",
      "InstanceId": "9b137a0d-2f5d-4cc0-9704-13da4b31fdcb",
      "SshKeyName": "US-West-2",
      "InfrastructureClass": "ec2",
      "RootDeviceVolumeId": "vol-e09dd5f1",
      "SubnetId": "subnet-b8de0ddd",
      "InstanceProfileArn": "arn:aws:iam::123456789102:instance-profile/aws-opsworks-ec2-role",
      "InstanceType": "c3.large",
      "CreatedAt": "2015-02-24T21:29:33+00:00",
      "AmiId": "ami-9fc29baf",
      "SshHostDsaKeyFingerprint": "fc:87:95:c3:f5:e1:3b:9f:d2:06:6e:62:9a:35:27:e8",
      "Ec2InstanceId": "i-8d2dca80",
      "PublicDns": "ec2-192-0-2-1.us-west-2.compute.amazonaws.com",
      "SecurityGroupIds": [
        "sg-b022add5",
        "sg-b122add4"
      ],
      "Architecture": "x86_64",
      "RootDeviceType": "ebs",
      "InstallUpdatesOnBoot": true,
      "Os": "Amazon Linux 2014.09",
      "VirtualizationType": "paravirtual",
      "AvailabilityZone": "us-west-2a",
      "Hostname": "custom11",
      "PrivateIp": "10.31.39.158",
      "PublicIp": "192.0.2.0"
    }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Instances」を参照してください。

スタックのレイヤーについて説明するには

次の describe-layers コマンドは、指定されたスタック内のレイヤーについて説明します。

aws opsworks --region us-east-1 describe-layers --stack-id 38ee91e2-abdc-4208-a107-0b7168b3cc7a

出力:

{
  "Layers": [
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "db-master",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-DB-Master-Server"
          ],
          "Name": "MySQL",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client",
                  "mysql::server",
                  "dependencies",
                  "deploy::mysql"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version",
                  "deploy::mysql"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default",
                  "mysql::stop"
              ],
              "Deploy": [
                  "deploy::default",
                  "deploy::mysql"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [],
              "Configure": [],
              "Shutdown": [],
              "Deploy": []
          },
          "EnableAutoHealing": false,
          "LayerId": "41a20847-d594-4325-8447-171821916b73",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": "true",
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": "*****FILTERED*****",
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "db-master",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:11:19+00:00",
          "VolumeConfigurations": [
              {
                  "MountPoint": "/vol/mysql",
                  "Size": 10,
                  "NumberOfDisks": 1
              }
          ]
      },
      {
          "StackId": "38ee91e2-abdc-4208-a107-0b7168b3cc7a",
          "Type": "custom",
          "DefaultSecurityGroupNames": [
              "AWS-OpsWorks-Custom-Server"
          ],
          "Name": "TomCustom",
          "Packages": [],
          "DefaultRecipes": {
              "Undeploy": [],
              "Setup": [
                  "opsworks_initial_setup",
                  "ssh_host_keys",
                  "ssh_users",
                  "mysql::client",
                  "dependencies",
                  "ebs",
                  "opsworks_ganglia::client"
              ],
              "Configure": [
                  "opsworks_ganglia::configure-client",
                  "ssh_users",
                  "agent_version"
              ],
              "Shutdown": [
                  "opsworks_shutdown::default"
              ],
              "Deploy": [
                  "deploy::default"
              ]
          },
          "CustomRecipes": {
              "Undeploy": [],
              "Setup": [
                  "tomcat::setup"
              ],
              "Configure": [
                  "tomcat::configure"
              ],
              "Shutdown": [],
              "Deploy": [
                  "tomcat::deploy"
              ]
          },
          "EnableAutoHealing": true,
          "LayerId": "e6cbcd29-d223-40fc-8243-2eb213377440",
          "Attributes": {
              "MysqlRootPasswordUbiquitous": null,
              "RubygemsVersion": null,
              "RailsStack": null,
              "HaproxyHealthCheckMethod": null,
              "RubyVersion": null,
              "BundlerVersion": null,
              "HaproxyStatsPassword": null,
              "PassengerVersion": null,
              "MemcachedMemory": null,
              "EnableHaproxyStats": null,
              "ManageBundler": null,
              "NodejsVersion": null,
              "HaproxyHealthCheckUrl": null,
              "MysqlRootPassword": null,
              "GangliaPassword": null,
              "GangliaUser": null,
              "HaproxyStatsUrl": null,
              "GangliaUrl": null,
              "HaproxyStatsUser": null
          },
          "Shortname": "tomcustom",
          "AutoAssignElasticIps": false,
          "CustomSecurityGroupIds": [],
          "CreatedAt": "2013-07-25T18:12:53+00:00",
          "VolumeConfigurations": []
      }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Layers」を参照してください。

レイヤーの負荷ベースのスケーリング設定について説明するには

次の例では、指定されたレイヤーの負荷ベースのスケーリング設定について説明します。レイヤーは、レイヤー ID によって識別されます。この ID は、レイヤーの詳細ページで、または describe-layers を実行して確認できます。

aws opsworks describe-load-based-auto-scaling --region us-east-1 --layer-ids 6bec29c9-c866-41a0-aba5-fa3e374ce2a1

出力: サンプルレイヤーには 1 つのロードベースのインスタンスがあります。

{
  "LoadBasedAutoScalingConfigurations": [
    {
      "DownScaling": {
        "IgnoreMetricsTime": 10,
        "ThresholdsWaitTime": 10,
        "InstanceCount": 1,
        "CpuThreshold": 30.0
      },
      "Enable": true,
      "UpScaling": {
        "IgnoreMetricsTime": 5,
        "ThresholdsWaitTime": 5,
        "InstanceCount": 1,
        "CpuThreshold": 80.0
      },
      "LayerId": "6bec29c9-c866-41a0-aba5-fa3e374ce2a1"
    }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「How Automatic Load-based Scaling Works」を参照してください。

ユーザーのプロファイルを取得するには

次の例は、 コマンドを実行している AWS Identity and Access Management (IAM) ユーザーのプロファイルを取得する方法を示しています。

aws opsworks --region us-east-1 describe-my-user-profile

出力: 簡潔にするために、ユーザーの SSH パブリックキーのほとんどは省略記号 (...) に置き換えられています。

{
  "UserProfile": {
    "IamUserArn": "arn:aws:iam::123456789012:user/myusername",
    "SshPublicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQ...3LQ4aX9jpxQw== rsa-key-20141104",
    "Name": "myusername",
    "SshUsername": "myusername"
  }
}

詳細情報

詳細については、「 AWS OpsWorks AWS ユーザーガイド」のOpsWorks へのユーザーのインポート」を参照してください。

ユーザーのスタックごとの AWS OpsWorks アクセス許可レベルを取得するには

次の例は、指定されたスタックで AWS Identity and Access Management (IAM) ユーザーのアクセス許可レベルを取得する方法を示しています。

aws opsworks --region us-east-1 describe-permissions --iam-user-arn arn:aws:iam::123456789012:user/cli-user-test --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

出力:

{
  "Permissions": [
    {
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "IamUserArn": "arn:aws:iam::123456789012:user/cli-user-test",
      "Level": "manage",
      "AllowSudo": true,
      "AllowSsh": true
    }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Granting Per-Stack Permissions Levels」を参照してください。

RAID 配列について説明するには

次の例では、指定されたスタックのインスタンスにアタッチされた RAID 配列について説明します。

aws opsworks --region us-east-1 describe-raid-arrays --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

出力: 1 つの RAID 配列を持つスタックの出力を次に示します。

{
  "RaidArrays": [
    {
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "AvailabilityZone": "us-west-2a",
      "Name": "Created for php-app1",
      "NumberOfDisks": 2,
      "InstanceId": "9f14adbc-ced5-43b6-bf01-e7d0db6cf2f7",
      "RaidLevel": 0,
      "VolumeType": "standard",
      "RaidArrayId": "f2d4e470-5972-4676-b1b8-bae41ec3e51c",
      "Device": "/dev/md0",
      "MountPoint": "/mnt/workspace",
      "CreatedAt": "2015-02-26T23:53:09+00:00",
      "Size": 100
    }
  ]
}

詳細については、「AWS OpsWorks User Guide」の「EBS Volumes」を参照してください。

スタックの登録済み Amazon RDS インスタンスについて説明するには

次の例では、指定されたスタックに登録された Amazon RDS インスタンスについて説明します。

aws opsworks --region us-east-1 describe-rds-db-instances --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06

出力: 1 つの登録済み RDS インスタンスを持つスタックの出力を次に示します。

{
  "RdsDbInstances": [
    {
      "Engine": "mysql",
      "StackId": "d72553d4-8727-448c-9b00-f024f0ba1b06",
      "MissingOnRds": false,
      "Region": "us-west-2",
      "RdsDbInstanceArn": "arn:aws:rds:us-west-2:123456789012:db:clitestdb",
      "DbPassword": "*****FILTERED*****",
      "Address": "clitestdb.cdlqlk5uwd0k.us-west-2.rds.amazonaws.com",
      "DbUser": "cliuser",
      "DbInstanceIdentifier": "clitestdb"
    }
  ]
}

詳細については、「AWS OpsWorks User Guide」の「Resource Management」を参照してください。

スタックのプロビジョニングパラメータを返すには

次の describe-stack-provisioning-parameters の例では、指定されたスタックのプロビジョニングパラメータを返します。プロビジョニングパラメータには、エージェントのインストール場所や OpsWorks がスタック内のインスタンスでエージェントを管理するために使用されるパブリックキーなどの設定が含まれます。

aws opsworks describe-stack-provisioning-parameters \
    --stack-id 62744d97-6faf-4ecb-969b-a086fEXAMPLE

出力:

{
    "AgentInstallerUrl": "https://opsworks-instance-agent-us-west-2.s3.amazonaws.com/ID_number/opsworks-agent-installer.tgz",
    "Parameters": {
        "agent_installer_base_url": "https://opsworks-instance-agent-us-west-2.s3.amazonaws.com",
        "agent_installer_tgz": "opsworks-agent-installer.tgz",
        "assets_download_bucket": "opsworks-instance-assets-us-west-2.s3.amazonaws.com",
        "charlie_public_key": "-----BEGIN PUBLIC KEY-----PUBLIC_KEY_EXAMPLE\n-----END PUBLIC KEY-----",
        "instance_service_endpoint": "opsworks-instance-service.us-west-2.amazonaws.com",
        "instance_service_port": "443",
        "instance_service_region": "us-west-2",
        "instance_service_ssl_verify_peer": "true",
        "instance_service_use_ssl": "true",
        "ops_works_endpoint": "opsworks.us-west-2.amazonaws.com",
        "ops_works_port": "443",
        "ops_works_region": "us-west-2",
        "ops_works_ssl_verify_peer": "true",
        "ops_works_use_ssl": "true",
        "verbose": "false",
        "wait_between_runs": "30"
    }
}

詳細については、「AWS OpsWorks User Guide」の「Run Stack Commands」を参照してください。

スタックの設定について説明するには

次の describe-stack-summary コマンドは、指定されたスタックの設定の概要を返します。

aws opsworks --region us-east-1 describe-stack-summary --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

出力:

{
  "StackSummary": {
    "StackId": "8c428b08-a1a1-46ce-a5f8-feddc43771b8",
    "InstancesCount": {
      "Booting": 1
    },
    "Name": "CLITest",
    "AppsCount": 1,
    "LayersCount": 1,
    "Arn": "arn:aws:opsworks:us-west-2:123456789012:stack/8c428b08-a1a1-46ce-a5f8-feddc43771b8/"
  }
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Stacks」を参照してください。

スタックについて説明するには

次の describe-stacks コマンドでは、アカウントのスタックについて説明します。

aws opsworks --region us-east-1 describe-stacks

出力:

{
  "Stacks": [
    {
      "ServiceRoleArn": "arn:aws:iam::444455556666:role/aws-opsworks-service-role",
      "StackId": "aeb7523e-7c8b-49d4-b866-03aae9d4fbcb",
      "DefaultRootDeviceType": "instance-store",
      "Name": "TomStack-sd",
      "ConfigurationManager": {
        "Version": "11.4",
        "Name": "Chef"
      },
      "UseCustomCookbooks": true,
      "CustomJson": "{\n  \"tomcat\": {\n    \"base_version\": 7,\n    \"java_opts\": \"-Djava.awt.headless=true -Xmx256m\"\n  },\n  \"datasources\": {\n    \"ROOT\": \"jdbc/mydb\"\n  }\n}",
      "Region": "us-east-1",
      "DefaultInstanceProfileArn": "arn:aws:iam::444455556666:instance-profile/aws-opsworks-ec2-role",
      "CustomCookbooksSource": {
        "Url": "git://github.com/example-repo/tomcustom.git",
        "Type": "git"
      },
      "DefaultAvailabilityZone": "us-east-1a",
      "HostnameTheme": "Layer_Dependent",
      "Attributes": {
        "Color": "rgb(45, 114, 184)"
      },
      "DefaultOs": "Amazon Linux",
      "CreatedAt": "2013-08-01T22:53:42+00:00"
    },
    {
      "ServiceRoleArn": "arn:aws:iam::444455556666:role/aws-opsworks-service-role",
      "StackId": "40738975-da59-4c5b-9789-3e422f2cf099",
      "DefaultRootDeviceType": "instance-store",
      "Name": "MyStack",
      "ConfigurationManager": {
        "Version": "11.4",
        "Name": "Chef"
      },
      "UseCustomCookbooks": false,
      "Region": "us-east-1",
      "DefaultInstanceProfileArn": "arn:aws:iam::444455556666:instance-profile/aws-opsworks-ec2-role",
      "CustomCookbooksSource": {},
      "DefaultAvailabilityZone": "us-east-1a",
      "HostnameTheme": "Layer_Dependent",
      "Attributes": {
        "Color": "rgb(45, 114, 184)"
      },
      "DefaultOs": "Amazon Linux",
      "CreatedAt": "2013-10-25T19:24:30+00:00"
    }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Stacks」を参照してください。

インスタンスの時間ベースのスケーリング設定について説明するには

次の例では、指定されたインスタンスの時間ベースのスケーリング設定について説明します。インスタンスはインスタンス ID で識別されます。この ID は、インスタンスの詳細ページで、または describe-instances を実行して確認できます。

aws opsworks describe-time-based-auto-scaling --region us-east-1 --instance-ids 701f2ffe-5d8e-4187-b140-77b75f55de8d

出力: この例では、単一の時間ベースのインスタンスがあります。

{
  "TimeBasedAutoScalingConfigurations": [
   {
      "InstanceId": "701f2ffe-5d8e-4187-b140-77b75f55de8d",
      "AutoScalingSchedule": {
        "Monday": {
          "11": "on",
          "10": "on",
          "13": "on",
          "12": "on"
        },
        "Tuesday": {
          "11": "on",
          "10": "on",
          "13": "on",
          "12": "on"
        }
      }
    }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「How Automatic Time-based Scaling Works」を参照してください。

ユーザープロファイルについて説明するには

次の describe-user-profiles コマンドでは、アカウントのユーザープロファイルについて説明します。

aws opsworks --region us-east-1 describe-user-profiles

出力:

{
  "UserProfiles": [
    {
      "IamUserArn": "arn:aws:iam::123456789012:user/someuser",
      "SshPublicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAQEAkOuP7i80q3Cko...",
      "AllowSelfManagement": true,
      "Name": "someuser",
      "SshUsername": "someuser"
    },
    {
      "IamUserArn": "arn:aws:iam::123456789012:user/cli-user-test",
      "AllowSelfManagement": true,
      "Name": "cli-user-test",
      "SshUsername": "myusername"
    }
  ]
}

詳細情報

詳細については、 AWS 「 OpsWorks AWS ユーザーガイド」のOpsWorks ユーザーの管理」を参照してください。

スタックのボリュームについて説明するには

次の例では、スタックの EBS ボリュームについて説明します。

aws opsworks --region us-east-1 describe-volumes --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

出力:

{
  "Volumes": [
    {
      "Status": "in-use",
      "AvailabilityZone": "us-west-2a",
      "Name": "CLITest",
      "InstanceId": "dfe18b02-5327-493d-91a4-c5c0c448927f",
      "VolumeType": "standard",
      "VolumeId": "56b66fbd-e1a1-4aff-9227-70f77118d4c5",
      "Device": "/dev/sdi",
      "Ec2VolumeId": "vol-295c1638",
      "MountPoint": "/mnt/myvolume",
      "Size": 1
    }
  ]
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Resource Management」を参照してください。

レイヤーからロードバランサーをデタッチするには

次の例では、名前で識別されるロードバランサーをレイヤーからデタッチします。

aws opsworks --region us-east-1 detach-elastic-load-balancer --elastic-load-balancer-name Java-LB --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Elastic Load Balancing」を参照してください。

インスタンスから Elastic IP アドレスの関連付けを解除するには

次の例では、指定されたインスタンスから Elastic IP アドレスの関連付けを解除します。

aws opsworks --region us-east-1 disassociate-elastic-ip --elastic-ip 54.148.130.96

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Resource Management」を参照してください。

レイヤーの次のホスト名を取得するには

次の例では、指定されたレイヤーに対して次に生成されたホスト名を取得します。この例で使用されるレイヤーは、1 つのインスタンスを持つ Java Application Server レイヤーです。スタックのホスト名テーマは、デフォルトの Layer_Dependent です。

aws opsworks --region us-east-1 get-hostname-suggestion --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4

出力:

{
  "Hostname": "java-app2",
  "LayerId": "888c5645-09a5-4d0e-95a8-812ef1db76a4"
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Create a New Stack」を参照してください。

インスタンスを再起動するには

次の例では、インスタンスを再起動します。

aws opsworks --region us-east-1 reboot-instance --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Rebooting an Instance」を参照してください。

スタックに Elastic IP アドレスを登録するには

次の例では、IP アドレスで識別される Elastic IP アドレスを、指定されたスタックに登録します。

注: Elastic IP アドレスは、スタックと同じリージョンにある必要があります。

aws opsworks register-elastic-ip --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --elastic-ip 54.148.130.96

出力

{
  "ElasticIp": "54.148.130.96"
}

詳細情報

詳細については、「OpsWorks User Guide」の「Registering Elastic IP Addresses with a Stack」を参照してください。

スタックに Amazon RDS インスタンスを登録するには

次の例では、Amazon リソースネーム (ARN) で識別される Amazon RDS DB インスタンスを指定されたスタックに登録します。また、インスタンスのマスターユーザー名とパスワードも指定します。 AWS OpsWorks はこれらの値を検証しないことに注意してください。どちらかが正しくない場合、アプリケーションはデータベースに接続できません。

aws opsworks register-rds-db-instance --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --rds-db-instance-arn arn:aws:rds:us-west-2:123456789012:db:clitestdb  --db-user cliuser --db-password some23!pwd

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Registering Amazon RDS Instances with a Stack」を参照してください。

スタックに Amazon EBS ボリュームを登録するには

次の例では、ボリューム ID で識別される Amazon EBS ボリュームを、指定されたスタックに登録します。

aws opsworks register-volume --region us-east-1 --stack-id d72553d4-8727-448c-9b00-f024f0ba1b06 --ec-2-volume-id vol-295c1638

出力:

{
  "VolumeId": "ee08039c-7cb7-469f-be10-40fb7f0c05e8"
}

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Registering Amazon EBS Volumes with a Stack」を参照してください。

スタックにインスタンスを登録するには

次の例は、 AWS Opsworks の外部で作成されたスタックにインスタンスを登録するさまざまな方法を示しています。登録するインスタンスまたは別のワークステーションから、register を実行できます。詳細については、「AWS OpsWorks User Guide」の「Registering Amazon EC2 and On-premises Instances」を参照してください。

注: 簡潔にするために、例では region 引数を省略します。

Amazon EC2 インスタンスを登録するには

EC2 インスタンスを登録することを示すには、引数 --infrastructure-class を ec2 に設定します。

次の例では、別のワークステーションから、指定されたスタックに EC2 インスタンスを登録します。インスタンスは EC2 ID i-12345678 によって識別されます。この例では、ワークステーションのデフォルトの SSH ユーザー名を使用し、デフォルトのプライベート SSH キーなど、パスワードを必要としない認証手法を使用してインスタンスへのログインを試みます。これが失敗した場合、register はパスワードのクエリを実行します。

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb i-12345678

次の例では、別のワークステーションから、指定されたスタックに EC2 インスタンスを登録します。--ssh-username および --ssh-private-key 引数を使用して、コマンドがインスタンスへのログインに使用する SSH ユーザー名とプライベートキーファイルを明示的に指定します。ec2-user は Amazon Linux インスタンスの標準ユーザー名です。Ubuntu インスタンスには ubuntu を使用します。

aws opsworks register --infrastructure-class=ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username ec2-user --ssh-private-key ssh_private_key i-12345678

次の例では、register コマンドを実行している EC2 インスタンスを登録します。SSH を使用してインスタンスにログインし、インスタンス ID またはホスト名の代わりに引数 --local で register を実行します。

aws opsworks register --infrastructure-class ec2 --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

オンプレミスインスタンスを登録するには

オンプレミスインスタンスを登録することを示すには、引数 --infrastructure-class を on-premises に設定します。

次の例では、別のワークステーションから、指定されたスタックに既存のオンプレミスインスタンスを登録します。インスタンスは、その IP アドレス 192.0.2.3 によって識別されます。この例では、ワークステーションのデフォルトの SSH ユーザー名を使用し、デフォルトのプライベート SSH キーなど、パスワードを必要としない認証手法を使用してインスタンスへのログインを試みます。これが失敗した場合、register はパスワードのクエリを実行します。

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb 192.0.2.3

次の例では、別のワークステーションから、指定されたスタックにオンプレミスインスタンスを登録します。インスタンスはホスト名 host1 で識別されます。--override-... 引数は direct AWS OpsWorks に、それぞれホスト名webserver1として、192.0.2.3およびインスタンスのパブリック IP アドレスとプライベート IP アドレス10.0.0.2として表示されます。

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-hostname webserver1 --override-public-ip 192.0.2.3 --override-private-ip 10.0.0.2 host1

次の例では、別のワークステーションから、指定されたスタックにオンプレミスインスタンスを登録します。インスタンスは IP アドレスによって識別されます。register は、指定された SSH ユーザー名とプライベートキーファイルを使用してインスタンスにログインします。

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --ssh-username admin --ssh-private-key ssh_private_key 192.0.2.3

次の例では、別のワークステーションから、指定されたスタックに既存のオンプレミスインスタンスを登録します。コマンドは、SSH パスワードとインスタンスの IP アドレスを指定するカスタム SSH コマンド文字列を使用してインスタンスにログインします。

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --override-ssh "sshpass -p 'mypassword' ssh your-user@192.0.2.3"

次の例では、register コマンドを実行しているオンプレミスインスタンスを登録します。SSH を使用してインスタンスにログインし、インスタンス ID またはホスト名の代わりに引数 --local で register を実行します。

aws opsworks register --infrastructure-class on-premises --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --local

出力: EC2 インスタンスを登録するための一般的な出力は次のとおりです。

Warning: Permanently added '52.11.41.206' (ECDSA) to the list of known hosts.
% Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                               Dload  Upload   Total   Spent    Left  Speed
100 6403k  100 6403k    0     0  2121k      0  0:00:03  0:00:03 --:--:-- 2121k
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Initializing AWS OpsWorks environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on Ubuntu
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Checking if OS is supported
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Running on supported OS
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Setup motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: ln -sf --backup /etc/motd.opsworks-static /etc/motd
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Enabling multiverse repositories
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Customizing APT environment
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Installing system packages
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing: dpkg --configure -a
[Tue, 24 Feb 2015 20:48:37 +0000] opsworks-init: Executing with retry: apt-get update
[Tue, 24 Feb 2015 20:49:13 +0000] opsworks-init: Executing: apt-get install -y ruby ruby-dev libicu-dev libssl-dev libxslt-dev libxml2-dev libyaml-dev monit
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Using assets bucket from environment: 'opsworks-instance-assets-us-east-1.s3.amazonaws.com'.
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Installing Ruby for the agent
[Tue, 24 Feb 2015 20:50:13 +0000] opsworks-init: Executing: /tmp/opsworks-agent-installer.YgGq8wF3UUre6yDy/opsworks-agent-installer/opsworks-agent/bin/installer_wrapper.sh -r -R opsworks-instance-assets-us-east-1.s3.amazonaws.com
[Tue, 24 Feb 2015 20:50:44 +0000] opsworks-init: Starting the installer
Instance successfully registered. Instance ID: 4d6d1710-ded9-42a1-b08e-b043ad7af1e2
Connection to 52.11.41.206 closed.

詳細情報

詳細については、 AWS 「 OpsWorks AWS ユーザーガイド」の「OpsWorks スタックへのインスタンスの登録 OpsWorks」を参照してください。

レイヤーの負荷ベースのスケーリング設定を指定するには

次の例では、指定されたレイヤーの負荷ベースのスケーリングを有効にし、そのレイヤーの設定を指定します。レイヤーに負荷ベースのインスタンスを追加するには、create-instance を使用する必要があります。

aws opsworks --region us-east-1 set-load-based-auto-scaling --layer-id 523569ae-2faf-47ac-b39e-f4c4b381f36d --enable --up-scaling file://upscale.json --down-scaling file://downscale.json

この例では、アップスケーリングのしきい値設定を、upscale.json という名前の作業ディレクトリの別のファイルに配置します。これには以下が含まれます。

{
  "InstanceCount": 2,
  "ThresholdsWaitTime": 3,
  "IgnoreMetricsTime": 3,
  "CpuThreshold": 85,
  "MemoryThreshold": 85,
  "LoadThreshold": 85
}

この例では、ダウンスケーリングのしきい値設定を、downscale.json という名前の作業ディレクトリの別のファイルに配置します。これには以下が含まれます。

{
"InstanceCount": 2,
"ThresholdsWaitTime": 3,
"IgnoreMetricsTime": 3,
"CpuThreshold": 35,
"MemoryThreshold": 30,
"LoadThreshold": 30
}

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Using Automatic Load-based Scaling」を参照してください。

stack AWS OpsWorks ごとのアクセス許可レベルを付与するには

を呼び出して AWS Identity and Access Management (IAM) ユーザーを AWS OpsWorks にインポートするとcreate-user-profile、ユーザーはアタッチされた IAM ポリシーによって付与されたアクセス許可のみを持ちます。ユーザーのポリシーを変更することで、 AWS OpsWorks アクセス許可を付与できます。ただし、多くの場合、ユーザーをインポートし、set-permission コマンドを使用して、ユーザーがアクセスする必要があるスタックごとに、標準のアクセス許可レベルの 1 つをユーザーに付与する方が簡単です。

次の例では、Amazon リソースネーム (ARN) で識別されるユーザーに、指定されたスタックに対するアクセス許可を付与します。この例では、スタックのインスタンスに対する sudo および SSH 権限を使用して、アクセス許可の管理レベルをユーザーに付与します。

aws opsworks set-permission --region us-east-1 --stack-id 71c7ca72-55ae-4b6a-8ee1-a8dcded3fa0f --level manage  --iam-user-arn arn:aws:iam::123456789102:user/cli-user-test --allow-ssh --allow-sudo

出力: なし。

詳細情報

詳細については、 AWS 「 OpsWorks AWS ユーザーガイド」の「スタックごとのアクセス許可の付与 OpsWorks」を参照してください。

レイヤーの時間ベースのスケーリング設定を指定するには

次の例では、指定されたインスタンスの時間ベースの設定を指定します。最初に create-instance を使用して、レイヤーにインスタンスを追加する必要があります。

aws opsworks --region us-east-1 set-time-based-auto-scaling --instance-id 69b6237c-08c0-4edb-a6af-78f3d01cedf2 --auto-scaling-schedule file://schedule.json

この例では、schedule.json という名前の作業ディレクトリ内の別のファイルにスケジュールを配置します。この例では、インスタンスは月曜日と火曜日の正午 UTC (協定世界時) 前後に数時間オンになっています。

{
  "Monday": {
    "10": "on",
    "11": "on",
    "12": "on",
    "13": "on"
  },
  "Tuesday": {
    "10": "on",
    "11": "on",
    "12": "on",
    "13": "on"
  }
}

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Using Automatic Time-based Scaling」を参照してください。

インスタンスを起動するには

次の start-instance コマンドは、指定された 24/7 インスタンスを開始します。

aws opsworks start-instance --instance-id f705ee48-9000-4890-8bd3-20eb05825aaf

出力: なし。describe-instances を使用して、インスタンスのステータスを確認します。

ヒント start-stack を呼び出すことで、1 つのコマンドでスタック内のすべてのオフラインインスタンスを開始できます。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Manually Starting, Stopping, and Rebooting 24/7 Instances」を参照してください。

スタックのインスタンスを開始するには

次の例では、スタックのすべての 24/7 インスタンスを開始します。特定のインスタンスを開始するには、start-instance を使用します。

aws opsworks --region us-east-1 start-stack --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Starting an Instance」を参照してください。

インスタンスを停止するには

次の例では、インスタンス ID で識別される、指定されたインスタンスを停止します。インスタンス ID を取得するには、 AWS OpsWorks コンソールのインスタンスの詳細ページに移動するか、 describe-instances コマンドを実行します。

aws opsworks stop-instance --region us-east-1 --instance-id 3a21cfac-4a1f-4ce2-a921-b2cfba6f7771

停止したインスタンスを再起動するには、start-instance を呼び出すか、delete-instance を呼び出してインスタンスを削除します。

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Stopping an Instance」を参照してください。

スタックのインスタンスを停止するには

次の例では、スタックの 24/7 インスタンスをすべて停止します。特定のインスタンスを停止するには、stop-instance を使用します。

aws opsworks --region us-east-1 stop-stack --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8

出力: 出力なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Stopping an Instance」を参照してください。

登録されたインスタンスの割り当てをそのレイヤーから解除するには

次の unassign-instance コマンドは、アタッチされたレイヤーからインスタンスの割り当てを解除します。

aws opsworks --region us-east-1 unassign-instance --instance-id 4d6d1710-ded9-42a1-b08e-b043ad7af1e2

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Unassigning a Registered Instance」を参照してください。

インスタンスからボリュームの割り当てを解除するには

次の例では、登録済みの Amazon Elastic Block Store (Amazon EBS) ボリュームをインスタンスから割り当て解除します。ボリュームはボリューム ID によって識別されます。ボリューム ID は、Amazon Elastic Compute Cloud (Amazon EC2) ボリューム ID ではなく、スタックにボリュームを登録するときに AWS OpsWorks が割り当てる GUID です。

aws opsworks --region us-east-1 unassign-volume --volume-id 8430177d-52b7-4948-9c62-e195af4703df

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Unassigning Amazon EBS Volumes」を参照してください。

アプリケーションを更新するには

次の例では、指定されたアプリケーションを更新して名前を変更します。

aws opsworks --region us-east-1 update-app --app-id 26a61ead-d201-47e3-b55c-2a7c666942f8 --name NewAppName

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Editing Apps」を参照してください。

Elastic IP アドレス名を更新するには

次の例では、指定された Elastic IP アドレスの名前を更新します。

aws opsworks --region us-east-1 update-elastic-ip --elastic-ip 54.148.130.96 --name NewIPName

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Resource Management」を参照してください。

インスタンスを更新するには

次の例では、指定されたインスタンスのタイプを更新します。

aws opsworks --region us-east-1 update-instance --instance-id dfe18b02-5327-493d-91a4-c5c0c448927f --instance-type c3.xlarge

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Editing the Instance Configuration」を参照してください。

レイヤーを更新するには

次の例では、Amazon EBS 最適化インスタンスを使用するように指定されたレイヤーを更新します。

aws opsworks --region us-east-1 update-layer --layer-id 888c5645-09a5-4d0e-95a8-812ef1db76a4 --use-ebs-optimized-instances

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Editing an OpsWorks Layer's Configuration」を参照してください。

ユーザーのプロファイルを更新するには

次の例では、指定された SSH パブリックキーを使用するように development ユーザーのプロファイルを更新します。ユーザーの AWS 認証情報は、 credentials ファイル (~\.aws\credentials) の developmentプロファイルで表され、キーは作業ディレクトリの .pem ファイルにあります。

aws opsworks --region us-east-1 --profile development update-my-user-profile --ssh-public-key file://development_key.pem

出力: なし。

詳細情報

詳細については、 AWS 「 OpsWorks ユーザーガイド」の「AWS EditingOpsWorks User Settings」を参照してください。

登録済みの Amazon RDS DB インスタンスを更新するには

次の例では、Amazon RDS インスタンスのマスターパスワード値を更新します。このコマンドでは、RDS インスタンスのマスターパスワードは変更されず、 AWS OpsWorks に提供するパスワードのみが変更されることに注意してください。このパスワードが RDS インスタンスのパスワードと一致しない場合、アプリケーションはデータベースに接続できません。

aws opsworks --region us-east-1 update-rds-db-instance --db-password 123456789

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Registering Amazon RDS Instances with a Stack」を参照してください。

登録済みボリュームを更新するには

次の例では、登録済みの Amazon Elastic Block Store (Amazon EBS) ボリュームのマウントポイントを更新します。ボリュームはボリューム ID によって識別されます。ボリューム ID は、Amazon Elastic Compute Cloud (Amazon EC2) ボリューム ID ではなく、スタックに登録するときに AWS OpsWorks がボリュームに割り当てる GUID です。

aws opsworks --region us-east-1 update-volume --volume-id 8430177d-52b7-4948-9c62-e195af4703df --mount-point /mnt/myvol

出力: なし。

詳細情報

詳細については、「AWS OpsWorks User Guide」の「Assigning Amazon EBS Volumes to an Instance」を参照してください。