翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ビルド環境の環境変数 AWS CodeBuild には、ビルドコマンドで使用できる環境変数がいくつか用意されています。 AWS\_DEFAULT\_REGION ビルドが実行されている AWS リージョン ( など`us-east-1`)。この環境変数は、 AWS CLIで主に使用されます。 AWS\_REGION ビルドが実行されている AWS リージョン ( など`us-east-1`)。この環境変数は、主に AWS SDKs によって使用されます。 CODEBUILD\_BATCH\_BUILD\_IDENTIFIER バッチビルドでのビルドの識別子。これは、バッチの buildspec で指定されています。詳細については、「[バッチビルドのビルド仕様 (buildspec) のリファレンス](batch-build-buildspec.md)」を参照してください。 CODEBUILD\_BUILD\_ARN ビルドの Amazon リソースネーム (ARN) (例:`arn:aws:codebuild:{{region-ID}}:{{account-ID}}:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`)。 CODEBUILD\_BUILD\_ID ビルドの CodeBuild ID (例: `codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`)。 CODEBUILD\_BUILD\_IMAGE CodeBuild のビルドイメージ識別子 (例: `aws/codebuild/standard:2.0`)。 CODEBUILD\_BUILD\_NUMBER プロジェクトの現在のビルド番号。 CODEBUILD\_BUILD\_SUCCEEDING 現在のビルドが成功かどうか。ビルドが失敗の場合は `0` に設定され、成功の場合は `1` に設定されます。 CODEBUILD\_INITIATOR ビルドを開始したエンティティ。CodePipeline でビルドが開始された場合は、パイプラインの名前を表します (例: `codepipeline/my-demo-pipeline`)。ユーザーがビルドを開始した場合は、ユーザーの名前を表します (例: `MyUserName`)。CodeBuild の Jenkins プラグインがビルドを開始した場合、これは文字列「`CodeBuild-Jenkins-Plugin`」です。 CODEBUILD\_KMS\_KEY\_ID CodeBuild がビルド出力アーティファクトの暗号化に使用する AWS KMS キーの識別子 (例: `arn:aws:kms:{{region-ID}}:{{account-ID}}:key/{{key-ID}}`または `alias/{{key-alias}}`)。 CODEBUILD\_PROJECT\_ARN プロジェクトの Amazon リソースネーム (ARN) (例: `arn:aws:codebuild:{{region-ID}}:{{account-ID}}:project/{{project-name}}`)。 CODEBUILD\_PUBLIC\_BUILD\_URL パブリックビルドのウェブサイトにある、このビルドのビルド結果の URL。この変数は、ビルドプロジェクトでパブリックビルドが有効になっている場合にのみ設定されます。詳細については、「[パブリックビルドプロジェクトの URL を取得](public-builds.md)」を参照してください。 CODEBUILD\_RESOLVED\_SOURCE\_VERSION ビルドのソースコードのバージョンの識別子。内容は、以下のようなソースコードリポジトリによって異なります。 CodeCommit、GitHub、GitHub Enterprise Server、Bitbucket この変数には、コミット ID が含まれます。 CodePipeline この変数には、CodePipeline によって提供されるソースのリビジョンが含まれます。 ソースがバージョニングが有効になっていない Amazon S3 バケットである場合など、CodePipeline がソースリビジョンを解決できない場合、この環境変数は設定されません。 Amazon S3 この変数は設定されていません。 該当する場合、`CODEBUILD_RESOLVED_SOURCE_VERSION` 変数は、フェーズ `DOWNLOAD_SOURCE` の後でのみ利用可能です。 CODEBUILD\_SOURCE\_REPO\_URL 入力アーティファクトまたはソースコードリポジトリの URL。Amazon S3 では、これは `s3://` の後にバケット名と入力アーティファクトへのパスが続きます。CodeCommit および GitHub の場合、これはリポジトリのクローン URL です。CodePipeline から生成されたビルドの場合、この環境変数は空の場合があります。 セカンダリソースの場合、セカンダリソースリポジトリの URL の環境変数は「`CODEBUILD_SOURCE_REPO_URL_{{}}`」です。「`{{}}`」は、作成するソース識別子です。 CODEBUILD\_SOURCE\_VERSION 値の形式は、ソースコードリポジトリによって異なります。 + Amazon S3 では、入力アーティファクトに関連付けられたバージョン ID です。 + CodeCommit では、ビルドするソースコードのバージョンに関連付けられたコミット ID またはブランチ名です。 + GitHub、GitHub Enterprise Server、Bitbucket の場合、ビルドするソースコードのバージョンに関連付けられたコミット ID、ブランチ名、またはタグ名です。 **注記** Webhook プルリクエストイベントによりトリガーされた GitHub または GitHub Enterprise Server ビルドの場合、`pr/{{pull-request-number}}` です。 セカンダリソースの場合、セカンダリソースバージョンの環境変数は「`CODEBUILD_SOURCE_VERSION_{{}}`」です。「`{{}}`」は、作成するソース識別子です。詳細については、「[複数の入力ソースと出力アーティファクトのサンプル](sample-multi-in-out.md)」を参照してください。 CODEBUILD\_SRC\_DIR CodeBuild がビルドに使用するディレクトリパス (例: `/tmp/src123456789/src`)。 セカンダリソースの場合、ディレクトリパスの環境変数は「`CODEBUILD_SRC_DIR_{{}}`」です。「`{{}}`」は作成するソース識別子です。詳細については、「[複数の入力ソースと出力アーティファクトのサンプル](sample-multi-in-out.md)」を参照してください。 CODEBUILD\_START\_TIME Unix タイムスタンプとして指定されたビルドの開始時間 (ミリ秒単位)。 CODEBUILD\_WEBHOOK\_ACTOR\_ACCOUNT\_ID Webhook イベントをトリガーしたユーザーのアカウント ID。 CODEBUILD\_WEBHOOK\_BASE\_REF 現在のビルドをトリガーする Webhook イベントの基本参照名。プルリクエストでは、ブランチ参照を表します。 CODEBUILD\_WEBHOOK\_EVENT 現在のビルドをトリガーした Webhook イベント。 CODEBUILD\_WEBHOOK\_MERGE\_COMMIT ビルドに使用されるマージコミットの識別子。この変数は、Bitbucket プルリクエストがスカッシュ戦略とマージされ、プルリクエストブランチが閉じられたときに設定されます。この場合、元のプルリクエストコミットは存在しなくなるため、この環境変数には圧縮されたマージコミットの識別子が含まれます。 CODEBUILD\_WEBHOOK\_PREV\_COMMIT 現在のビルドをトリガーする Webhook プッシュイベントの前の最新のコミットの ID。 CODEBUILD\_WEBHOOK\_HEAD\_REF 現在のビルドをトリガーする Webhook イベントのヘッド参照名。ブランチ参照またはタグ参照を表します。 CODEBUILD\_WEBHOOK\_TRIGGER ビルドをトリガーした Webhook イベントを表示します。この変数は、Webhook によってトリガーされるビルドにのみ使用できます。値は、GitHub、GitHub Enterprise Server、または Bitbucket から CodeBuild に送信されたペイロードから解析されます。値の形式は、ビルドをトリガーしたイベントのタイプによって異なります。 + プルリクエストによってトリガーされたビルドの場合、`pr/{{pull-request-number}}` です。 + 新しいブランチを作成するか、ブランチにコミットをプッシュすることでトリガーされたビルドの場合、`branch/{{branch-name}}` です。 + タグをリポジトリにプッシュすることでトリガーされたビルドの場合、`tag/{{tag-name}}` です。 HOME この環境変数は常に「`/root`」に設定されます。 AWS CodeBuild は、セルフホスト型ランナービルドの一連の環境変数もサポートしています。CodeBuild セルフホスト型ランナーの詳細については、「[チュートリアル: CodeBuild がホストする GitHub Actions ランナーを設定](action-runner.md)」を参照してください。 CODEBUILD\_RUNNER\_OWNER セルフホスト型ランナーのビルドをトリガーするリポジトリの所有者です。 CODEBUILD\_RUNNER\_REPO セルフホスト型ランナーのビルドをトリガーするリポジトリの名前です。 CODEBUILD\_RUNNER\_REPO\_DOMAIN セルフホスト型ランナーのビルドをトリガーするリポジトリのドメインです。指定された GitHub Enterprise ビルドのみです。 CODEBUILD\_WEBHOOK\_LABEL ビルド中のビルドの上書きとセルフホスト型ランナーの設定に使用されるラベルです。 CODEBUILD\_WEBHOOK\_RUN\_ID ビルドに関連付けられたワークフローの実行 ID です。 CODEBUILD\_WEBHOOK\_JOB\_ID ビルドに関連付けられたジョブのジョブ ID です。 CODEBUILD\_WEBHOOK\_WORKFLOW\_NAME ウェブフックのリクエストペイロードに存在する場合、ビルドに関連付けられたワークフローの名前です。 CODEBUILD\_RUNNER\_WITH\_BUILDSPEC buildspec の上書きがセルフホスト型ランナーリクエストラベルで設定されている場合、これは `true` に設定されます。 独自の環境変数を持つビルド環境を提供することもできます。詳細については、以下のトピックを参照してください。 + [CodePipeline で CodeBuild を使用](how-to-create-pipeline.md) + [ビルドプロジェクトの作成](create-project.md) + [ビルドプロジェクト設定を変更](change-project.md) + [ビルドを手動で実行](run-build.md) + [ビルド仕様 (buildspec) に関するリファレンス](build-spec-ref.md) ビルド環境で使用できる環境変数を一覧表示するには、構築時に `printenv` コマンド (Linux ベースのビルド環境) または `"Get-ChildItem Env:"` (Windows ベースのビルド環境) を実行できます。前述のものを除いて、「`CODEBUILD_`」で始まる環境変数は、CodeBuild の内部使用のためのものです。それらはビルドコマンドで使用できません。 **重要** 環境変数を使用して機密値、特に AWS アクセスキー IDs。環境変数は、CodeBuild コンソールや AWS CLIなどのツールを使用してプレーンテキストで表示できます。 機密値は Amazon EC2 Systems Manager パラメータストアに保存後、ビルド仕様から取得することをお勧めします。重要な値を保存するには、*Amazon EC2 Systems Manager ユーザーガイド*の「[Systems Manager パラメータストア](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html)」および「[チュートリアル: String パラメータの作成とテスト (コンソール)](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-console.html)」を参照してください。これらを取得するには、「`parameter-store`」の [buildspec の構文](build-spec-ref.md#build-spec-ref-syntax) マッピングを参照してください。 CODEBUILD\_BUILD\_URL このビルドのビルド結果の URL。