チュートリアル: シンプルなパイプラインを作成する (CodeCommit リポジトリ)

CodeCommit リポジトリを作成するには

1. CodeCommit コンソールを https://console.aws.amazon.com/codecommit/://https://https://https://https://https://https://https://https

2. リージョンセレクタで、リポジトリとパイプライン AWS リージョン を作成する を選択します。詳細については、「AWS リージョン およびエンドポイント」を参照してください。

3. [Repositories (リポジトリ)] ページで、[Create repository (リポジトリの作成)] を選択します。

4. [リポジトリの作成] ページの [リポジトリ名] に、新しいリポジトリの名前を入力します (例: MyDemoRepo)。

5. [作成] を選択します。

ローカルリポジトリをセットアップするには

このステップでは、ローカルリポジトリをセットアップしてリモート CodeCommit リポジトリに接続します。

1. コンソールで新しいリポジトリを開き、ページの右上にある [URL のクローンを作成] を選択してから、[SSH のクローンを作成] を選択します。Git リポジトリのクローンを作成するアドレスがクリップボードにコピーされます。

2. ターミナルまたはコマンドラインで、ローカルリポジトリを保存するローカルディレクトリに移動します。このチュートリアルでは、/tmp を使用します。

3. 次のコマンドを実行してリポジトリをクローンし、SSH アドレスを前のステップでコピーしたものに置き換えます。このコマンドは、MyDemoRepo という名前のディレクトリを作成します。サンプルアプリケーションをこのディレクトリにコピーします。

   git clone ssh://git-codecommit.us-west-2.amazonaws.com/v1/repos/MyDemoRepo

1. 次に、サンプル をダウンロードし、ローカルコンピュータのフォルダまたはディレクトリに保存します。

   1. 次のいずれかを選択します 。Linux インスタンスについて、このチュートリアルのステップに従う場合は、SampleApp_Linux.zip を選択します。

      • CodeDeploy を使用して Amazon Linux インスタンスにデプロイする場合は、サンプルアプリケーションを SampleApp_Linux.zip からダウンロードします。

      • CodeDeploy を使用して Windows Server インスタンスにデプロイする場合は、サンプルアプリケーションを SampleApp_Windows.zip からダウンロードします。

      サンプルアプリケーションには、CodeDeploy を使用してデプロイするための以下のファイルが含まれています。

      • appspec.yml - アプリケーション仕様ファイル (AppSpec ファイル) は、CodeDeploy がデプロイを管理するために使用する YAML 形式のファイルです。AppSpec ファイルの詳細については、AWS CodeDeploy ユーザーガイドの「CodeDeploy AppSpec ファイルリファレンス」を参照してください。

      • index.html - インデックスファイルには、デプロイされたサンプルアプリケーションのホームページが含まれています。

      • LICENSE.txt - ライセンスファイルには、サンプルアプリケーションのライセンス情報が含まれています。

      • スクリプトのファイル - サンプルアプリケーションはスクリプトを使用して、インスタンス上の場所にテキストファイルを書き込みます。以下のように、複数の CodeDeploy デプロイライフサイクルイベントごとに 1 つのファイルが書き込まれます。

        • (Linux サンプルのみ) scripts フォルダ - このフォルダに入っているのはシェルスクリプト install_dependencies、start_server、stop_server です。依存関係をインストールし、自動デプロイのサンプルアプリケーションを起動および停止するために使用されます。

        • (Windows サンプルのみ) before-install.bat - BeforeInstall デプロイライフサイクルイベントのバッチスクリプトです。このサンプルの前のデプロイ中に書き込まれた古いファイルを削除し、新しいファイルを書き込む場所をインスタンス上に作成するために実行されます。

   2. 圧縮 (zip) ファイルをダウンロードします。

