GitHub Actions ワークフロー YAML では、セルフホスト型ランナーのビルドを変更するさまざまなラベルの上書きを指定できます。CodeBuild で認識されないビルドは無視されますが、ウェブフックリクエストは失敗しません。例えば、次のワークフロー YAML には、イメージ、インスタンスサイズ、フリート、および buildspec の上書きが含まれます。
name: Hello World
on: [push]
jobs:
Hello-World-Job:
runs-on:
- codebuild-myProject-${{ github.run_id }}-${{ github.run_attempt }}
- image:${{ matrix.os }}
- instance-size:${{ matrix.size }}
- fleet:myFleet
- buildspec-override:true
strategy:
matrix:
include:
- os: arm-3.0
size: small
- os: al2-5.0
size: large
steps:
- run: echo "Hello World!"
codebuild-
(必須)<project-name>
-${{github.run_id}}-${{github.run_attempt}}
例:
codebuild-fake-project-${{ github.run_id }}-${{ github.run_attempt }}
-
すべての GitHub Actions ワークフロー YAML に必須です。
<project name>
は、セルフホスト型ランナーウェブフックが設定されているプロジェクトの名前と同じである必要があります。
image:
<environment-type>
-<image-identifier>
例:
image:arm-3.0
-
セルフホスト型ランナーのビルドの開始時に使用するイメージと環境タイプを上書きします。サポートされている値については、「CodeBuild がホストする GitHub Actions ランナーでサポートされているコンピューティングイメージ」を参照してください。
instance-size:
<instance-size>
例:
instance-size:medium
-
セルフホスト型ランナーのビルドの開始時に使用するインスタンスタイプを上書きします。サポートされている値については、「CodeBuild がホストする GitHub Actions ランナーでサポートされているコンピューティングイメージ」を参照してください。
fleet:
<fleet-name>
例:
fleet:myFleet
-
指定されたフリートを使用するために、プロジェクトに設定されたフリート設定を上書きします。詳細については、「リザーブドキャパシティキャパシティフリートでビルドを実行」を参照してください。
buildspec-override:
<boolean>
例:
buildspec-override:true
-
true
に設定されている場合、ビルドがINSTALL
、PRE_BUILD
、およびPOST_BUILD
フェーズで buildspec コマンドを実行できるようにします。
単一ラベルの上書き (レガシー)
CodeBuild では、以下を使用して、単一のラベルに複数の上書きを指定できます。
-
Amazon EC2/Lambda コンピューティングビルドの環境設定を上書きするには、次の構文を使用します。
runs-on: codebuild-
<project-name>
-${{ github.run_id }}-${{ github.run_attempt }}-<environment-type>
-<image-identifier>
-<instance-size>
-
Amazon EC2 コンピューティングビルドのフリート設定を上書きするには、次の構文を使用します。
runs-on: codebuild-
<project-name>
-${{ github.run_id }}-${{ github.run_attempt }}-fleet-<fleet-name>
-
ビルドに使用されるフリートとイメージの両方を上書きするには、次の構文を使用します。
runs-on: codebuild-
<project-name>
-${{ github.run_id }}-${{ github.run_attempt }}-image
-<image-version>
-fleet-<fleet-name>
-
ビルド中に buildspec コマンドを実行するには、ラベルにサフィックスとして
-with-buildspec
を追加できます。runs-on: codebuild-
<project-name>
-${{ github.run_id }}-${{ github.run_attempt }}-<image>
-<image-version>
-<instance-size>
-with-buildspec -
オプションで、イメージを上書きせずにインスタンスサイズの上書きを指定できます。Amazon EC2 ビルドでは、環境タイプとイメージ識別子の両方を除外できます。Lambda ビルドでは、イメージ識別子を除外できます。