definición de variables
Defina variables mediante pares nombre-valor.
Definiciones que hacen referencia a esta definición: canalización, stages.stage, jobs.job, jobs.deployment
Definiciones que hacen referencia a esta definición: canalización, jobs.job
Implementaciones
Implementación | Descripción |
---|---|
variables: diccionario de cadenas | Defina variables mediante pares nombre-valor. |
variables: lista de variables | Defina variables por nombre, grupo de variables o en una plantilla. |
Comentarios
La variables
palabra clave usa dos formas de sintaxis: lista de variables y asignación (diccionario de cadenas).
En la sintaxis de asignación, todas las claves son nombres de variable y sus valores son valores de variable. Para usar plantillas de variables, debe usar la sintaxis de lista. La sintaxis de lista requiere especificar si está mencionando una variable (name
), un grupo de variables (group
) o una plantilla (template
).
No puede usar variables de lista y asignación en la misma sección de variables, pero puede combinar name
, group
y template
al usar la sintaxis de lista.
Puede especificar variables en el nivel de canalización, fase o trabajo.
variables: diccionario de cadenas
Defina variables mediante pares nombre-valor.
variables:
string: string # Name/value pairs
Ninguno.
Ejemplos
Para un conjunto sencillo de variables codificadas de forma rígida, use esta sintaxis de asignación:
variables: { string: string }
Variables definidas en distintos ámbitos:
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)
variables: lista de variables
Defina variables por nombre, grupo de variables o en una plantilla.
variables: [ name | group | template ] # Define variables by name, variable group, or in a template.
Tipos de lista
Tipo | Descripción |
---|---|
variables.name | Defina variables mediante el nombre y la sintaxis completa. |
variables.group | Variables de referencia de un grupo de variables. |
variables.template | Defina variables en una plantilla. |
Ejemplos
Para incluir grupos de variables, cambie a esta sintaxis de secuencia:
variables:
- name: string # name of a variable
value: string # value of the variable
- group: string # name of a variable group
Puede repetir los pares name
/value
y group
.
Las variables también se pueden establecer como de solo lectura para mejorar la seguridad.
variables:
- name: myReadOnlyVar
value: myValue
readonly: true
También puede incluir variables de plantillas.
Sintaxis de secuencia:
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