2. SampleApp_Linux.zip から先ほど作成したローカルディレクトリ (例: /tmp/MyDemoRepo や c:\temp\MyDemoRepo) にファイルを解凍します。

   それらのファイルはローカルリポジトリに直接配置してください。SampleApp_Linux フォルダーは含めないでください。例えば、ローカルの Linux、macOS、Unix マシンでは、ディレクトリとファイルの階層は次のようになります。

   /tmp
      └-- MyDemoRepo
          │-- appspec.yml
          │-- index.html
          │-- LICENSE.txt
          └-- scripts
              │-- install_dependencies
              │-- start_server
              └-- stop_server

3. リポジトリにファイルをアップロードするには、次のいずれかの方法を使用します。

   1. CodeCommit コンソールを使用してファイルをアップロードするには:

      1. CodeCommit コンソールを開き、リポジトリ リストから自分のリポジトリを選択します。

      2. [Add file]、[Upload file] の順に選択します。

      3. [ファイルの選択] を選択し、ファイルを参照します。フォルダにファイルを追加するには、ファイルの作成 を選択してから、scripts/install_dependencies のようなファイル名でフォルダ名を入力します。ファイルの内容を新しいファイルに貼り付けます。

         ユーザー名とメールアドレスを入力して、変更をコミットします。

         [Commit changes] (変更のコミット) を選択します。

      4. ファイルごとにこの手順を繰り返します。

         リポジトリの内容は次のようになります。

         
                │-- appspec.yml
                │-- index.html
                │-- LICENSE.txt
                └-- scripts
                    │-- install_dependencies
                    │-- start_server
                    └-- stop_server

   2. git コマンドを使用してファイルをアップロードするには:

      1. ディレクトリをローカルリポジトリに変更する:

         (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
         (For Windows) cd c:\temp\MyDemoRepo

      2. 以下のコマンドを実行して、すべてのファイルを一度にステージングします。

         git add -A

      3. 以下のコマンドを実行して、コミットメッセージによりファイルをコミットします。

         git commit -m "Add sample application files"

      4. 以下のコマンドを実行して、ローカルリポジトリから CodeCommit リポジトリにファイルをプッシュします。

         git push

4. ダウンロードしてローカルリポジトリに追加したファイルは、CodeCommit main リポジトリの MyDemoRepo ブランチに追加され、パイプラインに含める準備ができています。

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

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

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

3. [ロールの作成] を選択します。

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

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

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

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

   注記

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

   [ロールの作成] を選択します。

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

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

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

3. [名前] に「MyCodePipelineDemo」と入力します。これにより、インスタンスにはキーが Name で、値が MyCodePipelineDemo というタグがが割り当てられます。後で、このインスタンスにサンプルアプリケーションをデプロイする CodeDeploy アプリケーションを作成します。CodeDeploy は、タグに基づいてデプロイするインスタンスを選択します。

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

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

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

   [キーペアなしで続行] を選択することもできます。

   注記

   このチュートリアルでは、キーペアを使用せずに続行できます。SSH を使用してインスタンスに接続するには、キーペアを作成または使用します。

7. [ネットワーク設定] で、次の操作を行います。

   [パブリック IP の自動割り当て] で、ステータスが [有効] になっていることを確認します。

   作成したセキュリティグループで HTTP を選択し、ソースタイプで My IP を選択します。

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

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

10. Launch instance (インスタンスの起動) を選択します。

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

CodeDeploy サービスロールの作成するために

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

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

3. [ロールの作成] を選択します。

4. [信頼されたエンティティを選択] で、[AWS のサービス] を選択します。[ユースケース] で、[CodeDeploy] を選択します。示されたオプションから [CodeDeploy] を選択します。[Next (次へ)] を選択します。AWSCodeDeployRole マネージドポリシーはロールにアタッチ済みです。

5. [Next (次へ)] を選択します。

6. ロールの名前 (例: CodeDeployRole) を入力し、[ロールの作成] を選択します。

CodeDeploy でアプリケーションを作成するには

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

2. [アプリケーション] ページが表示されない場合は、メニューで [アプリケーション] を選択します。

3. [Create application] を選択します。

4. [アプリケーション名] に、「MyDemoApplication」と入力します。

5. [コンピューティングプラットフォーム] で [EC2/オンプレミス] を選択します。

6. [Create application] を選択します。

CodeDeploy でデプロイグループを作成するには

デプロイグループは、デプロイ先のインスタンスやデプロイの速度など、デプロイ関連の設定を定義するリソースです。

1. アプリケーションが表示されるページで、[Create deployment group (デプロイグループの作成)] を選択します。

2. [Deployment group name] (デプロイグループ名) に「MyDemoDeploymentGroup」と入力します。

3. [サービスロール] で、先ほど作成したサービスロールの ARN を選択します (arn:aws:iam::account_ID:role/CodeDeployRole など)。

4. [Deployment type] (デプロイタイプ) で、[In-place] (インプレース) を選択します。

5. [環境設定] で、[Amazon EC2 インスタンス] を選択します。キー フィールドに Name と入力します。値 フィールドに、(MyCodePipelineDemo のような) インスタンスのタグ付けに使用した名前を入力します。

6. AWS Systems Manager を使用した エージェント設定で、今すぐ を選択し、更新をスケジュールします。これにより、インスタンスにエージェントがインストールされます。Linux インスタンスは既に SSM エージェントで設定されており、これから CodeDeploy エージェントで更新されます。

7. [デプロイ設定] で、[CodeDeployDefault.OneAtaTime] を選択します。

8. ロードバランサー で、ロードバランシングの有効化 が選択されていないことを確認します。この例では、ロードバランサーを設定したり、ターゲットグループを選択したりする必要はありません。

9. デプロイグループの作成 を選択します。

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

1. にサインイン AWS Management Console し、http://console.aws.amazon.com/codesuite/codepipeline/home://www.com」で CodePipeline コンソールを開きます。

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

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

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

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

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

6. サービスロール で、新しいサービスロール を選択して、CodePipeline が IAM でサービスロールを作成できるようにします。

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

8. [ステップ 3: ソースステージを追加する] の [ソースプロバイダー] で、[CodeCommit] を選択します。リポジトリ名 で、ステップ 1: CodeCommit リポジトリを作成する で作成した CodeCommit リポジトリの名前を選択します。[ブランチ名] で、[main] を選択し、[次のステップ] を選択します。

   リポジトリ名とブランチを選択すると、このパイプライン用に作成される Amazon CloudWatch Events ルールがメッセージに表示されます。

   [Change detection options] で、デフォルト値のままにします。これにより、CodePipelineはAmazon CloudWatch Events を使用して、ソースリポジトリの変更を検出できます。

   [Next (次へ)] を選択します。

9. [ステップ 4: ビルドステージを追加する] で、[ビルドステージをスキップ] を選択し、もう一度 [スキップ] を選択して警告メッセージを受け入れます。[Next (次へ)] を選択します。

   注記

   このチュートリアルでは、ビルドサービスを必要としないコードをデプロイするため、このステップは省略できます。ただし、インスタンスにデプロイする前にソースコードを構築する必要がある場合は、このステップで CodeBuild を設定できます。

10. ステップ 5: テストステージを追加し、テストステージをスキップを選択し、もう一度スキップを選択して警告メッセージを受け入れます。

    [Next (次へ)] を選択します。

11. ステップ 6: デプロイステージを追加し、デプロイプロバイダーで CodeDeploy を選択します。[アプリケーション名] に、「MyDemoApplication」を選択します。[デプロイグループ] で、[MyDemoDeploymentGroup]、[次のステップ] の順に選択します。

12. ステップ 7: 情報を確認してから、パイプラインの作成を選択します。

13. パイプラインは、作成後に実行を開始します。CodeCommit リポジトリからコードをダウンロードし、EC2 インスタンスへの CodeDeploy デプロイを作成します。CodePipeline サンプルが CodeDeploy デプロイで Amazon EC2 インスタンスにウェブページをデプロイするときに、進行状況と成功および失敗のメッセージを表示できます。

    

パイプラインが正常に実行されたことを確認するには

1. パイプラインの最初の進行状況を表示します。各ステージのステータスは、[まだ実行はありません] から [進行中] に変わり、その後、[Succeeded (成功)] または [Failed (失敗)] のいずれかに変わります。パイプラインの最初の実行は数分で完了します。

2. パイプラインのステータスが [成功] と表示されたら、[ デプロイ] ステージのステータス領域で [CodeDeploy ] を選択します。これにより、CodeDeploy コンソールが開きます。[成功] が表示されない場合は、「CodePipeline のトラブルシューティング」を参照してください。

3. [Deployments (デプロイ)] タブで、デプロイ ID を選択します。デプロイのページの [Deployment lifecycle events (デプロイライフサイクルイベント)] で、インスタンス ID を選択します。これにより、EC2 コンソールが開きます。

4. [説明] タブの [パブリック DNS] でアドレス (例: ec2-192-0-2-1.us-west-2.compute.amazonaws.com) をコピーし、ウェブブラウザのアドレスバーに貼り付けます。

   ダウンロードして CodeCommit リポジトリにプッシュしたサンプルアプリケーションのウェブページが表示されます。

1. ディレクトリをローカルリポジトリに変更する:

   (For Linux, macOS, or Unix) cd /tmp/MyDemoRepo
   (For Windows) cd c:\temp\MyDemoRepo

2. テキストエディタを使用して、index.html ファイルを変更します。

   (For Linux or Unix)gedit index.html
   (For OS X)open –e index.html
   (For Windows)notepad index.html

3. index.html ファイルのコンテンツを変更して、背景色およびウェブページのテキストの一部を変更してから、ファイルを保存します。

   <!DOCTYPE html>
   <html>
   <head>
     <title>Updated Sample Deployment</title>
     <style>
       body {
         color: #000000;
         background-color: #CCFFCC;
         font-family: Arial, sans-serif;  
         font-size:14px;
       }
           
       h1 {
         font-size: 250%;
         font-weight: normal;
         margin-bottom: 0;
       }
       
       h2 {
         font-size: 175%;
         font-weight: normal;
         margin-bottom: 0;
       }
     </style>
   </head>
   <body>
     <div align="center"><h1>Updated Sample Deployment</h1></div>
     <div align="center"><h2>This application was updated using CodePipeline, CodeCommit, and CodeDeploy.</h2></div>
     <div align="center">
       <p>Learn more:</p> 
       <p><a href="https://docs.aws.amazon.com/codepipeline/latest/userguide/">CodePipeline User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codecommit/latest/userguide/">CodeCommit User Guide</a></p>
       <p><a href="https://docs.aws.amazon.com/codedeploy/latest/userguide/">CodeDeploy User Guide</a></p>
     </div>
   </body>
   </html>

4. 次のコマンドを一度に 1 つずつ実行して、変更をコミットして CodeCommit リポジトリにプッシュします。

   git commit -am "Updated sample application files"

   git push

パイプラインが正常に実行されたことを確認するには

1. パイプラインの最初の進行状況を表示します。各ステージのステータスは、[まだ実行はありません] から [進行中] に変わり、その後、[Succeeded (成功)] または [Failed (失敗)] のいずれかに変わります。パイプラインの実行は数分以内に完了します。

2. アクションステータスが [成功] と表示されたら、ブラウザで先ほどアクセスしたデモページを更新します。

   更新されたウェブページが表示されます。

このチュートリアルで使用されているリソースをクリーンアップするには

1. CodePipeline リソースをクリーンアップするには、「AWS CodePipelineでパイプラインを削除する」の手順に従います。

2. CodeDeploy リソースをクリーンアップするには、チュートリアルのデプロイリソースのクリーンアップ の手順に従います。

3. CodeCommit リポジトリを削除するには、「CodeCommit リポジトリの削除」の手順に従います。