CodeBuild

【VPC外リージョンサービス / ENIでVPC接続】

CodeBuild は、フルマネージドのビルドサービスです。

コンテナ上の Build Environment（ビルド環境） で、Buildspec（ビルド仕様書）（buildspec.yml） に基づいて依存関係の取得、ビルド、テスト、成果物の生成を実行します。この設定は Build Project（ビルドプロジェクト） として定義され、ソースコードは Source Provider（ソースプロバイダ）（CodeCommit／GitHub／S3など）から取得します。

ビルド結果は Artifacts（アーティファクト） として S3（Simple Storage Service）や ECR（Elastic Container Registry） に保存でき、ビルド中の 環境変数、Compute types（コンピュートタイプ） の選択、Privileged Mode（特権モード） によるDockerビルド、VPC Configuration（VPC接続設定） によるプライベートリソースアクセスにも対応しています。また、IAM Role（サービスロール） を使用して、S3・ECR・Secrets ManagerなどのAWSサービスへ安全にアクセスできます。

さらに、CodePipeline と統合して自動ビルドをパイプライン化したり、CodeCommit でのコミットをトリガーに起動したり、CodeDeploy、ECS（Elastic Container Service）、EKS（Elastic Kubernetes Service）、Lambda などのデプロイ先サービスと連携させることで、再現性の高い CI/CD（継続的インテグレーション／継続的デリバリー） 環境を簡単に構築することができます。

ビルドログやメトリクスは CloudWatch で確認でき、成果物は S3／ECR に出力されます。

重要用語

ユースケース

ベストプラクティス

セキュリティ

CodeBuildが実行ロールを引き受ける典型的な連携パターン

   {
     "Version": "2012-10-17",
     "Statement": [{
       "Effect": "Allow",
       "Principal": {"Service": "codebuild.amazonaws.com"},
       "Action": "sts:AssumeRole"
     }]
   }

ログ・監視

標準メトリクス

制限値（固定値／ハードリミット／ソフトリミット）

AWS CLIのサンプルコード

サービスロールを作成する（信頼ポリシーのファイル名 指定）

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "codebuild.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

aws iam create-role \
  --role-name CodeBuildServiceRole \
  --assume-role-policy-document file://codebuild-trust-policy.json

サービスロールを表示する

aws iam list-roles

サービスロールを削除する（実行ロール名 指定）

aws iam list-attached-role-policies \
  --role-name CodeBuildServiceRole

サービスロールにAWS管理ポリシーをアタッチする（ロール名 指定）

aws iam attach-role-policy \
  --role-name CodeBuildServiceRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy

サービスロールからAWS管理ポリシーをデタッチする（ロール名 指定）

aws iam detach-role-policy \
  --CodeBuildServiceRole \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy

プロジェクトを作成する（ロール名 指定）

aws codebuild create-project \
  --name MyProject \
  --source type=GITHUB,location=https://github.com/user/repo.git \
  --artifacts type=S3,location=my-build-bucket \
  --environment type=LINUX_CONTAINER,image=aws/codebuild/standard:7.0,computeType=BUILD_GENERAL1_SMALL \
  --service-role arn:aws:iam::123456789012:role/CodeBuildServiceRole

プロジェクトの一覧を表示する

aws codebuild list-projects

プロジェクトの詳細を表示する（プロジェクト名 指定）

aws codebuild batch-get-projects \
  --names MyProject

プロジェクトを削除する（プロジェクト名 指定）

aws codebuild delete-project \
  --name MyProject

ビルドを開始する（プロジェクト名 指定）

aws codebuild start-build \
  --project-name MyProject

ビルド履歴を表示する

aws codebuild list-builds

プロジェクトのビルド履歴を表示する（プロジェクト名 指定）

aws codebuild list-builds-for-project \
  --project-name MyProject

ビルドの詳細を表示する（ビルド ID 指定）

aws codebuild batch-get-builds \
  --ids MyProject:build-id-12345

ビルドを停止する（ビルド ID 指定）

aws codebuild stop-build \
  --id MyProject:build-id-12345

CloudFormationのサンプルコード

Terraformのサンプルコード

料金計算

公式ページ