ビルド環境の環境変数 - AWS CodeBuild

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

ビルド環境の環境変数

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) のリファレンス」を参照してください。

CODEBUILD_BUILD_ARN

ビルドの Amazon リソースネーム (ARN) (例: arn:aws:codebuild:region-ID:account-ID:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE）。

CODEBUILDBUILD__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)。の Jenkins プラグインがビルド CodeBuild を開始した場合、これは文字列 ですCodeBuild-Jenkins-Plugin。

CODEBUILD_KMSKEY_ID

ビルド出力アーティファクトの暗号化に CodeBuild が使用している AWS KMS キーの識別子 (例: arn:aws:kms:region-ID:account-ID:key/key-IDまたは alias/key-alias）。

CODEBUILD_LOG_PATH

ビルドの Logs CloudWatch のログストリーム名。

CODEBUILD_PUBLIC_BUILD_URL

このビルドURLのビルド結果の は、パブリックビルドウェブサイトにあります。この変数は、ビルドプロジェクトでパブリックビルドが有効になっている場合にのみ設定されます。詳細については、「パブリックビルドプロジェクトを取得する URLs」を参照してください。

CODEBUILD_RESOLVED_SOURCE_VERSION

ビルドのソースコードのバージョンの識別子。内容は、以下のようなソースコードリポジトリによって異なります。

CodeCommit、 GitHub、 GitHub エンタープライズサーバー、Bitbucket

この変数には、コミット ID が含まれます。

CodePipeline

この変数には、 によって提供されるソースリビジョンが含まれます CodePipeline。

ソース CodePipeline がバージョニングが有効になっていない Amazon S3 バケットである場合など、 がソースリビジョンを解決できない場合、この環境変数は設定されません。

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_<sourceIdentifier>、 <sourceIdentifier>は作成するソース識別子です。

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_<sourceIdentifier>」です。「<sourceIdentifier>」は、作成するソース識別子です。詳細については、「複数の入力ソースと出力アーティファクトのサンプル」を参照してください。

CODEBUILD_SRC_DIR

がビルド CodeBuild に使用するディレクトリパス (例: /tmp/src123456789/src）。

セカンダリソースの場合、ディレクトリパスの環境変数は「CODEBUILD_SRC_DIR_<sourceIdentifier>」です。「<sourceIdentifier>」は作成するソース識別子です。詳細については、「複数の入力ソースと出力アーティファクトのサンプル」を参照してください。

CODEBUILD_START_TIME

Unix タイムスタンプとして指定されたビルドの開始時間 (ミリ秒単位)。

CODEBUILD_WEBHOOKACTOR_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 Enterprise Server GitHub、または Bitbucket CodeBuild によって に送信されたペイロードから解析されます。値の形式は、ビルドをトリガーしたイベントのタイプによって異なります。

  • プルリクエストによってトリガーされたビルドの場合、pr/pull-request-number です。

  • 新しいブランチを作成するか、ブランチにコミットをプッシュすることでトリガーされたビルドの場合、branch/branch-name です。

  • タグをリポジトリにプッシュすることでトリガーされたビルドの場合、tag/tag-name です。

HOME

この環境変数は常に「/root」に設定されます。

独自の環境変数を持つビルド環境を提供することもできます。詳細については、以下のトピックを参照してください。

ビルド環境で使用できる環境変数を一覧表示するには、構築時に printenv コマンド (Linux ベースのビルド環境) または "Get-ChildItem Env:" (Windows ベースのビルド環境) を実行できます。前述の環境変数を除き、 で始まる環境変数CODEBUILD_は CodeBuild 内部用です。それらはビルドコマンドで使用できません。

重要

機密値、特に AWS アクセスキー を保存するために環境変数を使用することは強くお勧めしませんIDs。環境変数は、 CodeBuild コンソールや などのツールを使用してプレーンテキストで表示できます AWS CLI。

Amazon EC2 Systems Manager パラメータストアに機密値を保存し、ビルド仕様から取得することをお勧めします。機密値を保存するには、「Amazon EC2 Systems Manager ユーザーガイド」の「Systems Manager パラメータストア」および「チュートリアル: 文字列パラメータの作成とテスト (コンソール）」を参照してください。これらを取得するには、「parameter-store」の buildspec の構文 マッピングを参照してください。