

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Variabel lingkungan di lingkungan build
<a name="build-env-ref-env-vars"></a>

AWS CodeBuild menyediakan beberapa variabel lingkungan yang dapat Anda gunakan dalam perintah build Anda:

AWS\_DEFAULT\_REGION  
Wil AWS ayah tempat build berjalan (misalnya,`us-east-1`). Variabel lingkungan ini digunakan terutama oleh AWS CLI.

AWS\_REGION  
Wil AWS ayah tempat build berjalan (misalnya,`us-east-1`). Variabel lingkungan ini digunakan terutama oleh AWS SDK.

CODEBUILD\_BATCH\_BUILD\_IDENTIFIER  
Pengidentifikasi build dalam build batch. Ini ditentukan dalam batch buildspec. Untuk informasi selengkapnya, lihat [Referensi buildspec build batch](batch-build-buildspec.md).

CODEBUILD\_BUILD\_ARN  
Nama Sumber Daya Amazon (ARN) dari build (misalnya,`arn:aws:codebuild:{{region-ID}}:{{account-ID}}:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`).

CODEBUILD\_BUILD\_ID  
 CodeBuild ID build (misalnya,`codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE`).

CODEBUILD\_BUILD\_IMAGE  
Pen CodeBuild gidentifikasi gambar build (misalnya,`aws/codebuild/standard:2.0`).

CODEBUILD\_BUILD\_NUMBER  
Nomor build saat ini untuk proyek.

CODEBUILD\_BUILD\_SUCCESS  
Apakah pembangunan saat ini berhasil. Setel ke `0` jika build gagal, atau `1` jika build berhasil.

CODEBUILD\_INITIATOR  
Entitas yang memulai pembangunan. Jika CodePipeline memulai pembangunan, ini adalah nama pipeline (misalnya,`codepipeline/my-demo-pipeline`). Jika pengguna memulai build, ini adalah nama pengguna (misalnya,`MyUserName`). Jika plugin Jenkins untuk CodeBuild memulai pembangunan, ini adalah string`CodeBuild-Jenkins-Plugin`.

CODEBUILD\_KMS\_KEY\_ID  
Pengidentifikasi AWS KMS kunci yang CodeBuild digunakan untuk mengenkripsi artefak keluaran build (misalnya, `arn:aws:kms:{{region-ID}}:{{account-ID}}:key/{{key-ID}}` atau`alias/{{key-alias}}`).

CODEBUILD\_PROJECT\_ARN  
Nama Sumber Daya Amazon (ARN) dari proyek (misalnya,`arn:aws:codebuild:{{region-ID}}:{{account-ID}}:project/{{project-name}}`).

CODEBUILD\_PUBLIC\_BUILD\_URL  
URL hasil build untuk build ini di situs web build publik. Variabel ini hanya disetel jika proyek build mengaktifkan build publik. Untuk informasi selengkapnya, lihat [Dapatkan URL proyek build publik](public-builds.md).

CODEBUILD\_TERSELESAIKAN\_VERSI\_SUMBER  <a name="CODEBUILD_RESOLVED_SOURCE_VERSION"></a>
Pengidentifikasi versi dari kode sumber build. Isinya tergantung pada repositori kode sumber:    
CodeCommit, GitHub, Server GitHub Perusahaan, dan Bitbucket  
Variabel ini berisi Commit ID.  
CodePipeline  
Variabel ini berisi revisi sumber yang disediakan oleh CodePipeline.   
Jika CodePipeline tidak dapat menyelesaikan revisi sumber, seperti ketika sumbernya adalah bucket Amazon S3 yang tidak mengaktifkan pembuatan versi, variabel lingkungan ini tidak disetel.  
Amazon S3  
Variabel ini tidak diatur.
Jika berlaku, `CODEBUILD_RESOLVED_SOURCE_VERSION` variabel hanya tersedia setelah `DOWNLOAD_SOURCE` fase. 

