Udostępnij za pośrednictwem

definicja zmiennych

  • Artykuł

Zdefiniuj zmienne przy użyciu par nazwa/wartość.

Definicje odwołujące się do tej definicji: pipeline, stages.stage, jobs.job, jobs.deployment

Definicje odwołujące się do tej definicji: pipeline, jobs.job

Implementacje

Implementacja Opis
variables: string dictionary Zdefiniuj zmienne przy użyciu par nazwa/wartość.
zmienne: lista zmiennych Zdefiniuj zmienne według nazwy, grupy zmiennych lub w szablonie.

Uwagi

Słowo variables kluczowe używa dwóch formularzy składni: listy zmiennych i mapowania (słownik ciągów).

W składni mapowania wszystkie klucze są nazwami zmiennych, a ich wartości są wartościami zmiennych. Aby używać szablonów zmiennych, należy użyć składni listy. Składnia listy wymaga określenia, czy wspominasz o zmiennej (name), grupie zmiennych (group) czy szablonie (template).

Nie można używać zmiennych listy i mapowania w tej samej sekcji zmiennych, ale można połączyć namezmienne , groupi template w przypadku korzystania ze składni listy.

Zmienne można określić na poziomie potoku, etapu lub zadania.

variables: string dictionary

Zdefiniuj zmienne przy użyciu par nazwa/wartość.

variables:
  string: string # Name/value pairs

Brak.

Przykłady

W przypadku prostego zestawu zakodowanych zmiennych użyj tej składni mapowania:

variables: { string: string }

Zmienne zdefiniowane w różnych zakresach:

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)

zmienne: lista zmiennych

Zdefiniuj zmienne według nazwy, grupy zmiennych lub w szablonie.

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

Typy list

Typ Opis
variables.name Zdefiniuj zmienne przy użyciu nazwy i pełnej składni.
variables.group Odwoływanie się do zmiennych z grupy zmiennych.
variables.template Zdefiniuj zmienne w szablonie.

Przykłady

Aby uwzględnić grupy zmiennych, przejdź do tej składni sekwencji:

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

Można powtórzyć name/value pary i group.

Zmienne można również ustawić jako tylko do odczytu, aby zwiększyć bezpieczeństwo.

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

Można również uwzględnić zmienne z szablonów.

Składnia sekwencji:

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

Zobacz też