変数の定義
名前と値のペアを使用して変数を定義します。
この定義を参照する定義: パイプライン、stages.stage、jobs.job、jobs.deployment
実装
実装 | 説明 |
---|---|
変数: 文字列ディクショナリ | 名前と値のペアを使用して変数を定義します。 |
変数: 変数リスト | 名前、変数グループ、またはテンプレートで変数を定義します。 |
注釈
variables
キーワードは、変数リストとマッピング (文字列ディクショナリ) という 2 つの構文形式を使用します。
マッピング構文では、すべてのキーは変数名であり、その値は変数値です。 変数テンプレートを使用するには、リスト構文を使用する必要があります。 リスト構文では、変数 (name
)、変数グループ (group
)、またはテンプレート (template
) を指定する必要があります。
同じ変数セクションでリスト変数とマッピング変数を使用することはできませんが、リスト構文を使用する場合は、name
、group
、および template
を組み合わせることができます。
パイプライン、ステージ、またはジョブ レベルで変数を指定できます。
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: 変数リスト
名前、変数グループ、またはテンプレートで変数を定義します。
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