

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:

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

AWS\_REGION  
 AWS Wilayah 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 buildspec batch. 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  
Pengidentifikasi image CodeBuild build (misalnya,`aws/codebuild/standard:2.0`).

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

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

CODEBUILD\_INITIATOR  
Entitas yang memulai pembangunan. Jika CodePipeline memulai pembuatan, 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 build, 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) 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 memiliki build publik yang diaktifkan. Untuk informasi selengkapnya, lihat [Dapatkan URL proyek build publik](public-builds.md).

CODEBUILD\_RESOLVED\_SOURCE\_VERSION  <a name="CODEBUILD_RESOLVED_SOURCE_VERSION"></a>
Pengidentifikasi versi kode sumber build. Konten tergantung pada repositori kode sumber:    
CodeCommit, GitHub, Server GitHub Perusahaan, dan Bitbucket  
Variabel ini berisi ID komit.  
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 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 path ke artefak input. Untuk CodeCommit dan GitHub, ini adalah URL klon repositori. Jika build berasal CodePipeline, variabel lingkungan ini mungkin kosong.  
Untuk sumber sekunder, variabel lingkungan untuk URL repositori sumber sekunder adalah`CODEBUILD_SOURCE_REPO_URL_{{<sourceIdentifier>}}`, di mana `{{<sourceIdentifier>}}` pengenal sumber yang Anda buat. 

CODEBUILD\_SOURCE\_VERSION  
Format nilai tergantung pada repositori sumber.  
+ Untuk Amazon S3, ini adalah ID versi yang terkait dengan artefak input.
+ Untuk CodeCommit, itu 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 komit, nama cabang, atau nama tag yang terkait dengan versi kode sumber yang akan dibangun.
**catatan**  
Untuk build Server GitHub atau GitHub Enterprise yang dipicu oleh peristiwa permintaan tarik webhook, itu adalah`pr/{{pull-request-number}}`.
Untuk sumber sekunder, variabel lingkungan untuk versi sumber sekunder adalah`CODEBUILD_SOURCE_VERSION_{{<sourceIdentifier>}}`, di mana `{{<sourceIdentifier>}}` pengenal 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 yang CodeBuild digunakan untuk build (misalnya,`/tmp/src123456789/src`).  
Untuk sumber sekunder, variabel lingkungan untuk jalur direktori sumber sekunder adalah`CODEBUILD_SRC_DIR_{{<sourceIdentifier>}}`, di mana `{{<sourceIdentifier>}}` pengenal sumber yang Anda buat. Untuk informasi selengkapnya, lihat [Beberapa sumber input dan sampel artefak keluaran](sample-multi-in-out.md).

CODEBUILD\_START\_TIME  
Waktu mulai build ditentukan sebagai stempel waktu Unix dalam milidetik.

CODEBUILD\_WEBHOOK\_ACTOR\_ACCOUNT\_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 pull request ditutup. Dalam kasus ini, komit permintaan tarik asli tidak ada lagi, jadi variabel lingkungan ini berisi pengidentifikasi komit gabungan yang terjepit.

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  
Menampilkan peristiwa webhook yang memicu build. Variabel ini hanya tersedia untuk build yang dipicu oleh webhook. Nilai diuraikan dari payload yang dikirim CodeBuild oleh GitHub, GitHub Enterprise Server, atau Bitbucket. Format nilai bergantung pada jenis peristiwa apa yang memicu build.  
+ Untuk build yang dipicu oleh permintaan tarik, memang `pr/{{pull-request-number}}` demikian. 
+ Untuk build yang dipicu dengan membuat cabang baru atau mendorong komit ke cabang, itu `branch/{{branch-name}}` benar. 
+ Untuk build yang dipicu oleh mendorong tag ke repositori, itu benar. `tag/{{tag-name}}` 

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

AWS CodeBuild juga mendukung satu set variabel lingkungan untuk build runner yang dihosting sendiri. Untuk mempelajari selengkapnya tentang pelari yang CodeBuild dihosting sendiri, lihat. [Tutorial: Konfigurasikan pelari CodeBuild-hosted GitHub Tindakan](action-runner.md)

CODEBUILD\_RUNNER\_OWNER  
Pemilik repositori yang memicu build runner yang dihosting 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 dihosting sendiri. Hanya build GitHub Enterprise yang ditentukan.

CODEBUILD\_WEBHOOK\_LABEL  
Label yang digunakan untuk mengonfigurasi penggantian build dan runner yang dihosting sendiri selama pembuatan.

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

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

CODEBUILD\_WEBHOOK\_WORKFLOW\_NAME  
Nama alur kerja yang terkait dengan build jika ada di payload permintaan webhook.

CODEBUILD\_RUNNER\_WITH\_BUILDSPEC  
Jika penggantian buildspec dikonfigurasi dalam label permintaan runner yang dihosting 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 mencantumkan 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 untuk yang terdaftar sebelumnya, variabel lingkungan yang dimulai `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 AWS mengakses ID kunci. Variabel lingkungan dapat ditampilkan dalam teks biasa menggunakan alat seperti CodeBuild konsol dan AWS CLI.  
Kami menyarankan Anda menyimpan nilai sensitif di Amazon EC2 Systems Manager Parameter Store dan kemudian mengambilnya dari buildspec Anda. Untuk menyimpan nilai sensitif, lihat [Systems Manager Parameter Store](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-paramstore.html) and [Walkthrough: 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 `parameter-store` pemetaan di. [Sintaks Buildspec](build-spec-ref.md#build-spec-ref-syntax)

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