register-on-premises-instance コマンド (IAM ユーザー ARN) を使用してオンプレミスインスタンスを登録する

アクセス許可を割り当てるには (CLI）

1. を呼び出すために使用している Amazon EC2インスタンスまたはデバイスに、次のポリシーコンテンツを含むファイルを作成します AWS CLI。ファイルに CodeDeploy-OnPrem-Permissions.json のような名前を付けて、ファイルを保存します。

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

   注記

   このポリシーを、オンプレミスインスタンスがアクセスする必要のある Amazon S3 バケットにのみ制限することをお勧めします。このポリシーを制限する場合は、 AWS CodeDeploy エージェントを含む Amazon S3 バケットへのアクセスも許可してください。そうしないと、 CodeDeploy エージェントが関連するオンプレミスインスタンスにインストールまたは更新されるたびにエラーが発生する可能性があります。

   例:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource": [
           "arn:aws:s3:::amzn-s3-demo-bucket/*",
           "arn:aws:s3:::aws-codedeploy-us-east-2/*",
           "arn:aws:s3:::aws-codedeploy-us-east-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-2/*",
           "arn:aws:s3:::aws-codedeploy-ca-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-3/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-north-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-south-2/*",
           "arn:aws:s3:::aws-codedeploy-il-central-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-east-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",        
           "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-3/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-2/*",
           "arn:aws:s3:::aws-codedeploy-me-central-1/*",
           "arn:aws:s3:::aws-codedeploy-me-south-1/*",
           "arn:aws:s3:::aws-codedeploy-sa-east-1/*"
         ]
       }
     ]
   }

2. put-user-policy コマンドを呼び出し、IAMユーザーの名前 ( --user-nameオプションを使用）、ポリシーの名前 ( --policy-nameオプションを使用）、新しく作成されたポリシードキュメントへのパス ( --policy-documentオプションを使用) を指定します。例えば、CodeDeploy-OnPrem-Permissions.json というファイルが、コマンドを呼び出しているのと同じディレクトリ (フォルダ) にあるとします。

   重要

   ファイル名の前に必ず file:// を含めてください。このコマンドでは必須です。

   aws iam put-user-policy --user-name CodeDeployUser-OnPrem --policy-name CodeDeploy-OnPrem-Permissions --policy-document file://CodeDeploy-OnPrem-Permissions.json

アクセス権限を割り当てるには (コンソール)

1. でIAMコンソールを開きますhttps://console.aws.amazon.com/iam/。

2. ナビゲーションペインで、[Policies] を選択し、[Create Policy] を選択します。([Get Started] ボタンが表示された場合は、そのボタンを選択してから、[Create Policy] を選択します)。

3. [独自のポリシーを作成] の横で、[選択] を選択します。

4. [ポリシー名] ボックスに、このポリシーの名前を入力します (CodeDeploy-OnPrem-Permissions など)。

5. ポリシードキュメントボックスで、次のアクセス許可式を入力または貼り付けます。これにより、ポリシーで指定された Amazon S3 バケットから、IAMユーザーに代わってオンプレミスインスタンスにアプリケーションリビジョンをデプロイ AWS CodeDeploy できます。

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Action": [
                   "s3:Get*",
                   "s3:List*"
               ],
               "Effect": "Allow",
               "Resource": "*"
           }
       ]
   }

6. [ポリシーの作成] を選択します。

7. ナビゲーションペインで [Users (ユーザー)] を選択します。

8. ユーザーのリストで、 で作成したIAMユーザーの名前を参照して選択しますステップ 1: オンプレミスインスタンスのIAMユーザーを作成する。

9. [Permissions] タブを開き、[Managed Policies] で [Attach Policy] を選択します。

10. CodeDeploy-OnPrem-Permissions という名前のポリシーを選択した後、[ポリシーのアタッチ] を選択します。

