リザーブドキャパシティフリートでビルドを実行する - AWS CodeBuild

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

リザーブドキャパシティフリートでビルドを実行する

CodeBuild には、次のコンピューティングフリートが用意されています。

  • オンデマンドフリート

  • リザーブドキャパシティフリート

オンデマンドフリートでは、 はビルドのコンピューティング CodeBuild を提供します。マシンはビルドが終了すると破棄されます。オンデマンドフリートはフルマネージド型で、需要の急増にも対応できる自動スケーリング機能を備えています。

注記

オンデマンドフリートは macOS または Windows Server 2022 をサポートしていません。

CodeBuild は、 によってEC2維持される Amazon を搭載したインスタンスを含むリザーブドキャパシティフリートも提供します CodeBuild。リザーブドキャパシティフリートでは、ビルド環境に合わせて専有インスタンスのセットを設定します。これらのマシンはアイドル状態のままで、ビルドやテストをすぐに処理できる状態になり、ビルド時間を短縮します。リザーブドキャパシティフリートでは、マシンは常に稼働しており、プロビジョニングされている間はコストが発生し続けます。

重要

インスタンスの実行期間にかかわらず、リザーブドキャパシティフリートにはインスタンスごとに初期料金が発生し、その後、追加の関連コストが発生する場合があります。詳細については、「https://aws.amazon.com/codebuild/pricing/」を参照してください。

リザーブドキャパシティフリートを作成する

リザーブドキャパシティフリートを作成するには、次の手順に従います。

リザーブドキャパシティフリートを作成するには
  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/codesuite/codebuild/home で AWS CodeBuild コンソールを開きます。

  2. ナビゲーションペインで、「フリートをコンピューティングする」を選択し、「フリートを作成する」を選択します。

  3. [コンピューティングフリート名] テキストフィールドに、フリートの名前を入力します。

  4. [オペレーティングシステム] ドロップダウンメニューから、オペレーティングシステムを選択します。

  5. [アーキテクチャ] ドロップダウンメニューから、アーキテクチャを選択します。

  6. コンピューティング フィールドで、マシンのコンピューティングマシンタイプを選択します。

  7. [容量] テキストフィールドに、フリート内の最小インスタンス数を入力します。

  8. 「オーバーフロー動作」フィールドで、需要がフリート容量を超えたときの動作を選択します。これらのパラメータの詳細については、「リザーブドキャパシティフリートのプロパティ」を参照してください。

  9. (オプション) Amazon Linux オペレーティングシステムを選択した場合は、「追加設定」で次の操作を行います。

    • VPC - オプションのドロップダウンメニューから、 CodeBuild フリートがアクセスVPCする を選択します。

    • 「サブネット」ドロップダウンメニューから、VPC設定の設定 CodeBuild に使用するサブネットを選択します。

    • セキュリティグループのドロップダウンメニューから、 の操作 CodeBuild に使用するセキュリティグループを選択しますVPC。

    • フリートサービスロール フィールドで、既存のサービスロールを選択します。

      注記

      フリートロールに必要なアクセス許可があることを確認します。詳細については、「フリートサービスロールのアクセス許可ポリシーの追加をユーザーに許可する」を参照してください。

  10. [コンピューティングフリートの作成] を選択します。

  11. コンピューティングフリートを作成したら、新しい CodeBuild プロジェクトを作成するか、既存のプロジェクトを編集します。[環境] から [プロビジョニングモデル][リザーブドキャパシティ] を選択し、[フリート名] で指定したフリートを選択します。

ベストプラクティス

リザーブドキャパシティフリートを使用する場合は、以下のベストプラクティスに従うことをお勧めします。

  • ソースをキャッシュしてビルドパフォーマンスを向上させるには、ソースキャッシュモードを使用することをお勧めします。

  • Docker レイヤーキャッシュを使用し、既存の Docker レイヤーをキャッシュしてビルドパフォーマンスを向上させることをお勧めします。

リザーブドキャパシティフリートを複数の CodeBuild プロジェクトで共有できますか?

はい。フリートのキャパシティを複数のプロジェクトで使用することで、そのキャパシティを最大限に活用できます。

重要

リザーブドキャパシティ機能を使用する場合、buildspec で指定されたソースファイル、Docker レイヤー、キャッシュされたディレクトリなど、フリートインスタンスにキャッシュされたデータに、同じアカウント内の他のプロジェクトからアクセスできます。これは設計上のものであり、同じアカウント内のプロジェクトがフリートインスタンスを共有できるようにします。

リザーブドキャパシティフリートをサポートしているのはどのリージョンですか?

