Partilhar via


definição de variáveis

Defina variáveis com pares nome/valor.

Definições que referenciam esta definição: pipeline, stages.stage, jobs.job, jobs.deployment

Definições que referenciam esta definição: pipeline, jobs.job

Implementações

Implementação Descrição
variables: string dictionary Defina variáveis com pares nome/valor.
variáveis: lista de variáveis Definir variáveis por nome, grupo de variáveis ou num modelo.

Observações

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

Na sintaxe de mapeamento, todas as chaves são nomes de variáveis e os respetivos valores são valores variáveis. Para utilizar modelos de variáveis, tem de utilizar a sintaxe da lista. A sintaxe da lista requer que especifique se está a mencionar uma variável (name), um grupo de variáveis (group) ou um modelo (template).

Não pode utilizar variáveis de lista e mapeamento na mesma secção de variáveis, mas pode combinar name, groupe template ao utilizar a sintaxe da lista.

Pode especificar variáveis ao nível do pipeline, da fase ou da tarefa.

variables: string dictionary

Defina variáveis com pares nome/valor.

variables:
  string: string # Name/value pairs

Nenhum.

Exemplos

Para um conjunto simples de variáveis codificadas, utilize esta sintaxe de mapeamento:

variables: { string: string }

Variáveis definidas em diferentes â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)

variáveis: lista de variáveis

Definir variáveis por nome, grupo de variáveis ou num modelo.

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

Tipos de lista

Tipo Description
variables.name Defina variáveis com o nome e a sintaxe completa.
variables.group Referenciar variáveis de um grupo de variáveis.
variables.template Definir variáveis num modelo.

Exemplos

Para incluir grupos de variáveis, mude 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

Pode repetir name/value pares e .group

As variáveis também podem ser definidas como só de leitura para melhorar a segurança.

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

Também pode incluir variáveis 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

Ver também