認証情報を取得するには (CLI）

1. list-access-keys コマンドを呼び出し、IAMユーザーの名前を指定し ( --user-nameオプションを使用）、アクセスキーのみをクエリします IDs ( --query および --outputオプションを使用）。例:

   aws iam list-access-keys --user-name CodeDeployUser-OnPrem --query "AccessKeyMetadata[*].AccessKeyId" --output text

2. 出力にキーが表示されない場合、または出力に 1 つのキーのみが表示される場合は、 create-access-key コマンドを呼び出し、IAMユーザーの名前を指定します ( --user-nameオプションを使用）。

   aws iam create-access-key --user-name CodeDeployUser-OnPrem

   create-access-key コマンドを呼び出した出力で、AccessKeyId フィールドおよび SecretAccessKey フィールドの値をメモします。この情報は ステップ 4: オンプレミスインスタンスに設定ファイルを追加 で必要になります。

   重要

   このシークレットアクセスキーにアクセスできるのは、この時だけです。このシークレットアクセスキーを忘れた、またはアクセスできなくなった場合、ステップ 3: IAM ユーザー認証情報を取得する のステップに従い、新しいキーを生成する必要があります。

3. 2 つのアクセスキーが既にリストされている場合は、delete-access-keyコマンドを呼び出し、IAMユーザーの名前 ( --user-nameオプションを使用) と削除するアクセスキーの ID ( --access-key-idオプションを使用) を指定して、そのうちの 1 つを削除する必要があります。それから、このステップの前のほうにある説明のとおり、create-access-key コマンドを呼び出します。delete-access-key コマンドを呼び出す例は以下のとおりです。

   aws iam delete-access-key --user-name CodeDeployUser-OnPrem --access-key-id access-key-ID

   重要

   delete-access-key コマンドを呼び出してこれらのアクセスキーの 1 つを削除し、オンプレミスインスタンスが で説明されているようにこのアクセスキーを既に使用している場合はステップ 4: オンプレミスインスタンスに設定ファイルを追加、 の手順に従って、このIAMユーザーに関連付けられた別のアクセスキー ID とシークレットアクセスキーステップ 4: オンプレミスインスタンスに設定ファイルを追加を指定する必要があります。そうしない場合、そのオンプレミスインスタンスへのデプロイは、無期限の保留状態のまま、または完全にエラーとなる可能性があります。

認証情報を取得するには (コンソール)

1. 1. でIAMコンソールを開きますhttps://console.aws.amazon.com/iam/。

   2. ユーザーのリストがナビゲーションペインに表示されない場合は、[Users] を選択します。

   3. ユーザーのリストで、 で作成したIAMユーザーの名前を参照して選択しますステップ 1: オンプレミスインスタンスのIAMユーザーを作成する。

2. [Security credentials] タブにキーが表示されていない場合、または 1 つしか表示されていない場合は、[Create access key] を選択します。

   2 つのアクセスキーが表示されている場合は、片方を削除する必要があります。片方のアクセスキーの横にある [Delete] を選択した後、[Create access key] を選択します。

   重要

   これらのアクセスキーの 1 つの横にある削除を選択し、オンプレミスインスタンスが で説明されているようにこのアクセスキーを既に使用している場合はステップ 4: オンプレミスインスタンスに設定ファイルを追加、 の手順に従って、このIAMユーザーに関連付けられた別のアクセスキー ID とシークレットアクセスキーステップ 4: オンプレミスインスタンスに設定ファイルを追加を指定する必要があります。そうしない場合、そのオンプレミスインスタンスへのデプロイは、無期限の保留状態のまま、または完全にエラーとなる可能性があります。

3. [Show] を選択し、アクセスキー ID とシークレットアクセスキーをメモします。この情報は、次のステップで必要になります。または、[Download .csv file] を選択して、アクセスキー ID とシークレットアクセスキーのコピーを保存することができます。

   重要

   認証情報をメモする、または、ダウンロードするのでない限り、このシークレットアクセスキーにアクセスできるのは、この時だけです。このシークレットアクセスキーを忘れた、またはアクセスできなくなった場合、ステップ 3: IAM ユーザー認証情報を取得する のステップに従い、新しいキーを生成する必要があります。

4. 閉じるを選択してユーザーに戻る > IAM User Name ページ。

1. (Ubuntu Server またはRHELオンプレミスインスタンスcodedeploy.onpremises.ymlの場合) または conf.onpremises.yml (Windows Server オンプレミスインスタンスの場合) という名前のファイルを、オンプレミスインスタンスの次の場所に作成します。

   • Ubuntu サーバーの場合:/etc/codedeploy-agent/conf

   • Windows サーバーについて：C:\ProgramData\Amazon\CodeDeploy

2. テキストエディタを使用して、新しく作成した codedeploy.onpremises.yml または conf.onpremises.yml ファイルに次の情報を追加します。

   ---
   aws_access_key_id: secret-key-id
   aws_secret_access_key: secret-access-key
   iam_user_arn: iam-user-arn
   region: supported-region

   コードの説明は以下のとおりです。

   • secret-key-id は、 ステップ 1: オンプレミスインスタンスのIAMユーザーを作成するまたは でメモした対応するIAMユーザーのシークレットキー ID ですステップ 3: IAM ユーザー認証情報を取得する。

   • secret-access-key は、 ステップ 1: オンプレミスインスタンスのIAMユーザーを作成するまたは で指定した対応するIAMユーザーのシークレットアクセスキーですステップ 3: IAM ユーザー認証情報を取得する。

   • iam-user-arn は、先ほど でメモARNしたIAMユーザーのものですステップ 1: オンプレミスインスタンスのIAMユーザーを作成する。

   • supported-region は、 CodeDeploy アプリケーション、デプロイグループ、およびアプリケーションリビジョン CodeDeploy が配置されている ( など) でサポートされているリージョンの識別子ですus-west-2。リージョンのリストについては、「AWS 全般のリファレンス」の「リージョンエンドポイント」を参照してください。

   重要

   のアクセスキーの 1 つの横にある削除を選択しステップ 3: IAM ユーザー認証情報を取得する、オンプレミスインスタンスが既に関連付けられたアクセスキー ID とシークレットアクセスキーを使用している場合は、 の手順に従ってステップ 4: オンプレミスインスタンスに設定ファイルを追加、このIAMユーザーに関連付けられた別のアクセスキー ID とシークレットアクセスキーを指定する必要があります。そうしない場合、オンプレミスインスタンスへのデプロイは、無期限の保留状態のまま、または完全にエラーとなる可能性があります。

1. オンプレミスインスタンス AWS CLI に をインストールするには、AWS Command Line Interface 「 ユーザーガイド」の「 のセットアップ方法 AWS CLI」の指示に従います。

   注記

   CodeDeploy オンプレミスインスタンスを操作するための コマンドが、 のバージョン 1.7.19 で利用可能になりました AWS CLI。のバージョンが AWS CLI 既にインストールされている場合は、 を呼び出してそのバージョンを確認できますaws --version。

2. オンプレミスインスタンス AWS CLI で を設定するには、AWS Command Line Interface 「 ユーザーガイド」の「 の設定 AWS CLI」の手順に従います。

   重要

   （aws configureコマンドを呼び出す AWS CLI などして) を設定するときは、 で指定されたアクセス許可に加えて、少なくとも以下の AWS アクセス許可を持つIAMユーザーのシークレットキー ID とシークレットアクセスキーを必ず指定してくださいオンプレミスインスタンスを設定するための前提条件。これにより、オンプレミスインスタンスに CodeDeploy エージェントをダウンロードしてインストールできます。

   {
     "Version": "2012-10-17",
     "Statement" : [
       {
         "Effect" : "Allow",
         "Action" : [
           "codedeploy:*"
         ],
         "Resource" : "*"
       },
       {
         "Effect" : "Allow",
         "Action" : [
           "s3:Get*",
           "s3:List*"
         ],
         "Resource" : [
           "arn:aws:s3:::aws-codedeploy-us-east-2/*",
           "arn:aws:s3:::aws-codedeploy-us-east-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-1/*",
           "arn:aws:s3:::aws-codedeploy-us-west-2/*",
           "arn:aws:s3:::aws-codedeploy-ca-central-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-1/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-2/*",
           "arn:aws:s3:::aws-codedeploy-eu-west-3/*",
           "arn:aws:s3:::aws-codedeploy-eu-central-1/*",
           "arn:aws:s3:::aws-codedeploy-il-central-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-east-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-northeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-1/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-2/*",
           "arn:aws:s3:::aws-codedeploy-ap-southeast-4/*",
           "arn:aws:s3:::aws-codedeploy-ap-south-1/*",
           "arn:aws:s3:::aws-codedeploy-sa-east-1/*"
         ]
       }     
     ]
   }

   これらのアクセス許可は、 で作成したIAMユーザーに割り当てることも、別のIAMユーザーステップ 1: オンプレミスインスタンスのIAMユーザーを作成するに割り当てることもできます。これらのアクセス許可をIAMユーザーに割り当てるには、そのステップのアクセス許可ではなくステップ 1: オンプレミスインスタンスのIAMユーザーを作成する、これらのアクセス許可を使用して、「」の手順に従います。

1. を使用する前に AWS CLI、 で作成したユーザーのARNIAMユーザーが必要ですステップ 1: オンプレミスインスタンスのIAMユーザーを作成する。ユーザー をまだ持っていない場合はARN、get-user コマンドを呼び出し、IAMユーザーの名前を指定し ( --user-nameオプションを使用）、ユーザーのみをクエリします ARN ( --query および --outputオプションを使用）。

   aws iam get-user --user-name CodeDeployUser-OnPrem --query "User.Arn" --output text

2. register-on-premises-instance コマンドを呼び出して、以下を指定します。

   • オンプレミスインスタンスを一意に識別する名前 (--instance-name オプションで指定)。

     重要

     オンプレミスインスタンスを識別するために、特にデバッグのため、オンプレミスインスタンスの一意な特徴を示す名前 (例えば、もしあれば、シリアルナンバーや内部アセット識別子など) を指定することを強くお勧めします。MAC アドレスを名前として指定する場合は、MACアドレスにコロン () など、 CodeDeploy が許可しない文字が含まれていることに注意してください:。許可された文字の一覧については、「CodeDeploy クォータ」を参照してください。

   • で作成したARNIAMユーザーのユーザー ステップ 1: オンプレミスインスタンスのIAMユーザーを作成する ( --iam-user-arnオプションを使用）。

     例:

     aws deploy register-on-premises-instance --instance-name AssetTag12010298EX --iam-user-arn arn:aws:iam::444455556666:user/CodeDeployUser-OnPrem

オンプレミスインスタンスにタグを付けるには (CLI）

• add-tags-to-on-premises-instances コマンドを呼び出し、以下を指定します。

  • オンプレミスインスタンスを一意に識別する名前 (--instance-names オプションで指定)。

  • 使用するオンプレミスインスタンスのタグキーの名前とタグ値 (--tags オプションで指定)。name と value の両方を指定する必要があります。値のみを持つオンプレミスインスタンスタグは許可 CodeDeploy されません。

    例:

    aws deploy add-tags-to-on-premises-instances --instance-names AssetTag12010298EX --tags Key=Name,Value=CodeDeployDemo-OnPrem

オンプレミスインスタンスにタグ付けするには (コンソール)

1. にサインイン AWS Management Console し、https://console.aws.amazon.com/codedeploy で CodeDeploy コンソールを開きます。

   注記

   「の開始方法 CodeDeploy」で設定したのと同じユーザーでサインインします。

2. CodeDeploy メニューから、オンプレミスインスタンス を選択します。

3. オンプレミスインスタンスのリストで、タグ付けするオンプレミスインスタンスの横にある矢印を選択します。

4. タグのリストで、目的のタグキーとタグ値を選択または入力します。タグキーとタグ値を入力するたびに、別の行が表示されます。最大 10 個のタグにこれを繰り返すことができます。タグを削除するには、削除アイコンを選択します ( )。

5. タグを追加したら、[Update Tags] を選択します。