CODEBUILD\_SOURCE\_REPO\_URL  
URL ke artefak input atau repositori kode sumber. Untuk Amazon S3, ini `s3://` diikuti oleh nama bucket dan jalur ke artefak input. Untuk CodeCommit dan GitHub, ini adalah URL klon repositori. Jika build berasal dari CodePipeline, variabel lingkungan ini mungkin kosong.  
Untuk sumber sekunder, variabel lingkungan untuk URL repositori sumber sekunder adalah`CODEBUILD_SOURCE_REPO_URL_{{<sourceIdentifier>}}`, di mana pen `{{<sourceIdentifier>}}` gidentifikasi sumber yang Anda buat. 

KODEBUILD\_VERSI\_SUMBER  
Format nilai tergantung pada repositori sumber.  
+ Untuk Amazon S3, ini adalah ID versi yang terkait dengan artefak input.
+ Untuk CodeCommit, ini adalah ID komit atau nama cabang yang terkait dengan versi kode sumber yang akan dibangun.
+ Untuk GitHub, GitHub Enterprise Server, dan Bitbucket itu adalah ID commit, nama cabang, atau nama tag yang terkait dengan versi kode sumber yang akan dibangun.
**catatan**  
Untuk build Server GitHub Perusahaan GitHub atau yang dipicu oleh peristiwa permintaan tarik webhook, memang `pr/{{pull-request-number}}` demikian.
Untuk sumber sekunder, variabel lingkungan untuk versi sumber sekunder adalah`CODEBUILD_SOURCE_VERSION_{{<sourceIdentifier>}}`, di mana pen `{{<sourceIdentifier>}}` gidentifikasi sumber yang Anda buat. Untuk informasi selengkapnya, lihat [Beberapa sumber input dan sampel artefak keluaran](sample-multi-in-out.md).

CODEBUILD\_SRC\_DIR  
Jalur direktori CodeBuild yang digunakan untuk build (misalnya,`/tmp/src123456789/src`).  
Untuk sumber sekunder, variabel lingkungan untuk jalur direktori sumber sekunder adalah`CODEBUILD_SRC_DIR_{{<sourceIdentifier>}}`, di mana pen `{{<sourceIdentifier>}}` gidentifikasi sumber yang Anda buat. Untuk informasi selengkapnya, lihat [Beberapa sumber input dan sampel artefak keluaran](sample-multi-in-out.md).

KODEBUILD\_WAKTU\_MULAI  
Waktu mulai build ditentukan sebagai stempel waktu Unix dalam milidetik.

CODEBUILD\_WEBHOOK\_ACTOR\_AKUN\_ID  
ID akun pengguna yang memicu peristiwa webhook.

CODEBUILD\_WEBHOOK\_BASE\_REF  
Nama referensi dasar dari peristiwa webhook yang memicu build saat ini. Untuk permintaan tarik, ini adalah referensi cabang.

CODEBUILD\_WEBHOOK\_EVENT  
Peristiwa webhook yang memicu build saat ini.

CODEBUILD\_WEBHOOK\_MERGE\_COMMIT  <a name="CODEBUILD_WEBHOOK_MERGE_COMMIT"></a>
Pengidentifikasi komit gabungan yang digunakan untuk build. Variabel ini diatur ketika permintaan tarik Bitbucket digabungkan dengan strategi squash dan cabang permintaan tarik ditutup. Dalam hal ini, komit permintaan tarik asli tidak ada lagi, jadi variabel lingkungan ini berisi pengenal komit gabungan yang dihancurkan.

CODEBUILD\_WEBHOOK\_PREV\_COMMIT  
ID komit terbaru sebelum acara push webhook yang memicu build saat ini.

CODEBUILD\_WEBHOOK\_HEAD\_REF  
Nama referensi kepala dari peristiwa webhook yang memicu build saat ini. Ini bisa berupa referensi cabang atau referensi tag.

