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 「 ユーザーガイド」の「登録済みインスタンスのレイヤーへの割り当て」を参照してください。

登録済みボリュームをインスタンスに割り当てるには

次の例では、登録済みの Amazon Elastic Block Store (Amazon EBS) ボリュームをインスタンスに割り当てます。ボリュームはボリューム ID によって識別GUIDされます。ボリューム ID は、Amazon Elastic Compute Cloud (Amazon EC2) ボリューム ID ではなく、スタックにボリュームを登録するときに AWS OpsWorks が割り当てる です。を実行する前に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 「 ユーザーガイド」の「インスタンスへの Amazon EBSボリュームの割り当て」を参照してください。

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 「 ユーザーガイド」の「リソース管理」を参照してください。

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

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

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 「 ユーザーガイド」のElastic Load Balancing」を参照してください。

例 1: アプリを作成するには

次の例では、 GitHub リポジトリに保存されているコードimplePHPApp から S という名前の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 「 ユーザーガイド」の「アプリの追加」を参照してください。

例 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 「 ユーザーガイド」の「アプリケーションのデプロイ」を参照してください。

例 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 「 ユーザーガイド」の「スタックコマンドの実行」を参照してください。

例 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 「 ユーザーガイド」の「スタックコマンドの実行」を参照してください。

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

次の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 「 ユーザーガイド」の「レイヤーへのインスタンスの追加」を参照してください。

レイヤーを作成するには

次のcreate-layerコマンドは、指定されたスタックyPHPLayer に M という名前の 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 「 ユーザーガイド」の「レイヤーの作成方法」を参照してください。

サーバーを作成するには

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

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 「 Chef Automate APIリファレンス」のCreateServer「」を参照してください。

スタックを作成するには

次のcreate-stackコマンドは、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 リソースネーム (ARNs) を取得するには、IAMコンソールに移動し、ナビゲーションパネルRolesで を選択し、ロールまたはプロファイルを選択し、 Summaryタブを選択します。

出力:

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

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の「新しいスタックを作成する」を参照してください。

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

Identity AWS and Access Manager (IAM) ユーザーを にインポート AWS OpsWorks するには、 を呼び出し create-user-profileてユーザープロファイルを作成します。次の例では、Amazon リソースネーム () で識別されるIAMユーザーのユーザープロファイル cli-user-testを作成しますARN。この例では、ユーザーに の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 コマンドを使用して、スタックごとの 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 「 ユーザーガイド」の「アプリ」を参照してください。

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

次の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 「 ユーザーガイド」の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 OpsWorks 「インスタンスの削除」を参照してください。

スタックを削除する

次の例では、スタック 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 ユーザーガイドの「スタックのシャットダウン」を参照してください。

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

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

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 「 ユーザーガイド」の「Elastic IP アドレスの登録解除」を参照してください。

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

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

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

出力 : なし。

詳細情報

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

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

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

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 「 ユーザーガイド」の「Amazon RDS インスタンスの登録解除」を参照してください。

インスタンス ID: clitestdb Master usernams: cliuser Master PWD: some23!pwd DB 名: 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 によって識別GUIDされます。ボリューム ID は、ボリューム ID ではなく、スタックにボリュームを登録したときに AWS OpsWorks 割り当てられた EC2 です。

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

出力 : なし。

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の「Amazon EBS ボリュームの登録解除」を参照してください。

アプリを記述するには

次の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 「 ユーザーガイド」の「アプリ」を参照してください。

コマンドを記述するには

次の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 「 ユーザーガイド」の「アプリケーションのデプロイ」を参照してください。

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 ユーザーガイド」の「インスタンス」を参照してください。

スタックのエラスティックロードバランサーを記述するには

次の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 「 ユーザーガイド」の「アプリ」を参照してください。

インスタンスを記述するには

次の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 「 ユーザーガイド」の「インスタンス」を参照してください。

スタックのレイヤーを記述するには

次の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 「 ユーザーガイド」の「レイヤー」を参照してください。

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

次の例では、指定されたレイヤーの負荷ベースのスケーリング設定について説明します。レイヤーはレイヤー 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 ユーザーガイドの「自動ロードベースのスケーリングの仕組み」を参照してください。

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

次の例は、 コマンドを実行している 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 「 ユーザーガイド」の「スタックあたりのアクセス許可レベルの付与」を参照してください。

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 「 ユーザーガイド」のEBS「ボリューム」を参照してください。

