CodeBuild を使用するパイプラインの作成 (CodePipeline コンソール) - AWS CodeBuild

CodeBuild を使用するパイプラインの作成 (CodePipeline コンソール)

CodeBuild を使用してソースコードをビルドおよびデプロイするパイプラインを作成するには、次の手順を実行します。

ソースコードのみをテストするパイプラインを作成するには、以下の操作を行います。

CodePipeline でパイプライン作成ウィザードを使用して、CodeBuild を使用するパイプラインを作成するには

  1. 以下を使用して AWS マネジメントコンソール にサインインします。

    • AWS ルートアカウント。これは推奨されません。詳細については、https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html ユーザーガイドの「IAMアカウントのルートユーザー」を参照してください。

    • AWS アカウントの管理者 IAM ユーザー。詳細については、IAM ユーザーガイドの「最初の IAM 管理者ユーザーおよびグループの作成」を参照してください。

    • 次の最小限のアクションを使用する権限がある AWS アカウントの IAM ユーザー。

      codepipeline:* iam:ListRoles iam:PassRole s3:CreateBucket s3:GetBucketPolicy s3:GetObject s3:ListAllMyBuckets s3:ListBucket s3:PutBucketPolicy codecommit:ListBranches codecommit:ListRepositories codedeploy:GetApplication codedeploy:GetDeploymentGroup codedeploy:ListApplications codedeploy:ListDeploymentGroups elasticbeanstalk:DescribeApplications elasticbeanstalk:DescribeEnvironments lambda:GetFunctionConfiguration lambda:ListFunctions opsworks:DescribeStacks opsworks:DescribeApps opsworks:DescribeLayers
  2. AWS CodePipeline コンソール (https://console.aws.amazon.com/codesuite/codepipeline/home) を開きます。

  3. AWS リージョンセレクターで、ビルドプロジェクトの AWS リソースがある AWS リージョンを選択します。この AWS リージョンでは、CodeBuild をサポートしている必要があります。詳細については、「アマゾン ウェブ サービス全般のリファレンス」の「AWS CodeBuild」を参照してください。

  4. パイプラインを作成します。CodePipeline 情報ページが表示された場合、[パイプラインの作成] を選択します。[Pipelines (パイプライン)] ページが表示された場合は、[Create pipeline (パイプラインの作成)] を選択します。

  5. [Step 1:] [ Choose pipeline settings (パイプラインの設定の選択)] ページで、[パイプライン名CodeBuildDemoPipeline] にパイプラインの名前を入力します (例: )。別の名前を選択した場合は、この手順全体でそれを使用してください。

  6. [Role name (ロール名)] として、以下のいずれかの操作を行います。

    [New service role (新しいサービスロール)] を選択し、[Role Name (ロール名)] に、新しいサービスロールの名前を入力します。

    [Existing service role (既存のサービスロール)] を選択し、このトピックの前提条件の一部として作成または特定した CodePipeline​ サービスロールを選択します。

  7. [Artifact store (アーティファクトストア)] で、次のいずれかの操作を行います。

    • パイプライン用に選択した AWS リージョンでパイプラインのデフォルトの S3 アーティファクトストア (デフォルトとして指定した S3 アーティファクトバケットなど) を使用するには、[デフォルトの場所] を選択します。

    • S3 アーティファクトバケットなど、作成済みのアーティファクトストアがパイプラインと同じ AWS リージョンにある場合は、[Custom location (カスタムの場所)] を選択します。

    注記

    これはパイプラインのソースコードのソースバケットではありません。パイプラインのアーティファクトストアです。パイプラインごとに別個のアーティファクトストア (S3 バケットなど) が、パイプラインと同じ AWS リージョンに必要です。

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

  9. [Step 2:] [Add source stage (ソースステージの追加)] ページの [ソースプロバイダ] で、次のいずれかの操作を行います。

    • ソースコードの保存先が S3 バケットである場合は、[Amazon S3] を選択します。[バケット] で、ソースコードが含まれている S3 バケットを選択します。[S3 オブジェクトキー] に、ソースコードを含むファイルの名前 (例: file-name.zip) を入力します。[次へ] を選択します。

    • ソースコードが AWS CodeCommit リポジトリに保存されている場合は、[CodeCommit] を選択します。[Repository name] で、ソースコードが含まれているリポジトリの名前を選択します。[ブランチ名] で、ビルドするソースコードのバージョンが含まれているブランチの名前を選択します。[次へ] を選択します。

    • ソースコードが GitHub リポジトリに保存されている場合は、[GitHub] を選択します。 [Connect to GitHub ( に接続)] を選択し、指示に従って GitHub で認証します。 [リポジトリ] で、ソースコードが含まれているリポジトリの名前を選択します。[ブランチ] で、ビルドするソースコードのバージョンが含まれているブランチの名前を選択します。

    [次へ] を選択します。

  10. [Step 3:] [ Add build stage (ビルドステージの追加)] ページの [Build provider (ビルドプロバイダ)] で、[CodeBuild] を選択します。

  11. 使用するビルドプロジェクトがすでにある場合は、[プロジェクト名] で、ビルドプロジェクトの名前を選択し、この手順の次のステップに進みます。

    新しい CodeBuild ビルドプロジェクトを作成する必要がある場合は、「ビルドプロジェクトの作成 (コンソール)」の手順に従ってこの手順に戻ります。

    既存のビルドプロジェクトを選択した場合、ビルド出力アーティファクトの設定がすでに定義されている必要があります (CodePipeline によってビルド出力の設定が上書きされます)。詳細については、「ビルドプロジェクトの設定の変更 (コンソール)」を参照してください。

    重要

    CodeBuild プロジェクトのウェブフックを有効にして、プロジェクトを CodePipeline のビルドステップとして使用すると、コミットごとに 2 つの等しいビルドが作成されます。一方のビルドはウェブフックを通じてトリガーされ、もう一方は CodePipeline を通じてトリガーされます。請求はビルド単位で発生するため、両方のビルドに対して課金されます。したがって、CodePipeline を使用する場合は、CodeBuild でウェブフックを無効にすることをお勧めします。AWS CodeBuild コンソールで、[Webhook] ボックスをオフにします。詳細については、「ビルドプロジェクトの設定の変更 (コンソール)」を参照してください。

  12. [ステップ 4:] [Add deploy stage (デプロイステージの追加)] ページでは、以下のいずれかの操作を行います。

    • ビルド出力アーティファクトをデプロイしない場合は、[Skip (スキップ)] を選択し、プロンプトが表示されたら、これを選択したことを確認します。

    • ビルド出力アーティファクトをデプロイする場合は、[Deployment provider (デプロイプロバイダ)] でデプロイプロバイダを選択し、次にプロンプトに応じて設定を指定します。

    [次へ] を選択します。

  13. [確認] ページで、選択内容を確認し、[パイプラインの作成] を選択します。

  14. パイプラインが正常に実行されたら、ビルド出力アーティファクトを取得できます。CodePipeline コンソールに表示されたパイプラインを使用して、[Build (ビルド)] アクションで、ツールヒントを選択します。[Output artifact (出力アーティファクト)] の値をメモします (例: MyAppBuild)。

    注記

    ビルド出力アーティファクトを取得するには、 コンソールのビルドの詳細ページで [Build artifactsCodeBuild] リンクを選択することもできます。このページを表示するには、この手順の残りのステップを省略して、「ビルドの詳細の表示 (コンソール)」を参照してください。

  15. https://console.aws.amazon.com/s3/ にある Amazon S3 コンソールを開きます。

  16. バケットのリストで、パイプラインで使用されるバケットを開きます。バケットの名前は codepipeline-region-ID-random-number の形式に従う必要があります。 を使用して AWS CLI CodePipeline コマンドを実行すると、バケットの名前を取得できます。ここで、get-pipelinemy-pipeline-name はパイプラインの表示名です。

    aws codepipeline get-pipeline --name my-pipeline-name

    出力では、pipeline オブジェクトには artifactStore オブジェクトが含まれ、それには、バケットの名前と location の値が含まれます。

  17. パイプラインの名前と一致するフォルダを開きます (パイプライン名の長さによってはフォルダ名が切り詰められている場合があります)。次に、前に書き留めた [出力アーティファクト] の値と一致するフォルダを開きます。

  18. ファイルの内容を展開します。そのフォルダに複数のファイルがある場合は、[Last Modified] タイムスタンプが最新であるファイルの内容を抽出します。(システムの ZIP ユーティリティで操作できるように、必要に応じて、ファイルに .zip 拡張子を付けます。) ビルド出力アーティファクトは、展開されたファイルの内容に含まれます。

  19. CodePipeline にビルド出力アーティファクトをデプロイするよう指示した場合は、デプロイプロバイダの説明を活用してデプロイターゲットのビルド出力アーティファクトを取得します。