CODEBUILD\_WEBHOOK\_TRIGGER  
Menunjukkan peristiwa webhook yang memicu build. Variabel ini hanya tersedia untuk build yang dipicu oleh webhook. Nilai diurai dari payload yang dikirim CodeBuild oleh GitHub, GitHub Enterprise Server, atau Bitbucket. Format nilai tergantung pada jenis peristiwa apa yang memicu build.  
+ Untuk build yang dipicu oleh permintaan tarik, memang demikian`pr/{{pull-request-number}}`. 
+ Untuk build yang dipicu dengan membuat cabang baru atau mendorong komit ke cabang, memang demikian`branch/{{branch-name}}`. 
+ Untuk build yang dipicu oleh mendorong tag ke repositori, memang demikian`tag/{{tag-name}}`. 

RUMAH  
Variabel lingkungan ini selalu disetel ke`/root`.

AWS CodeBuild juga mendukung satu set variabel lingkungan untuk build pelari yang di-host sendiri. Untuk mempelajari lebih lanjut tentang pelari CodeBuild yang dihosting sendiri, lihat[Tutorial: Mengkonfigurasi pelari CodeBuild-hosted GitHub Actions](action-runner.md).

CODEBUILD\_RUNNER\_OWNER  
Pemilik repositori yang memicu build runner yang di-host sendiri.

CODEBUILD\_RUNNER\_REPO  
Nama repositori yang memicu build runner yang di-host sendiri.

CODEBUILD\_RUNNER\_REPO\_DOMAIN  
Domain repositori yang memicu build runner yang di-host sendiri. Hanya build GitHub Enterprise yang ditentukan.

CODEBUILD\_WEBHOOK\_LABEL  
Label yang digunakan untuk mengonfigurasi penggantian build dan pelari yang di-host sendiri selama pembuatan.

CODEBUILD\_WEBHOOK\_RUN\_ID  
ID run alur kerja yang terkait dengan build.

CODEBUILD\_WEBHOOK\_JOB\_ID  
ID pekerjaan dari pekerjaan yang terkait dengan build.

CODEBUILD\_WEBHOOK\_NAMA\_ALUR KERJA  
Nama alur kerja yang terkait dengan build jika ada di payload permintaan webhook.

CODEBUILD\_RUNNER\_DENGAN\_BUILDSPEC  
Jika penggantian buildspec dikonfigurasi di label permintaan pelari yang di-host sendiri, ini disetel ke. `true`

Anda juga dapat menyediakan lingkungan build dengan variabel lingkungan Anda sendiri. Untuk informasi selengkapnya, lihat topik berikut:
+ [Gunakan CodeBuild dengan CodePipeline](how-to-create-pipeline.md)
+ [Membuat proyek build](create-project.md)
+ [Ubah pengaturan proyek build](change-project.md)
+ [Jalankan build secara manual](run-build.md)
+ [Referensi Buildspec](build-spec-ref.md)

Untuk membuat daftar semua variabel lingkungan yang tersedia di lingkungan build, Anda dapat menjalankan `printenv` perintah (untuk lingkungan Linux-based build) atau `"Get-ChildItem Env:"` (untuk lingkungan Windows-based build) selama build. Kecuali yang terdaftar sebelumnya, variabel lingkungan yang dimulai dengan `CODEBUILD_` adalah untuk penggunaan CodeBuild internal. Mereka tidak boleh digunakan dalam perintah build Anda.

**penting**  
Kami sangat tidak menyarankan penggunaan variabel lingkungan untuk menyimpan nilai sensitif, terutama ID kunci AWS akses. Variabel lingkungan dapat ditampilkan dalam teks biasa menggunakan alat seperti CodeBuild konsol dan AWS CLI.  
Kami sarankan Anda menyimpan nilai sensitif di Amazon EC2 Systems Manager Parameter Store dan kemudian mengambilnya dari buildspec Anda. Untuk menyimpan nilai sensitif, lihat Peny [ impanan Parameter ](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html) dan [ Panduan Manajer Sistem: Membuat dan menguji parameter String (konsol) ](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-console.html) di Panduan * Pengguna * Amazon EC2 Systems Manager. Untuk mengambilnya, lihat pem `parameter-store` etaan di[Sintaks Buildspec](build-spec-ref.md#build-spec-ref-syntax).

CODEBUILD\_BUILD\_URL  
URL hasil build untuk build ini.