Compartir a través de


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, groupy 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

Consulte también