AWS CodeBuild
ユーザーガイド (API バージョン 2016-10-06)

このガイドの手順では、新しいコンソールデザインがサポートされています。古いバージョンのコンソールを選択すると、古い概念が反映され、本ガイドの基本的な手順がそのまま適用されます。新しいコンソールのヘルプにアクセスするには、情報アイコンを選択します。

CodeBuild のビルドを計画する

CodeBuild を使用してビルドを実行する前に、次の質問に答える必要があります。

  1. ソースコードはどこにありますか? CodeBuild は現在、次のソースコードのリポジトリプロバイダからのビルドをサポートしています。ソースコードには、ビルド仕様ファイルが含まれている必要があります。またはビルド仕様をビルドプロジェクト定義の一部として宣言する必要があります。ビルド仕様は、CodeBuild がビルドを実行するために使用する YAML 形式のビルドコマンドと関連設定のコレクションです。

    リポジトリプロバイダ 必須 ドキュメント
    CodeCommit

    リポジトリ名.

    (オプション) ソースコードに関連付けられているコミット ID。

    CodeCommit ユーザーガイドの以下のトピックを参照してください。

    CodeCommit リポジトリの作成

    CodeCommit でコミットを作成する

    Amazon S3

    バケット名を入力します。

    ソースコードを含むビルド入力 ZIP ファイルに対応するオブジェクト名。

    (オプション) ビルド入力 ZIP ファイルに関連付けられているバージョン ID。

    Amazon S3 入門ガイド」の以下のトピックを参照してください。

    バケットの作成

    バケットにオブジェクトを追加

    GitHub

    リポジトリ名.

    (オプション) ソースコードに関連付けられているコミット ID。

    GitHub のヘルプウェブサイトでこのトピックを参照してください。

    Repo の作成

    Bitbucket

    リポジトリ名.

    (オプション) ソースコードに関連付けられているコミット ID。

    Bitbucket Cloud のドキュメントウェブサイトでこのトピックを参照してください。

    リポジトリの作成

  2. どのビルドコマンドを、どのような順番で実行する必要がありますか? デフォルトでは、CodeBuild は指定したプロバイダからビルド入力をダウンロードし、指定したバケットにビルド出力をアップロードします。ビルド仕様を使用して、ダウンロードされたビルド入力を予想されるビルド出力に変換する方法を指示します。詳細については、「ビルドスペックリファレンス」を参照してください。

  3. ビルドを実行するためにどのランタイムとツールが必要ですか? たとえば、Java、Ruby、Python、Node.js を構築していますか? ビルドでは、Maven、Ant または、Java、Ruby、Python のコンパイラが必要ですか? ビルドでは、Git、AWS CLI、またはその他のツールが必要ですか?

    CodeBuild は、Docker イメージを使用するビルド環境でビルドを実行します。これらの Docker イメージを CodeBuild でサポートされているリポジトリタイプに保存する必要があります。これらには、CodeBuild Docker イメージリポジトリ、Docker ハブ、および Amazon Elastic Container Registry (Amazon ECR) が含まれます。CodeBuild Docker イメージリポジトリの詳細については、「CodeBuild に用意されている Docker イメージ」を参照してください。

  4. CodeBuild によって自動的に提供されない AWS リソースが必要ですか? その場合は、それらのリソースにはどのセキュリティポリシーが必要ですか? たとえば、CodeBuild サービスロールを変更して、CodeBuild がそれらのリソースを操作できるようにする必要が生じることがあります。

  5. CodeBuild を VPC と連携させますか? その場合は、VPC ID、サブネット ID、および VPC 設定のセキュリティグループ ID が必要です。詳細については、「Amazon Virtual Private Cloud で CodeBuild を使用する」を参照してください。

これらの質問に答えると、ビルドを正常に実行するために必要な設定とリソースがあるはずです。ビルドを実行するには、次の操作を実行できます。

  • CodeBuild コンソール、AWS CLI または AWS SDK の使用。詳細については、「CodeBuild を直接実行する」を参照してください。

  • CodePipeline でパイプラインを作成または指定し、CodeBuild が自動的にコードをテストし、ビルドを実行 (またはその両方) するよう指示するビルドまたはテストアクションを追加します。詳細については、「AWS CodeBuild で AWS CodePipeline を使用する」を参照してください。