翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # ビルド環境の環境変数 AWS CodeBuild には、ビルドコマンドで使用できる環境変数がいくつか用意されています。 AWS\$1DEFAULT\$1REGION ビルドが実行されている AWS リージョン ( など`us-east-1`)。この環境変数は、 AWS CLIで主に使用されます。 AWS\$1REGION ビルドが実行されている AWS リージョン ( など`us-east-1`)。この環境変数は、主に AWS SDKs によって使用されます。 CODEBUILD\$1BATCH\$1BUILD\$1IDENTIFIER バッチビルドでのビルドの識別子。これは、バッチの buildspec で指定されています。詳細については、「[バッチビルドのビルド仕様 (buildspec) のリファレンス](batch-build-buildspec.md)」を参照してください。 CODEBUILD\$1BUILD\$1ARN ビルドの Amazon リソースネーム (ARN) (例:`arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`)。 CODEBUILD\$1BUILD\$1ID ビルドの CodeBuild ID (例: `codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`)。 CODEBUILD\$1BUILD\$1IMAGE CodeBuild のビルドイメージ識別子 (例: `aws/codebuild/standard:2.0`)。 CODEBUILD\$1BUILD\$1NUMBER プロジェクトの現在のビルド番号。 CODEBUILD\$1BUILD\$1SUCCEEDING 現在のビルドが成功かどうか。ビルドが失敗の場合は `0` に設定され、成功の場合は `1` に設定されます。 CODEBUILD\$1INITIATOR ビルドを開始したエンティティ。CodePipeline でビルドが開始された場合は、パイプラインの名前を表します (例: `codepipeline/my-demo-pipeline`)。ユーザーがビルドを開始した場合は、ユーザーの名前を表します (例: `MyUserName`)。CodeBuild の Jenkins プラグインがビルドを開始した場合、これは文字列「`CodeBuild-Jenkins-Plugin`」です。 CODEBUILD\$1KMS\$1KEY\$1ID CodeBuild がビルド出力アーティファクトの暗号化に使用する AWS KMS キーの識別子 (例: `arn:aws:kms:region-ID:account-ID:key/key-ID`または `alias/key-alias`)。 CODEBUILD\$1PROJECT\$1ARN プロジェクトの Amazon リソースネーム (ARN) (例: `arn:aws:codebuild:region-ID:account-ID:project/project-name`)。 CODEBUILD\$1PUBLIC\$1BUILD\$1URL パブリックビルドのウェブサイトにある、このビルドのビルド結果の URL。この変数は、ビルドプロジェクトでパブリックビルドが有効になっている場合にのみ設定されます。詳細については、「[パブリックビルドプロジェクトの URL を取得](public-builds.md)」を参照してください。 CODEBUILD\$1RESOLVED\$1SOURCE\$1VERSION ビルドのソースコードのバージョンの識別子。内容は、以下のようなソースコードリポジトリによって異なります。 CodeCommit、GitHub、GitHub Enterprise Server、Bitbucket この変数には、コミット ID が含まれます。 CodePipeline この変数には、CodePipeline によって提供されるソースのリビジョンが含まれます。 ソースがバージョニングが有効になっていない Amazon S3 バケットである場合など、CodePipeline がソースリビジョンを解決できない場合、この環境変数は設定されません。 Amazon S3 この変数は設定されていません。 該当する場合、`CODEBUILD_RESOLVED_SOURCE_VERSION` 変数は、フェーズ `DOWNLOAD_SOURCE` の後でのみ利用可能です。 CODEBUILD\$1SOURCE\$1REPO\$1URL 入力アーティファクトまたはソースコードリポジトリの URL。Amazon S3 では、これは `s3://` の後にバケット名と入力アーティファクトへのパスが続きます。CodeCommit および GitHub の場合、これはリポジトリのクローン URL です。CodePipeline から生成されたビルドの場合、この環境変数は空の場合があります。 セカンダリソースの場合、セカンダリソースリポジトリの URL の環境変数は「`CODEBUILD_SOURCE_REPO_URL_`」です。「``」は、作成するソース識別子です。 CODEBUILD\$1SOURCE\$1VERSION 値の形式は、ソースコードリポジトリによって異なります。 + 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\$1SRC\$1DIR CodeBuild がビルドに使用するディレクトリパス (例: `/tmp/src123456789/src`)。 セカンダリソースの場合、ディレクトリパスの環境変数は「`CODEBUILD_SRC_DIR_`」です。「``」は作成するソース識別子です。詳細については、「[複数の入力ソースと出力アーティファクトのサンプル](sample-multi-in-out.md)」を参照してください。 CODEBUILD\$1START\$1TIME Unix タイムスタンプとして指定されたビルドの開始時間 (ミリ秒単位)。 CODEBUILD\$1WEBHOOK\$1ACTOR\$1ACCOUNT\$1ID Webhook イベントをトリガーしたユーザーのアカウント ID。 CODEBUILD\$1WEBHOOK\$1BASE\$1REF 現在のビルドをトリガーする Webhook イベントの基本参照名。プルリクエストでは、ブランチ参照を表します。 CODEBUILD\$1WEBHOOK\$1EVENT 現在のビルドをトリガーした Webhook イベント。 CODEBUILD\$1WEBHOOK\$1MERGE\$1COMMIT ビルドに使用されるマージコミットの識別子。この変数は、Bitbucket プルリクエストがスカッシュ戦略とマージされ、プルリクエストブランチが閉じられたときに設定されます。この場合、元のプルリクエストコミットは存在しなくなるため、この環境変数には圧縮されたマージコミットの識別子が含まれます。 CODEBUILD\$1WEBHOOK\$1PREV\$1COMMIT 現在のビルドをトリガーする Webhook プッシュイベントの前の最新のコミットの ID。 CODEBUILD\$1WEBHOOK\$1HEAD\$1REF 現在のビルドをトリガーする Webhook イベントのヘッド参照名。ブランチ参照またはタグ参照を表します。 CODEBUILD\$1WEBHOOK\$1TRIGGER ビルドをトリガーした 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\$1RUNNER\$1OWNER セルフホスト型ランナーのビルドをトリガーするリポジトリの所有者です。 CODEBUILD\$1RUNNER\$1REPO セルフホスト型ランナーのビルドをトリガーするリポジトリの名前です。 CODEBUILD\$1RUNNER\$1REPO\$1DOMAIN セルフホスト型ランナーのビルドをトリガーするリポジトリのドメインです。指定された GitHub Enterprise ビルドのみです。 CODEBUILD\$1WEBHOOK\$1LABEL ビルド中のビルドの上書きとセルフホスト型ランナーの設定に使用されるラベルです。 CODEBUILD\$1WEBHOOK\$1RUN\$1ID ビルドに関連付けられたワークフローの実行 ID です。 CODEBUILD\$1WEBHOOK\$1JOB\$1ID ビルドに関連付けられたジョブのジョブ ID です。 CODEBUILD\$1WEBHOOK\$1WORKFLOW\$1NAME ウェブフックのリクエストペイロードに存在する場合、ビルドに関連付けられたワークフローの名前です。 CODEBUILD\$1RUNNER\$1WITH\$1BUILDSPEC 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\$1BUILD\$1URL このビルドのビルド結果の URL。