でバッジのサンプルを構築する CodeBuild - AWS CodeBuild

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

でバッジのサンプルを構築する CodeBuild

AWS CodeBuild では、ビルドバッジの使用がサポートされるようになりました。ビルドバッジは、プロジェクトの最新のビルドのステータスを表示する埋め込み可能な動的に生成されたイメージ (バッジ) を提供します。このイメージには、 CodeBuild プロジェクトでURL公開されている を通じてアクセスできます。これにより、誰でも CodeBuild プロジェクトのステータスを表示できます。ビルドバッジにはセキュリティ情報が含まれないため、認証は不要です。

ビルドバッジを使用してビルドプロジェクトを作成する

ビルドバッジを有効にしてビルドプロジェクトを作成するには、次のいずれかの手順を使用します。 AWS CLI または を使用できます AWS Management Console。

ビルドバッジを有効にしてビルドプロジェクトを作成するには (AWS CLI)
  • ビルドプロジェクトの作成の詳細については、「ビルドプロジェクトの作成 (AWS CLI)」を参照してください。ビルドバッジを AWS CodeBuild プロジェクトに含めるには、 を指定する必要があります。badgeEnabled の値を持つ true

ビルドバッジを有効にしてビルドプロジェクトを作成するには (コンソール)
  1. https://console.aws.amazon.com/codesuite/codebuild/home で AWS CodeBuild コンソールを開きます。

  2. CodeBuild 情報ページが表示されたら、ビルドプロジェクトの作成 を選択します。それ以外の場合は、ナビゲーションペインでビルドを展開し、[ビルドプロジェクト] を選択し、次に [Create build project (ビルドプロジェクトの作成)] を選択します。

  3. [プロジェクト名] に、このビルドプロジェクトの名前を入力します。ビルドプロジェクト名は、 AWS アカウントごとに一意である必要があります。また、他のユーザーがこのプロジェクトの使用目的を理解できるように、ビルドプロジェクトの説明を任意で指定することもできます。

  4. [ソース] の [ソースプロバイダ] で、ソースコードプロバイダタイプを選択し、次のいずれかの操作を行います。

    注記

    CodeBuild は、Amazon S3 ソースプロバイダーでのビルドバッジをサポートしていません。はアーティファクト転送に Amazon S3 AWS CodePipeline を使用するため、ビルドバッジは で作成されたパイプラインの一部であるビルドプロジェクトではサポートされていません CodePipeline。

    • を選択した場合CodeCommitは、リポジトリ でリポジトリの名前を選択します。[Enable build badge (ビルドバッジを有効にする)] を選択すると、プロジェクトのビルドステータスが表示可能および埋め込み可能になります。

    • を選択した場合はGitHub、手順に従って と接続 (または再接続) します GitHub。「アプリケーション GitHubの承認」ページの「組織アクセス」で、アクセスを許可する各リポジトリの横にある「アクセスのリクエスト AWS CodeBuild 」を選択します。 [Authorize application (アプリケーションの承認)] を選択した後で AWS CodeBuild コンソールに戻り、[リポジトリ] でソースコードが含まれているリポジトリの名前を選択します。[Enable build badge (ビルドバッジを有効にする)] を選択すると、プロジェクトのビルドステータスが表示可能および埋め込み可能になります。

    • [Bitbucket] を選択した場合は、手順に従って Bitbucket に接続 (または再接続) します。Bitbucket の [Confirm access to your account] ページで、[Organization access] の [Grant access] を選択します。アクセス権を付与を選択し、 AWS CodeBuild コンソールに戻り、リポジトリ で、ソースコードを含むリポジトリの名前を選択します。[Enable build badge (ビルドバッジを有効にする)] を選択すると、プロジェクトのビルドステータスが表示可能および埋め込み可能になります。

      重要

      プロジェクトソースを更新すると、プロジェクトのビルドバッジの正確性に影響する場合があります。

  5. [環境] で以下の操作を行います。

    [Environment image (環境イメージ)] で、次のいずれかの操作を行います。

    • によって管理される Docker イメージを使用するには AWS CodeBuild、マネージドイメージ を選択し、オペレーティングシステム ランタイム (複数可)イメージ イメージバージョン から選択します。利用可能な場合は、[環境タイプ] から選択します。

    • 別の Docker イメージを使用するには、[カスタムイメージ] を選択します。環境タイプ で、、LinuxARMLinuxGPU、または Windows を選択します。その他のレジストリ を選択した場合は、外部レジストリ URLに、形式 を使用して Docker Hub で Docker イメージの名前とタグを入力しますdocker repository/docker image nameAmazon を選択した場合は、Amazon ECRECRリポジトリAmazon ECRイメージを使用して、 AWS アカウントの Docker イメージを選択します。

    • プライベート Docker イメージを使用するには、[カスタムイメージ] を選択します。環境タイプ で、、LinuxARMLinuxGPU、または Windows を選択します。イメージレジストリ で、その他のレジストリ を選択し、プライベート Docker イメージARNの認証情報の を入力します。認証情報は、Secrets Manager で作成する必要があります。詳細については、AWS Secrets Manager ユーザーガイドの「AWS Secrets Managerとは」を参照してください。

  6. [Service role (サービスロール)] で、次のいずれかの操作を行います。

    • CodeBuild サービスロールがない場合は、新しいサービスロール を選択します。[Role name] に、新しいロールの名前を入力します。

    • CodeBuild サービスロールがある場合は、「既存のサービスロール」を選択します。ロール ARNで、サービスロールを選択します。

    注記

    コンソールを使用してビルドプロジェクトを作成または更新する場合、 CodeBuild サービスロールを同時に作成できます。デフォルトでは、ロールはそのビルドプロジェクトでのみ使用できます。コンソールでは、このサービスロールを別のビルドプロジェクトと関連付けると、この別のビルドプロジェクトで使用できるようにロールが更新されます。サービスロールは最大 10 個のビルドプロジェクトで使用できます。

  7. [Buildspec] で、次のいずれかを行います。

    • [Use a buildspec file] (ビルド仕様ファイルの使用) を選択して、ソースコードのルートディレクトリの buildspec.yml を使用します。

    • [ビルドコマンドの挿入] を選択して、コンソールを使用してビルドコマンドを挿入します。

    詳細については、「ビルド仕様 (buildspec) に関するリファレンス」を参照してください。

  8. [アーティファクト] の [タイプ] で、次のいずれかの操作を行います。

    • ビルド出力アーティファクトを作成しない場合は、[No artifacts (アーティファクトなし)] を選択します。

    • ビルド出力を S3 バケットに保存する場合は、[Amazon S3] を選択して次のいずれかの操作を行います。

      • ビルド出力ZIPファイルまたはフォルダにプロジェクト名を使用する場合は、名前を空白のままにします。それ以外の場合は、名前を入力します。デフォルトでは、アーティファクト名はプロジェクト名です。別の名前を使用する場合は、アーティファクト名ボックスに名前を入力します。ZIP ファイルを出力する場合は、zip 拡張子を含めます。

      • [Bucket name (バケット名)] で、出力バケットの名前を選択します。

      • この手順の前半でビルドコマンドを挿入を選択した場合は、出力ファイル に、ビルド出力ファイルまたはフォルダに入れるビルドのZIPファイルの場所を入力します。複数の場所の場合は、各場所をコンマで区切ります (例: appspec.yml, target/my-app.jar)。詳細については、「files」で buildspec の構文 の説明を参照してください。

  9. [Additional configuration (追加設定)] オプションを展開し、必要に応じてオプションを選択します。

  10. [Create build project (ビルドプロジェクトの作成)] を選択します。[確認] ページで、[ビルドの開始] を選択してビルドを実行します。