definisi variabel
Tentukan variabel menggunakan pasangan nama/nilai.
Definisi yang mereferensikan definisi ini: pipeline, stages.stage, jobs.job, jobs.deployment
Implementasi
Penerapan | Deskripsi |
---|---|
variabel: kamus string | Tentukan variabel menggunakan pasangan nama/nilai. |
variabel: daftar variabel | Tentukan variabel menurut nama, grup variabel, atau dalam templat. |
Keterangan
Kata variables
kunci menggunakan dua bentuk sintaks: daftar variabel dan pemetaan (kamus string).
Dalam sintaks pemetaan, semua kunci adalah nama variabel dan nilainya adalah nilai variabel. Untuk menggunakan templat variabel, Anda harus menggunakan sintaks daftar. Sintaks daftar mengharuskan Anda menentukan apakah Anda menyebutkan variabel (name
), grup variabel (group
), atau templat (template
).
Anda tidak dapat menggunakan variabel daftar dan pemetaan di bagian variabel yang sama, tetapi Anda dapat menggabungkan name
, group
, dan template
saat menggunakan sintaks daftar.
Anda dapat menentukan variabel di tingkat alur, tahap, atau pekerjaan.
variabel: kamus string
Tentukan variabel menggunakan pasangan nama/nilai.
variables:
string: string # Name/value pairs
Tidak ada.
Contoh
Untuk sekumpulan variabel yang dikodekan secara permanen, gunakan sintaks pemetaan ini:
variables: { string: string }
Variabel yang ditentukan pada cakupan yang berbeda:
variables: # pipeline-level
MY_VAR: 'my value'
ANOTHER_VAR: 'another value'
stages:
- stage: Build
variables: # stage-level
STAGE_VAR: 'that happened'
jobs:
- job: FirstJob
variables: # job-level
JOB_VAR: 'a job var'
steps:
- script: echo $(MY_VAR) $(STAGE_VAR) $(JOB_VAR)
variables: # pipeline-level
MY_VAR: 'my value'
ANOTHER_VAR: 'another value'
jobs:
- job: FirstJob
variables: # job-level
JOB_VAR: 'a job var'
steps:
- script: echo $(MY_VAR) $(STAGE_VAR) $(JOB_VAR)
variabel: daftar variabel
Tentukan variabel menurut nama, grup variabel, atau dalam templat.
variables: [ name | group | template ] # Define variables by name, variable group, or in a template.
Jenis daftar
Jenis | Deskripsi |
---|---|
variables.name | Tentukan variabel menggunakan nama dan sintaks penuh. |
variables.group | Variabel referensi dari grup variabel. |
variables.template | Tentukan variabel dalam templat. |
Contoh
Untuk menyertakan grup variabel, beralihlah ke sintaks urutan ini:
variables:
- name: string # name of a variable
value: string # value of the variable
- group: string # name of a variable group
Anda dapat mengulangi name
value
/pasangan dan group
.
Variabel juga dapat diatur sebagai baca saja untuk meningkatkan keamanan.
variables:
- name: myReadOnlyVar
value: myValue
readonly: true
Anda juga dapat menyertakan variabel dari templat.
Sintaks urutan:
variables:
- name: MY_VARIABLE # hard-coded value
value: some value
- group: my-variable-group-1 # variable group
- group: my-variable-group-2 # another variable group