リザーブドキャパシティの Amazon Linux および Windows フリートは、 AWS リージョン米国東部 (バージニア北部)、米国東部 (オハイオ)、米国西部 (オレゴン)、アジアパシフィック (ムンバイ)、アジアパシフィック (シンガポール)、アジアパシフィック (シドニー)、アジアパシフィック (東京)、欧州 (フランクフルト)、欧州 (アイルランド)、南米 (サンパウロ) でサポートされています。 CodeBuild が利用可能な場所の詳細については AWS リージョン 、AWS 「リージョン別のサービス」を参照してください。

リザーブドキャパシティ macOS Medium フリートは、 AWS リージョン米国東部 (バージニア北部)、米国東部 (オハイオ)、米国西部 (オレゴン)、アジアパシフィック (シドニー)、欧州 (フランクフルト) でサポートされています。リザーブドキャパシティの macOS ラージフリートは、 AWS リージョン米国東部 (バージニア北部)、米国東部 (オハイオ)、米国西部 (オレゴン)、アジアパシフィック (シドニー) でサポートされています。

リザーブドキャパシティの macOS フリートを設定する方法

リザーブドキャパシティの macOS フリートを設定するには
  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/codesuite/codebuild/home で AWS CodeBuild コンソールを開きます。

  2. ナビゲーションペインで、「コンピューティングフリート」を選択し、「フリートの作成」を選択します。

  3. [コンピューティングフリート名] テキストフィールドに、フリートの名前を入力します。

  4. オペレーティングシステムのドロップダウンメニューから、macOSを選択します。

  5. Compute フィールドで、Apple M2、24 GB のメモリ、8 vCPUsまたは Apple M2、32 GB のメモリ、12 vCPUsのコンピューティングマシンタイプのいずれかを選択します。

  6. [容量] テキストフィールドに、フリート内の最小インスタンス数を入力します。

  7. (オプション) フリートのカスタムイメージを選択する場合は、Amazon マシンイメージ (AMI) に次の前提条件があることを確認してください。

    • AMI アーキテクチャは 64 ビット ですMac-Arm

    • AMI は、 CodeBuild サービス Organization ARNを許可します。Organization のリストについては、ARNs「」を参照してくださいAmazon Machine Images (AMI)

    • AMI が AWS KMS キーで暗号化されている場合、 AWS KMS キーは CodeBuild サービス組織 ID も許可する必要があります。Organization のリストについては、IDs「」を参照してくださいAmazon Machine Images (AMI)。 AWS KMS キーの詳細については、「Amazon ユーザーガイド」の「組織OUsを許可する」およびKMS「キーの使用」を参照してください。 EC2

    • フリートサービスロールフィールドで、次の Amazon EC2 アクセス許可を付与します。

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "ec2:DescribeImages", "Resource": "*" } ] }
  8. (オプション) フリートVPCで を設定するには、「追加設定」で次の操作を行います。

    • VPC - オプションのドロップダウンメニューから、 CodeBuild フリートがアクセスVPCする を選択します。

    • 「サブネット」ドロップダウンメニューから、VPC設定の設定 CodeBuild に使用するサブネットを選択します。

    • セキュリティグループのドロップダウンメニューから、 の操作 CodeBuild に使用するセキュリティグループを選択しますVPC。

    • フリートサービスロール フィールドで、既存のサービスロールを選択します。

      注記

      フリートロールに必要なアクセス許可があることを確認します。詳細については、「フリートサービスロールのアクセス許可ポリシーの追加をユーザーに許可する」を参照してください。

  9. コンピューティングフリートの作成を選択し、フリートインスタンスが起動するのを待ちます。起動すると、容量は になりますn/nn は、提供される容量です。

  10. コンピューティングフリートが起動したら、新しい CodeBuild プロジェクトを作成するか、既存のプロジェクトを編集します。[環境] から [プロビジョニングモデル][リザーブドキャパシティ] を選択し、[フリート名] で指定したフリートを選択します。

リザーブドキャパシティフリートの制限

リザーブドキャパシティフリートではサポートされていないユースケースがいくつかあります。それにより影響が出る場合は、代わりにオンデマンドフリートを使用してください。

  • リザーブドキャパシティフリートは、バッチビルド、ビルド使用率メトリクス、またはセマンティックバージョニングをサポートしていません。

クォータと制限の詳細については、「コンピューティングフリート」を参照してください。

リザーブドキャパシティフリートの制限

リザーブドキャパシティフリートではサポートされていないユースケースがいくつかあります。それにより影響が出る場合は、代わりにオンデマンドフリートを使用してください。

  • リザーブドキャパシティフリートは、バッチビルド、ビルド使用率メトリクス、またはセマンティックバージョニングをサポートしていません。

  • リザーブドキャパシティの macOS フリートはデバッグセッションをサポートしていません。

クォータと制限の詳細については、「コンピューティングフリート」を参照してください。