チュートリアル: CodePipeline を使用して Amazon EC2 インスタンスにデプロイする

インスタンスロールを作成するには

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

2. コンソールダッシュボードで [ロール] を選択します。

3. [ロールの作成] を選択してください。

4. [信頼されたエンティティのタイプを選択] で、[AWS のサービス ] を選択します。ユースケースの選択 で、EC2 を選択します。[Select your use case (ユースケースを選択)] で、[EC2] を選択します。[次へ] を選択します。

5. AmazonSSMManagedEC2InstanceDefaultPolicy という名前のマネージドポリシーを検索して選択します。

6. AmazonSSMManagedInstanceCore という名前のマネージドポリシーを検索して選択します。[Next: Tags (次へ: タグ)] を選択します。

7. [次へ: レビュー] を選択します。ロールの名前を入力します (例: EC2InstanceRole)。

   注記

   次のステップのロール名をメモしておきます。このロールは、インスタンスの作成時に選択します。

   注記

   このロールにアクセス許可を追加して、パイプラインの作成後にパイプラインの S3 アーティファクトバケットへのアクセスを許可します。

   [ロールの作成] を選択してください。

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

1. Amazon EC2 コンソールの https://console.aws.amazon.com/ec2/ を開いてください。

2. サイドナビゲーションから [インスタンス] を選択し、ページの上部から [インスタンスの起動] を選択します。

3. [名前] に「MyInstances」と入力します。これにより、インスタンスにはキーが Name で、値が MyInstances というタグがが割り当てられます。

4. アプリケーションイメージと OS イメージ (Amazon マシンイメージ） で、 AWS ロゴが付いた Amazon Linux AMI オプションを見つけ、選択されていることを確認します。(この AMI は Amazon Linux 2 AMI (HVM) と表記され、「無料利用枠対象」と表示されています。)

5. [インスタンスタイプ] で、インスタンスのハードウェア構成として無料利用枠対象となる t2.micro タイプを選択します。

6. [キーペア (ログイン)] で、キーペアを選択するか作成します。

7. ネットワーク設定で、ステータスが Enable であることを確認します。

8. [Advanced Details] (高度な詳細) を展開します。[IAM インスタンスプロファイル] で、前の手順で作成した IAM ロール (EC2InstanceRole など) を選択します。

   注記

   インスタンスロールを空白のままにしないでください。デフォルトのロールが作成され、作成したロールは選択されません。

9. 「概要」の「インスタンスの数」に「」と入力します2。

10. [インスタンスを起動] を選択します。

11. [インスタンス] ページで、起動のステータスを表示できます。インスタンスを起動すると、その初期状態は pending です。インスタンスを起動した後は、状態が running に変わり、パブリック DNS 名を受け取ります ([パブリック DNS] 列が表示されていない場合は、[表示/非表示] アイコンを選択してから、[パブリック DNS] を選択します)。

1. CodePipeline コンソールでパイプラインに移動します。[設定] を選択します。既存のパイプラインのアーティファクトストアの名前と場所を表示します。アーティファクトバケット Amazon リソースネーム (ARN) を書き留めてコピーします。

2. IAM コンソールに移動し、[ロール] を選択します。このチュートリアルのステップ 1 で作成したインスタンスロールを選択します。

3. [Permissions] (アクセス許可) タブで [Add inline policy] (インラインポリシーの追加) を選択します。

4. 次の JSON をポリシードキュメントに追加し、 Resourceフィールドの値をバケット ARN に置き換えます。

   {
       "Effect": "Allow",
       "Principal": "*",
       "Action": "s3:GetObject",
       "Resource": "arn:aws:s3:::BucketName"
   }

5. [更新] を選択します。

ソースリポジトリに script.sh ファイルを追加するには

1. テキストエディタを開き、上記のファイルをコピーして新しいファイルに貼り付けます。

2. ソースリポジトリに script.sh ファイルをコミットし、プッシュします。

   1. ファイルを追加します。

      git add .

   2. 変更をコミットします。

      git commit -m "Adding script.sh."

   3. コミットをプッシュします。

      git push

   リポジトリ内のパスを書き留めます。

   /MyDemoRepo/test/script.sh

パイプラインを作成するには

1. CodePipeline コンソール (https://console.aws.amazon.com/codepipeline/) を開きます。

2. [ようこそ] ページ、[開始方法] ページ、または [パイプライン] ページで、[パイプラインの作成] を選択します。

3. [ステップ 1: 作成オプションを選択する] ページの [作成オプション] で、[カスタムパイプラインを構築する] オプションを選択します。[次へ] を選択します。

4. [ステップ 2: パイプラインの設定を選択する] で、[パイプライン名] に「MyPipeline」と入力します。

5. CodePipeline は、特徴と料金が異なる V1 タイプと V2 タイプのパイプラインを提供しています。V2 タイプは、コンソールで選択できる唯一のタイプです。詳細については、「パイプラインタイプ」を参照してください。CodePipeline の料金については、料金を参照してください。

6. サービスロールで、既存のサービスロールを使用するを選択し、このアクションに必要なアクセス許可で更新された CodePipeline サービスロールを選択します。このアクション用に CodePipeline サービスロールを設定するには、「」を参照してくださいEC2 デプロイアクションのサービスロールポリシーのアクセス許可。

7. [詳細設定] をデフォルト設定のままにし、[次へ] を選択します。

8. [ステップ 3: ソースステージを追加する] ページで、ソースステージを追加します。

   1. ソースプロバイダーで、GitHub (GitHub GitHub アプリ経由) を選択します。

   2. 接続 で、既存の接続を選択するか、新規の接続を作成します。GitHub ソースアクション用の接続を作成または管理する方法については、GitHub コネクション を参照してください。

   3. リポジトリ名 で、GitHub リポジトリの名前を選択します。

   [次へ] を選択します。

9. ステップ 4: ビルドステージの追加ページで、スキップを選択します。

10. ステップ 5: デプロイステージの追加ページで、EC2 を選択します。

    

    1. Target ディレクトリには、 など、デプロイ先のインスタンスのディレクトリを入力します/home/ec2-user/testhelloworld。

       注記

       アクションがインスタンスで使用するデプロイディレクトリを指定します。アクションは、デプロイの一部としてインスタンスに指定されたディレクトリの作成を自動化します。

    2. PostScript には、 などのスクリプトのパスとファイル名を入力しますtest/script.sh。

    3. [次へ] を選択します。

11. [Step 6: Review] ページで、パイプラインの設定を確認し、[Create pipeline] を選択してパイプラインを作成します。

    

12. パイプラインが正常に実行されたら、詳細を表示を選択してアクションのログを表示し、マネージドコンピューティングアクションの出力を表示します。

    
    

パイプラインをテストするには

1. 設定済みソースリポジトリにコード変更を行い、変更をコミットしてプッシュします。

2. CodePipeline コンソール (https://console.aws.amazon.com/codepipeline/) を開きます。

3. リストからパイプラインを選択します。

4. ステージを通してパイプラインの進行状況を監視します。パイプラインが完了し、アクションによってスクリプトがインスタンスにデプロイされます。

5. トラブルシューティングの詳細については、「EC2 デプロイアクションがエラーメッセージで失敗する No such file」を参照してください。