Variabel lingkungan di lingkungan build - AWS CodeBuild

View a markdown version of this page

Variabel lingkungan di lingkungan build - AWS CodeBuild

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 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.

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 stringCodeBuild-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 ataualias/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.

CODEBUILD_TERSELESAIKAN_VERSI_SUMBER

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 adalahCODEBUILD_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 adalahCODEBUILD_SOURCE_VERSION_<sourceIdentifier>, di mana pen <sourceIdentifier> gidentifikasi sumber yang Anda buat. Untuk informasi selengkapnya, lihat Beberapa sumber input dan sampel artefak keluaran.

CODEBUILD_SRC_DIR

Jalur direktori CodeBuild yang digunakan untuk build (misalnya,/tmp/src123456789/src).

Untuk sumber sekunder, variabel lingkungan untuk jalur direktori sumber sekunder adalahCODEBUILD_SRC_DIR_<sourceIdentifier>, di mana pen <sourceIdentifier> gidentifikasi sumber yang Anda buat. Untuk informasi selengkapnya, lihat Beberapa sumber input dan sampel artefak keluaran.

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

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 demikianpr/pull-request-number.

  • Untuk build yang dipicu dengan membuat cabang baru atau mendorong komit ke cabang, memang demikianbranch/branch-name.

  • Untuk build yang dipicu oleh mendorong tag ke repositori, memang demikiantag/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, lihatTutorial: Mengkonfigurasi pelari CodeBuild-hosted GitHub Actions.

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:

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 dan Panduan Manajer Sistem: Membuat dan menguji parameter String (konsol) di Panduan Pengguna Amazon EC2 Systems Manager. Untuk mengambilnya, lihat pem parameter-store etaan diSintaks Buildspec.

CODEBUILD_BUILD_URL

URL hasil build untuk build ini.