Delen via


definitie van variabelen

Definieer variabelen met behulp van naam-waardeparen.

Definities die naar deze definitie verwijzen: pipeline, stages.stage, jobs.job, jobs.deployment

Definities die naar deze definitie verwijzen: pipeline, jobs.job

Implementaties

Implementatie Beschrijving
variabelen: tekenreekswoordenlijst Definieer variabelen met behulp van naam-waardeparen.
variabelen: lijst met variabelen Variabelen definiëren op naam, variabelegroep of in een sjabloon.

Opmerkingen

Het variables trefwoord maakt gebruik van twee syntaxisvormen: variabelenlijst en toewijzing (tekenreekswoordenlijst).

In de toewijzingssyntaxis zijn alle sleutels variabelenamen en hun waarden zijn variabele waarden. Als u variabelesjablonen wilt gebruiken, moet u de lijstsyntaxis gebruiken. Voor de lijstsyntaxis moet u opgeven of u een variabele (name), een variabelegroep (group) of een sjabloon (template) vermeldt.

U kunt lijst- en toewijzingsvariabelen niet gebruiken in dezelfde variabelensectie, maar u kunt , groupen template combineren namewanneer u de lijstsyntaxis gebruikt.

U kunt variabelen opgeven op pijplijn-, fase- of taakniveau.

variabelen: tekenreekswoordenlijst

Definieer variabelen met behulp van naam-waardeparen.

variables:
  string: string # Name/value pairs

Geen.

Voorbeelden

Gebruik deze toewijzingssyntaxis voor een eenvoudige set in code vastgelegde variabelen:

variables: { string: string }

Variabelen die zijn gedefinieerd in verschillende bereiken:

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)

variabelen: lijst met variabelen

Variabelen definiëren op naam, variabelegroep of in een sjabloon.

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

Lijsttypen

Type Description
variables.name Definieer variabelen met behulp van naam en volledige syntaxis.
variables.group Verwijzen naar variabelen uit een variabelengroep.
variables.template Variabelen definiëren in een sjabloon.

Voorbeelden

Als u variabelegroepen wilt opnemen, schakelt u over naar deze reekssyntaxis:

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

U kunt paren en groupherhalenname/value.

Variabelen kunnen ook worden ingesteld als alleen-lezen om de beveiliging te verbeteren.

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

U kunt ook variabelen uit sjablonen opnemen.

Volgordesyntaxis:

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

Zie ook