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
AWS CodeBuildmenyediakan beberapa variabel lingkungan yang dapat Anda gunakan dalam perintah build Anda:
- AWS_DEFAULT_REGION
-
AWSWilayah tempat build berjalan (misalnya,
us-east-1
). Variabel lingkungan ini digunakan terutama olehAWS CLI. - AWS_REGION
-
AWSWilayah tempat build berjalan (misalnya,
us-east-1
). Variabel lingkungan ini digunakan terutama olehAWS SDK. - CODEBUILD_BATCH_BUILD_IDENTIFIER
-
Identifier dari membangun dalam batch membangun. Ini ditentukan dalam buildspec batch. Untuk informasi selengkapnya, lihat Batch membangun referensi buildspec.
- CODEBUILD_BUILD_ID
-
Amazon Resource Name (ARN) penerapan (misalnya,
arn:aws:codebuild:
).region-ID
:account-ID
:build/codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE - CODEBUILD_BUILD_ID
-
CodeBuildID build (misalnya,
codebuild-demo-project:b1e6661e-e4f2-4156-9ab9-82a19EXAMPLE
). - CODEBUILD_BUILD_IMAGE
-
CodeBuildBuild image identifier (misalnya,
aws/codebuild/standard:2.0
). - CODEBUILD_BUILD_NUMBER
-
Membangun saat ini untuk proyek.
- CODEBUILD_BUILD_SUCCEEDING
-
Apakah build saat ini berhasil. Setel ke
0
jika build gagal, atau1
jika build berhasil. - CODEBUILD_INITIATOR
-
Entitas yang memulai build. JikaCodePipeline mulai membangun, ini adalah nama pipa (misalnya,
codepipeline/my-demo-pipeline
). Jika pengguna memulai build, ini adalah nama pengguna (misalnya,MyUserName
). Jika plugin Jenkins untukCodeBuild memulai build, ini adalah stringCodeBuild-Jenkins-Plugin
. - CODEBUILD_KMS_KEY_ID
-
PengenalAWS KMS kunci yangCodeBuild digunakan untuk mengenkripsi artefak keluaran build (misalnya,
arn:aws:kms:
atauregion-ID
:account-ID
:key/key-ID
alias/
).key-alias
- CODEBUILD_LOG_PATH
-
Nama aliran log diCloudWatch Log untuk build.
- 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 Proyek pembangunan publik diAWS CodeBuild.
- CODEBUILD_RESOLVED_SOURCE_VERSION
-
Pengenal versi kode sumber build. Isi tergantung pada repositori kode sumber:
- CodeCommit,GitHub, ServerGitHub Perusahaan, dan Bitbucket
-
Variabel ini berisi ID komit.
- CodePipeline
-
Variabel ini berisi revisi sumber yang disediakan olehCodePipeline.
JikaCodePipeline tidak dapat menyelesaikan revisi sumber, seperti ketika sumber adalah bucket Amazon S3 yang tidak mengaktifkan versi, variabel lingkungan ini tidak disetel.
- Amazon S3
-
Variabel ini tidak diatur.
Bila berlaku,
CODEBUILD_RESOLVED_SOURCE_VERSION
variabel hanya tersedia setelahDOWNLOAD_SOURCE
fase. - CODEBUILD_SOURCE_REPO_URL
-
URL ke artefak masukan atau repositori kode sumber. Untuk Amazon S3, ini
s3://
diikuti dengan nama bucket dan jalur ke artefak input. UntukCodeCommit danGitHub, ini adalah URL klon repositori. Jika membangun berasal dariCodePipeline, variabel lingkungan ini mungkin kosong.Untuk sumber sekunder, variabel lingkungan untuk URL repositori sumber sekunder adalah
CODEBUILD_SOURCE_REPO_URL_
, di mana<sourceIdentifier>
pengidentifikasi sumber yang Anda buat.<sourceIdentifier>
- CODEBUILD_SOURCE_VERSION
-
Format nilai tergantung pada repositori sumber.
-
Untuk Amazon S3, ini adalah ID versi yang terkait dengan artefak input.
-
UntukCodeCommit, itu adalah ID komit atau nama cabang yang terkait dengan versi kode sumber yang akan dibangun.
-
UntukGitHub,GitHub Enterprise Server, dan Bitbucket adalah nama tanda yang terkait dengan versi kode sumber yang akan dibangun.
catatan
Untuk membangunGitHub atauGitHub Enterprise Server yang dipicu oleh acara permintaan tarik webhook, itu adalah
pr/
.pull-request-number
Untuk sumber sekunder, variabel lingkungan untuk versi sumber sekunder adalah
CODEBUILD_SOURCE_VERSION_
, di mana<sourceIdentifier>
pengidentifikasi sumber yang Anda buat. Untuk informasi selengkapnya, lihat Beberapa sumber input dan sampel artefak keluaran.<sourceIdentifier>
-
- CODEBUILD_SRC_DIR
-
Jalur direktori yangCodeBuild digunakan untuk build (misalnya,
/tmp/src123456789/src
).Untuk sumber sekunder, variabel lingkungan untuk jalur direktori sumber sekunder adalah
CODEBUILD_SRC_DIR_
, di mana<sourceIdentifier>
pengidentifikasi sumber yang Anda buat. Untuk informasi selengkapnya, lihat Beberapa sumber input dan sampel artefak keluaran.<sourceIdentifier>
- CODEBUILD_START_TIME
-
Waktu mulai build ditentukan sebagai stempel waktu Unix dalam milidetik.
- CODEBUILD_WEBHOOK_ACTOR_ACCOUNT_ID
-
ID akun pengguna yang memicu acara webhook.
- CODEBUILD_WEBHOOK_BASE_REF
-
Nama referensi dasar dari peristiwa webhook yang memicu build saat ini. Untuk pull request, ini adalah referensi cabang.
- CODEBUILD_WEBHOOK_EVENT
-
Acara webhook yang memicu penerapan penerapan saat ini.
- CODEBUILD_WEBHOOK_MERGE_COMMIT
-
Pengenal 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, commit pull request asli sudah tidak ada lagi, jadi variabel environment ini berisi identifier dari commit merge yang tergencet.
- CODEBUILD_WEBHOOK_PREV_COMMIT
-
ID dari commit terbaru sebelum peristiwa push webhook yang memicu build saat ini.
- CODEBUILD_WEBHOOK_HEAD_REF
-
Nama referensi kepala acara webhook yang memicu build saat ini. Ini bisa menjadi 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 keCodeBuild olehGitHub,GitHub Enterprise Server, atau Bitbucket. Format nilai tergantung pada jenis acara yang memicu build.
-
Untuk build yang dipicu oleh pull request, itu adalah
pr/
.pull-request-number
-
Untuk build yang dipicu dengan membuat cabang baru atau mendorong commit ke cabang, itu adalah
branch/
.branch-name
-
Untuk membangun dipicu oleh mendorong tag ke repositori, itu adalah
tag/
.tag-name
-
- RUMAH
-
Variabel lingkungan ini selalu diatur ke
/root
.
Anda juga dapat menyediakan lingkungan build dengan variabel lingkungan Anda sendiri. Untuk informasi lain, lihat topik berikut:
Untuk mencantumkan semua variabel lingkungan yang tersedia di lingkungan build, Anda dapat menjalankanprintenv
perintah (untuk lingkungan build berbasis Linux) atau"Get-ChildItem Env:"
(untuk lingkungan build berbasis Windows) selama build. Kecuali untuk yang sebelumnya terdaftar, variabel lingkungan yang dimulai denganCODEBUILD_
adalah untuk penggunaanCodeBuild internal. Mereka tidak boleh digunakan dalam perintah build Anda.
penting
Kami sangat mencegah penggunaan variabel lingkungan untuk menyimpan nilai sensitif, terutamaAWS mengakses ID kunci. variabel lingkungan dapat ditampilkan dalam teks biasa menggunakan alat-alat sepertiCodeBuild konsol danAWS 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 Penyimpanan dan Panduan Parameter Manajer Sistem: Membuat dan menguji parameter String (konsol) di Panduan Pengguna Amazon EC2 Systems Manager. Untuk mengambilnya, lihatparameter-store
pemetaan diSintaks Buildspec.