変数の定義

名前と値のペアを使用して変数を定義します。

この定義を参照する定義: pipeline、 stages.stage、 jobs.job、 jobs.deployment

実装

実装	説明
variables: 文字列ディクショナリ	名前と値のペアを使用して変数を定義します。
variables: variable list	名前、変数グループ、またはテンプレートで変数を定義します。

注釈

variables キーワード (keyword)では、変数リストとマッピング (文字列ディクショナリ) という 2 つの構文形式が使用されます。

マッピング構文では、すべてのキーは変数名であり、その値は変数値です。 変数テンプレートを使用するには、リスト構文を使用する必要があります。 リスト構文では、変数 ()、変数グループ ()、テンプレートtemplate (namegroup) のいずれをメンションするかを指定する必要があります。

同じ変数セクションでリスト変数とマッピング変数を使用することはできませんが、リスト構文を使用する場合は、、group、 をtemplate組み合わせることができますname。

パイプライン、ステージ、またはジョブ レベルで変数を指定できます。

variables: 文字列ディクショナリ

名前と値のペアを使用して変数を定義します。

variables:
  string: string # Name/value pairs

[なし] :

例

ハードコーディングされた変数の単純なセットの場合は、次のマッピング構文を使います。

variables: { string: string }

異なるスコープで定義された変数:

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: variable list

名前、変数グループ、またはテンプレートで変数を定義します。

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

リストの種類

型	説明
variables.name	名前と完全な構文を使用して変数を定義します。
variables.group	変数グループから変数を参照します。
variables.template	テンプレートで変数を定義します。

例

変数グループを含めるには、次のシーケンス構文に切り替えます。

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

name/value のペアと group を繰り返すことができます。

セキュリティを強化するため、変数は読み取り専用として設定することもできます。

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

テンプレートから変数を含めることもできます。

シーケンスの構文:

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

こちらもご覧ください

• 変数グループの追加と使用
• 変数の定義