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

AWS CodeBuild のビルドを計画する

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

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

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

    リポジトリ名.

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

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

    AWS CodeCommit リポジトリの作成

    AWS CodeCommit でのコミットの作成

    Amazon S3

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

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

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

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

    バケットの作成

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

    GitHub

    リポジトリ名.

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

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

    Repo の作成

    Bitbucket

    リポジトリ名.

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

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

    リポジトリの作成

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

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

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

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

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

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

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

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