Compartir a través de

definición de variables

  • Artículo

Defina variables mediante pares nombre-valor.

Definiciones que hacen referencia a esta definición: canalización, stages.stage, jobs.job, jobs.deployment

Implementaciones

Implementación Descripción
variables: de diccionario de cadenas Defina variables mediante pares nombre-valor.
variables de : de lista de variables Defina variables por nombre, grupo de variables o en una plantilla.

Observaciones

La palabra clave variables 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 va a mencionar 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: 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 con 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 pares de 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 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