スタックの登録済み 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 「 ユーザーガイド」の「リソース管理」を参照してください。

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

次の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 「 ユーザーガイド」の「スタックコマンドの実行」を参照してください。

スタックの設定を記述するには

次の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 「 ユーザーガイド」の「スタック」を参照してください。

スタックを記述するには

次の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 「 ユーザーガイド」の「スタック」を参照してください。

インスタンスの時間ベースのスケーリング設定を記述するには

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

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

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

{
  "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 ユーザーガイドの「自動時間ベースのスケーリングの仕組み」を参照してください。

ユーザープロファイルを記述するには

次の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 「 ユーザーガイド」の「リソース管理」を参照してください。

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

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

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 「 ユーザーガイド」のElastic Load Balancing」を参照してください。

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

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

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

出力 : なし。

詳細情報

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

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

次の例では、指定されたレイヤーに対して次に生成されたホスト名を取得します。この例に使用されるレイヤーは、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 「 ユーザーガイド」の「新しいスタックを作成する」を参照してください。

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

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

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

出力 : なし。

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の「インスタンスの再起動」を参照してください。

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 「 ユーザーガイド」の「スタックでの Elastic IP アドレスの登録」を参照してください。

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 「 ユーザーガイド」の「スタックでの Amazon RDS インスタンスの登録」を参照してください。

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

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

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 「 ユーザーガイド」の「Amazon EBS ボリュームをスタックに登録する」を参照してください。

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

次の例は、 AWS Opsworks の外部で作成されたスタックにインスタンスを登録するさまざまな方法を示しています。登録するインスタンスregisterから、または別のワークステーションから実行できます。詳細については、AWS OpsWorks 「 ユーザーガイド」の「Amazon インスタンスEC2とオンプレミスインスタンスの登録」を参照してください。

注: 簡潔にするために、例では 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-... 引数は、 をホスト名webserver1として、 192.0.2.3 をインスタンスのパブリック IP アドレスとプライベート IP アドレス10.0.0.2としてそれぞれ表示するように指示 AWS OpsWorksします。

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 アドレスによって識別されます。 は、指定されたSSHユーザー名とプライベートキーファイルを使用してインスタンスregisterにログインします。

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 「スタックでのインスタンスの登録」を参照してください。

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

次の例では、指定されたレイヤーの負荷ベースのスケーリングを有効にし、そのレイヤーの設定を設定します。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 ユーザーガイドの「自動ロードベースのスケーリングの使用」を参照してください。

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

を呼び出す AWS OpsWorks ことで AWS Identity and Access Management (IAM) ユーザーを にインポートする場合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 ユーザーガイドの「自動時間ベースのスケーリングの使用」を参照してください。

インスタンスを開始するには

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

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

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

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

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の「24/7 インスタンスの手動起動、停止、再起動」を参照してください。

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

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

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

出力 : なし。

詳細情報

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

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

次の例では、指定されたインスタンスを停止し、インスタンス 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 「 ユーザーガイド」の「インスタンスの停止」を参照してください。

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

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

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

出力 : 出力なし。

詳細情報

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

レイヤーから登録済みインスタンスの割り当てを解除するには

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

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

出力 : なし。

詳細情報

詳細については、 AWS OpsWorks ユーザーガイドの「登録済みインスタンスの割り当て解除」を参照してください。

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

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

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

出力 : なし。

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の「Amazon EBS ボリュームの割り当て解除」を参照してください。

アプリを更新するには

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

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

出力 : なし。

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の「アプリの編集」を参照してください。

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

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

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

出力 : なし。

詳細情報

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

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

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

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

出力 : なし。

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の「インスタンス設定の編集」を参照してください。

レイヤーを更新するには

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

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

出力 : なし。

詳細情報

詳細については、AWS OpsWorks 「 ユーザーガイド」の OpsWorks 「レイヤーの設定の編集」を参照してください。

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

次の例では、指定された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 OpsWorks ユーザーガイド」の「ユーザー設定の編集」を参照してください。

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

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

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

出力 : なし。

詳細情報

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

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

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

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

出力 : なし。

詳細情報

詳細については、 AWS OpsWorks ユーザーガイドの「インスタンスへの Amazon EBSボリュームの割り当て」を参照してください。