Condividi tramite

definizione delle variabili

  • Articolo

Definire le variabili usando coppie nome/valore.

Definizioni che fanno riferimento a questa definizione: pipeline, stages.stage, jobs.job, jobs.deployment

Implementazioni

Implementazione Descrizione
variabili : dizionario di stringhe Definire le variabili usando coppie nome/valore.
variabili : elenco di variabili Definire le variabili in base al nome, al gruppo di variabili o in un modello.

Osservazioni:

La parola chiave variables usa due forme di sintassi: elenco di variabili e mapping (dizionario stringhe).

Nella sintassi di mapping, tutte le chiavi sono nomi di variabili e i relativi valori sono valori variabili. Per usare i modelli di variabile, è necessario usare la sintassi dell'elenco. La sintassi elenco richiede di specificare se si sta menzionando una variabile (name), un gruppo di variabili (group) o un modello (template).

Non è possibile usare variabili di elenco e mapping nella stessa sezione delle variabili, ma è possibile combinare name, groupe template quando si usa la sintassi di elenco.

È possibile specificare variabili a livello di pipeline, fase o processo.

variables: dizionario di stringhe

Definire le variabili usando coppie nome/valore.

variables:
  string: string # Name/value pairs

Nessuno.

Esempi

Per un semplice set di variabili hardcoded, usare questa sintassi di mapping:

variables: { string: string }

Variabili definite in ambiti diversi:

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)

variabili: elenco di variabili

Definire le variabili in base al nome, al gruppo di variabili o in un modello.

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

Tipi di elenco

TIPO Descrizione
variables.name Definire le variabili usando il nome e la sintassi completa.
variables.group Variabili di riferimento da un gruppo di variabili.
variables.template Definire le variabili in un modello.

Esempi

Per includere gruppi di variabili, passare a questa sintassi di sequenza:

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

È possibile ripetere name/value coppie e group.

Le variabili possono anche essere impostate come di sola lettura per migliorare la sicurezza.

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

È anche possibile includere variabili dai modelli.

Sintassi della sequenza:

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

Vedere anche