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

チュートリアル: CodeBuildホストされた GitHubアクションランナーを設定する

このチュートリアルでは、 GitHub アクションジョブを実行するように CodeBuild プロジェクトを設定する方法について説明します。で GitHub アクションを使用する方法の詳細については、 CodeBuild 「」を参照してくださいチュートリアル: CodeBuildホストされた GitHubアクションランナーを設定する。

このチュートリアルを完了するには、まず以下を行う必要があります。

ステップ 1: ウェブフックを使用してプロジェクトを作成する CodeBuild

このステップでは、ウェブフックを使用して CodeBuild プロジェクトを作成し、 GitHub コンソールで確認します。ソースプロバイダーとして GitHub Enterprise を選択することもできます。 GitHub Enterprise 内でウェブフックを作成する方法の詳細については、「」を参照してくださいGitHub 手動ウェブフック。

ステップ 2: アクションワークフローを更新する GitHub YAML

このステップでは、 の GitHub アクションワークフローYAMLファイルを更新GitHubしてビルド環境を設定し、 で GitHub アクションセルフホストランナーを使用します CodeBuild。詳細については、「セルフホストランナーでのラベルの使用」および「」を参照してください CodeBuildホストされた GitHub アクションランナーでサポートされているラベルオーバーライド。

アクションワークフローを更新する GitHub YAML

GitHub アクションワークフローruns-onの設定に移動GitHubして更新YAMLし、ビルド環境を設定します。これを行うには、次のいずれかで実行できます。

buildspec コマンドを実行する INSTALL、PRE_BUILD、および POST_BUILD フェーズ

デフォルトでは、セルフホスト GitHub アクションビルドを実行するときに、 は buildspec コマンド CodeBuild を無視します。ビルド中に buildspec コマンドを実行するには、ラベルにサフィックスとして buildspec-override:true を追加できます。

runs-on:
  - codebuild-<project-name>-${{ github.run_id }}-${{ github.run_attempt }}
  - buildspec-override:true

このコマンドを使用すると、 CodeBuild はコンテナのプライマリソースフォルダactions-runnerに というフォルダを作成します。 GitHub アクションランナーがBUILDフェーズ中に開始されると、ランナーは actions-runner ディレクトリで実行されます。

セルフホスト GitHub アクションビルドで buildspec オーバーライドを使用する場合、いくつかの制限があります。

ステップ 3: 結果を確認する

GitHub アクションワークフローが実行されるたびに、 はウェブフックを介してワークフロージョブイベント CodeBuild を受け取ります。ワークフロー内のジョブごとに、 は一時的な GitHub アクションランナーを実行するビルド CodeBuild を開始します。ランナーは、単一のワークフロージョブを実行する責任があります。ジョブが完了すると、ランナーと関連付けられたビルドプロセスはすぐに終了します。

ワークフロージョブログを表示するには、 のリポジトリに移動し GitHub、アクション を選択し、目的のワークフローを選択し、ログを確認する特定のジョブを選択します。

ジョブが でセルフホストランナーによってピックアップされるのを待っている間、ログでリクエストされたラベルを確認できます CodeBuild。

ジョブが完了すると、ジョブのログを表示できます。

フィルター GitHub アクションのウェブフックイベント (AWS CloudFormation）

テンプレートの AWS CloudFormation 次のYAMLフォーマットされた部分は、true と評価されたときにビルドをトリガーするフィルターグループを作成します。次のフィルターグループは、正規表現 に一致するワークフロー名を持つ GitHub アクションワークフロージョブリクエストを指定します\[CI-CodeBuild\]。

CodeBuildProject:
  Type: AWS::CodeBuild::Project
  Properties:
    Name: MyProject
    ServiceRole: service-role
    Artifacts:
      Type: NO_ARTIFACTS
    Environment:
      Type: LINUX_CONTAINER
      ComputeType: BUILD_GENERAL1_SMALL
      Image: aws/codebuild/standard:5.0
    Source:
      Type: GITHUB
      Location: CODEBUILD_DEFAULT_WEBHOOK_SOURCE_LOCATION
    Triggers:
      Webhook: true
      ScopeConfiguration:
        Name: organization-name
      FilterGroups:
        - - Type: EVENT
            Pattern: WORKFLOW_JOB_QUEUED
          - Type: WORKFLOW_NAME
            Pattern: \[CI-CodeBuild\]

フィルター GitHub アクションのウェブフックイベント (AWS CDK）

次の AWS CDK テンプレートは、ビルドが true と評価されたときにビルドをトリガーするフィルターグループを作成します。次のフィルターグループは、 GitHub アクションワークフロージョブリクエストを指定します。

import { aws_codebuild as codebuild } from 'aws-cdk-lib';
import {EventAction, FilterGroup} from "aws-cdk-lib/aws-codebuild";

const source = codebuild.Source.gitHub({
      owner: 'owner',
      repo: 'repo',
      webhook: true,
      webhookFilters: [FilterGroup.inEventOf(EventAction.WORKFLOW_JOB_QUEUED)],
    })

フィルター GitHub アクションのウェブフックイベント (Terraform)

次の Terraform テンプレートは、true と評価されたときにビルドをトリガーするフィルターグループを作成します。次のフィルターグループは、 GitHub アクションワークフロージョブリクエストを指定します。

resource "aws_codebuild_webhook" "example" {
  project_name = aws_codebuild_project.example.name
  build_type   = "BUILD"
  filter_group {
    filter {
      type    = "EVENT"
      pattern = "WORKFLOW_JOB_QUEUED"
    }
  }
}