definição de variáveis

  • Artigo

Defina variáveis usando pares nome/valor.

Definições que fazem referência a essa definição: pipeline, stages.stage, jobs.job, jobs.deployment

Definições que fazem referência a essa definição: pipeline, jobs.job

Implementações

Implementação Descrição
variáveis: dicionário de cadeia de caracteres Defina variáveis usando pares nome/valor.
variáveis: lista de variáveis Defina variáveis por nome, grupo de variáveis ou em um modelo.

Comentários

O variables palavra-chave usa dois formulários de sintaxe: lista e mapeamento de variáveis (dicionário de cadeia de caracteres).

Na sintaxe de mapeamento, todas as chaves são nomes de variável e os valores são valores de variável. Para usar modelos de variáveis, você deve usar a sintaxe de lista. A sintaxe de lista exige que você especifique se está mencionando uma variável (name), um grupo de variáveis (group) ou um modelo (template).

Você não pode usar variáveis de lista e mapeamento na mesma seção de variáveis, mas pode combinar name, groupe template ao usar a sintaxe de lista.

Você pode especificar variáveis no pipeline, estágio ou nível de trabalho.

variáveis: dicionário de cadeia de caracteres

Defina variáveis usando pares nome/valor.

variables:
  string: string # Name/value pairs

Nenhum.

Exemplos

Para um conjunto simples de variáveis embutidas em código, use esta sintaxe de mapeamento:

variables: { string: string }

Variáveis definidas em escopos diferentes:

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)

variáveis: lista de variáveis

Defina variáveis por nome, grupo de variáveis ou em um modelo.

variables: [ name | group | template ] # Define variables by name, variable group, or in a template.

Tipos de lista

Tipo Descrição
variables.name Defina variáveis usando nome e sintaxe completa.
variables.group Variáveis de referência de um grupo de variáveis.
variables.template Definir variáveis em um modelo.

Exemplos

Para incluir grupos de variáveis, alterne para esta sintaxe de sequência:

variables:
- name: string  # name of a variable
  value: string # value of the variable
- group: string # name of a variable group

Você pode repetir os pares name/value e group.

As variáveis também podem ser definidas como somente leitura para aprimorar a segurança.

variables:
- name: myReadOnlyVar
  value: myValue
  readonly: true

Você também pode incluir variáveis a partir de modelos.

Sintaxe de sequência:

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

Confira também