KubernetesManifest@0 - Kubernetes v0 タスクにデプロイする

ビルドまたはリリース パイプラインで Kubernetes マニフェスト タスクを使用して、Helm チャートを使用してマニフェストをベイクして Kubernetes クラスターにデプロイします。

# Deploy to Kubernetes v0
# Use Kubernetes manifest files to deploy to clusters or even bake the manifest files to be used for deployments using Helm charts.
- task: KubernetesManifest@0
  inputs:
    #action: 'deploy' # 'bake' | 'createSecret' | 'delete' | 'deploy' | 'patch' | 'promote' | 'scale' | 'reject'. Action. Default: deploy.
    #kubernetesServiceConnection: # string. Required when action != bake. Kubernetes service connection. 
    #namespace: # string. Namespace. 
    #strategy: 'none' # 'canary' | 'none'. Optional. Use when action = deploy || action = promote || action = reject. Strategy. Default: none.
    #trafficSplitMethod: 'pod' # 'pod' | 'smi'. Optional. Use when strategy = canary. Traffic split method. Default: pod.
    #percentage: '0' # string. Required when strategy = Canary && action = deploy. Percentage. Default: 0.
    #baselineAndCanaryReplicas: '1' # string. Required when strategy = Canary && action = deploy && trafficSplitMethod = SMI. Baseline and canary replicas. Default: 1.
    #manifests: # string. Required when action = deploy || action = promote || action = reject. Manifests. 
    #containers: # string. Optional. Use when action = deploy || action = promote || action = bake. Containers. 
    #imagePullSecrets: # string. Optional. Use when action = deploy || action = promote. ImagePullSecrets. 
    #renderType: 'helm' # 'helm' | 'kompose' | 'kustomize'. Optional. Use when action = bake. Render Engine. Default: helm.
    #dockerComposeFile: # string. Required when action = bake && renderType = kompose. Path to docker compose file. 
    #helmChart: # string. Required when action = bake && renderType = helm. Helm Chart. 
    #releaseName: # string. Optional. Use when action = bake && renderType = helm. Helm Release Name. 
    #overrideFiles: # string. Optional. Use when action = bake && renderType = helm. Override Files. 
    #overrides: # string. Optional. Use when action = bake && renderType = helm. Overrides. 
    #kustomizationPath: # string. Optional. Use when action = bake && renderType = kustomize. Kustomization Path. 
    #resourceToPatch: 'file' # 'file' | 'name'. Required when action = patch. Resource to patch. Default: file.
    #resourceFileToPatch: # string. Required when action = patch && resourceToPatch = file. File path. 
    #kind: # 'deployment' | 'replicaset' | 'statefulset'. Required when action = scale || resourceToPatch = name. Kind. 
    #name: # string. Required when action = scale || resourceToPatch = name. Name. 
    #replicas: # string. Required when action = scale. Replica count. 
    #mergeStrategy: 'strategic' # 'json' | 'merge' | 'strategic'. Required when action = patch. Merge Strategy. Default: strategic.
    #arguments: # string. Optional. Use when action = delete. Arguments. 
    #patch: # string. Required when action = patch. Patch. 
    #secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required when action = createSecret. Type of secret. Default: dockerRegistry.
    #secretName: # string. Optional. Use when action = createSecret. Secret name. 
    #secretArguments: # string. Optional. Use when action = createSecret && secretType = generic. Arguments. 
    #dockerRegistryEndpoint: # string. Optional. Use when action = createSecret && secretType = dockerRegistry. Docker registry service connection. 
    #rolloutStatusTimeout: '0' # string. Optional. Use when action = deploy || action = patch || action = scale || action = promote. Timeout for rollout status. Default: 0.

# Deploy Kubernetes manifests v0
# Use Kubernetes manifest files to deploy to clusters or even bake the manifest files to be used for deployments using Helm charts.
- task: KubernetesManifest@0
  inputs:
    #action: 'deploy' # 'bake' | 'createSecret' | 'delete' | 'deploy' | 'patch' | 'promote' | 'scale' | 'reject'. Action. Default: deploy.
    #kubernetesServiceConnection: # string. Required when action != bake. Kubernetes service connection. 
    #namespace: 'default' # string. Required when action != bake. Namespace. Default: default.
    #strategy: 'none' # 'canary' | 'none'. Optional. Use when action = deploy || action = promote || action = reject. Strategy. Default: none.
    #percentage: '0' # string. Required when strategy = Canary && action = deploy. Percentage. Default: 0.
    #manifests: # string. Required when action = deploy || action = promote || action = reject. Manifests. 
    #containers: # string. Optional. Use when action = deploy || action = promote. Containers. 
    #imagePullSecrets: # string. Optional. Use when action = deploy || action = promote. ImagePullSecrets. 
    #renderType: 'helm2' # 'helm2'. Optional. Use when action = bake. Render Engine. Default: helm2.
    #helmChart: # string. Required when action = bake && renderType = helm2. Helm Chart. 
    #releaseName: # string. Optional. Use when action = bake && renderType = helm2. Helm Release Name. 
    #overrideFiles: # string. Optional. Use when action = bake && renderType = helm2. Override Files. 
    #overrides: # string. Optional. Use when action = bake && renderType = helm2. Overrides. 
    #resourceToPatch: 'file' # 'file' | 'name'. Required when action = patch. Resource to patch. Default: file.
    #resourceFileToPatch: # string. Required when action = patch && resourceToPatch = file. File path. 
    #kind: # 'deployment' | 'replicaset' | 'statefulset'. Required when action = scale || resourceToPatch = name. Kind. 
    #name: # string. Required when action = scale || resourceToPatch = name. Name. 
    #replicas: # string. Required when action = scale. Replica count. 
    #mergeStrategy: 'strategic' # 'json' | 'merge' | 'strategic'. Required when action = patch. Merge Strategy. Default: strategic.
    #arguments: # string. Optional. Use when action = delete. Arguments. 
    #patch: # string. Required when action = patch. Patch. 
    #secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required when action = createSecret. Type of secret. Default: dockerRegistry.
    #secretName: # string. Optional. Use when action = createSecret. Secret name. 
    #secretArguments: # string. Optional. Use when action = createSecret && secretType = generic. Arguments. 
    #dockerRegistryEndpoint: # string. Optional. Use when action = createSecret && secretType = dockerRegistry. Docker registry service connection.

action - アクション
string. 使用できる値: bake、(シークレットの作成)delete、、、deploy、patch、promote、、 scalereject。 createSecret 既定値: deploy。

実行する操作を指定します。

kubernetesServiceConnection - Kubernetes サービス接続
string. action != bake の場合に必要です。

Kubernetes サービス接続を指定します。

namespace - 名前 空間
string.

フラグを使用してコマンドの名前空間を –namespace 指定します。 名前空間が指定されていない場合、コマンドは既定の名前空間で実行されます。

namespace - 名前 空間
string. action != bake の場合に必要です。 既定値: default。

フラグを使用してコマンドの名前空間を –namespace 指定します。 名前空間が指定されていない場合、コマンドは既定の名前空間で実行されます。

strategy - 戦略
string. 任意。 の場合は action = deploy || action = promote || action = rejectを使用します。 使用できる値: canary、none。 既定値: none。

アクションまたはrejectアクションの前にアクションでdeploy使用されるデプロイ戦略をpromote指定します。 現時点では、 canary のみが許容されるデプロイ戦略です。

trafficSplitMethod - トラフィック分割方法
string. 任意。 の場合は strategy = canaryを使用します。 使用できる値: pod、smi。 既定値: pod。

値 smiの場合、割合トラフィック分割は、サービス メッシュを使用して要求レベルで実行されます。 サービス メッシュは、クラスター管理者によって設定する必要があります。このタスクは、SMI TrafficSplit オブジェクトのオーケストレーションを処理します。

値 podの場合、サービス メッシュがない場合、要求レベルではパーセント分割を実行できません。 代わりに、パーセンテージ入力を使用して、ベースラインとカナリアのレプリカを計算します。 計算は、安定したバリアントの入力マニフェストで指定されたレプリカの割合です。

percentage - 割合
string. strategy = Canary && action = deploy の場合に必要です。 既定値: 0。

マニフェスト ファイルに含まれるワークロードのベースラインバリアントレプリカとカナリアバリアントレプリカの数を計算するために使用される割合。

指定したパーセンテージ入力の場合は、次の値を計算します。

(レプリカ数×割合) / 100

結果が整数でない場合は、ベースラインバリアントとカナリアバリアントが作成されるときに、結果の数学的フロアが使用されます。

たとえば、配置 hello-world が入力マニフェスト ファイル内にあり、タスク入力に次の行があるとします。

replicas: 4
strategy: canary
percentage: 25

この場合、デプロイ hello-world-baseline と hello-world-canary はそれぞれ 1 つのレプリカで作成されます。 ベースライン バリアントは、デプロイ前の 4 レプリカバリアントである安定バージョンと同じイメージとタグを使用して作成されます。 カナリアバリアントは、新しくデプロイされた変更に対応するイメージとタグを使用して作成されます。

baselineAndCanaryReplicas - ベースライン レプリカとカナリア レプリカ
string. strategy = Canary && action = deploy && trafficSplitMethod = SMI の場合に必要です。 既定値: 1。

を にsmi設定trafficSplitMethodすると、トラフィック分割の割合がサービス メッシュ プレーンで制御されます。 カナリアバリアントとベースラインバリアントのレプリカの実際の数は、トラフィックの分割とは別に制御できます。

たとえば、入力配置マニフェストで、安定したバリアントに対して 30 個のレプリカが指定されているとします。 また、タスクに対して次の入力を指定するとします。

strategy: canary
trafficSplitMethod: smi
percentage: 20
baselineAndCanaryReplicas: 1

この場合、安定バリアントはトラフィックの 80% を受信し、ベースラインバリアントとカナリアバリアントはそれぞれ指定された 20% の半分を受信します。 ベースラインバリアントとカナリアバリアントはそれぞれ 3 つのレプリカを受け取りません。 代わりに、指定した数のレプリカを受け取ります。つまり、それぞれが 1 つのレプリカを受信します。

manifests - マニフェスト
string. action = deploy || action = promote || action = reject の場合に必要です。

配置に使用するマニフェスト ファイルへのパスを指定します。 各行は 1 つのパスを表します。 ファイル一致パターンは、各行に許容される値です。

containers - コンテナー
string. 任意。 の場合は action = deploy || action = promote || action = bakeを使用します。

マニフェスト ファイルの置換に使用するイメージの完全修飾リソース URL を指定します。 URL contosodemo.azurecr.io/helloworld:test は例です。

containers - コンテナー
string. 任意。 の場合は action = deploy || action = promoteを使用します。

マニフェスト ファイルの置換に使用するイメージの完全修飾 URL を指定します。 この入力は、改行で区切られた形式で複数の成果物の置換の指定を受け入れます。 次に例を示します。

containers: |
  contosodemo.azurecr.io/foo:test1
  contosodemo.azurecr.io/bar:test2

この例では、入力マニフェスト ファイルのイメージ フィールドで、 と contosodemo.azurecr.io/bar へのcontosodemo.azurecr.io/fooすべての参照が検索されます。 検出された一致ごとに、 タグ test1 または test2 一致した参照が置き換えられます。

imagePullSecrets - ImagePullSecrets
string. 省略可能。 の場合は action = deploy || action = promoteを使用します。

各行に、クラスター内で既に設定されている Docker レジストリ シークレットの名前が含まれる複数行の入力を指定します。 各シークレット名は、入力マニフェスト ファイル内にあるワークロードの 下 imagePullSecrets に追加されます。

renderType - レンダリング エンジン
string. 任意。 の場合は action = bakeを使用します。 許可値: helm、kompose、kustomize。 既定値: helm。

マニフェスト ファイルの生成に使用するレンダリングの種類を指定します。

renderType - レンダリング エンジン
string. 任意。 の場合は action = bakeを使用します。 使用できる値: helm2 (Helm 2)。 既定値: helm2。

マニフェスト ファイルの生成に使用するレンダリングの種類を指定します。

dockerComposeFile - docker compose ファイルへのパス
string. action = bake && renderType = kompose の場合に必要です。

docker-compose ファイル パスを指定します。

helmChart - Helm Chart
string. action = bake && renderType = helm の場合に必要です。

ベイクする Helm グラフのパスを指定します。

helmChart - Helm Chart
string. action = bake && renderType = helm2 の場合に必要です。

ベイクする Helm グラフ パスを指定します。

releaseName - Helm リリース名
string. 省略可能。 の場合は action = bake && renderType = helmを使用します。

使用する Helm リリース名を指定します。

releaseName - Helm リリース名
string. 省略可能。 の場合は action = bake && renderType = helm2を使用します。

使用する Helm リリース名を指定します。

overrideFiles - ファイルをオーバーライドする
string. 省略可能。 の場合は action = bake && renderType = helmを使用します。

オーバーライド ファイルへのパスを受け入れる複数行入力を指定します。 ファイルは、Helm チャートのマニフェスト ファイルがベイクされるときに使用されます。

overrideFiles - ファイルをオーバーライドする
string. 省略可能。 の場合は action = bake && renderType = helm2を使用します。

オーバーライド ファイルへのパスを受け入れる複数行入力を指定します。 ファイルは、Helm チャートのマニフェスト ファイルがベイクされるときに使用されます。

overrides - オーバーライド
string. 任意。 の場合は action = bake && renderType = helmを使用します。

設定するオーバーライド値を指定します。

overrides - オーバーライド
string. 任意。 の場合は action = bake && renderType = helm2を使用します。

Helm を使用するマニフェスト ファイルをベイク処理するときに、コマンド ライン スイッチ --set を介して使用される追加のオーバーライド値を指定します。

の形式key:valueで、オーバーライド値をペアとしてkey-value指定します。 複数のオーバーライド ペアを使用する場合は、各key-valueペアをkey-value個別の行で指定します。 異なる key-value ペア間の区切り記号として改行文字を使用します。

kustomizationPath - Kustomization パス
string. 省略可能。 の場合は action = bake && renderType = kustomizeを使用します。

ファイルを含むディレクトリへのパス、またはリポジトリ ルートに対して を指定するパス サフィックスを持つ git リポジトリ URL である必要がある引数を指定 same します。

resourceToPatch - パッチを適用するリソース
string. action = patch の場合に必要です。 使用できる値: file、name。 既定値: file。

次のいずれかのパッチ方法を示します。

• マニフェスト ファイルは、修正プログラムを適用するオブジェクトを識別します。
• 個々のオブジェクトは、種類と名前によってパッチ ターゲットとして識別されます。

許容される値は 、ファイル と 名前です。

resourceFileToPatch - ファイル パス
string. action = patch && resourceToPatch = file の場合に必要です。

パッチに使用するファイルへのパスを指定します。

kind - 種類
string. action = scale || resourceToPatch = name の場合に必要です。 許可値: deployment、replicaset、statefulset。

などdeploymentreplicaSet、K8s オブジェクトの種類を指定します。

name - 名前
string. action = scale || resourceToPatch = name の場合に必要です。

K8s オブジェクトの名前を指定します。

replicas - レプリカ数
string. action = scale の場合に必要です。

スケーリングするレプリカの数を指定します。

mergeStrategy - マージ戦略
string. action = patch の場合に必要です。 許可値: json、merge、strategic。 既定値: strategic。

指定するパッチの種類を指定します。

arguments - 引数
string. 省略可能。 の場合は action = deleteを使用します。

コマンドの引数を kubectl delete 指定します。 例を次に示します。 arguments: deployment hello-world foo-bar

patch - パッチ
string. action = patch の場合に必要です。

パッチの内容を指定します。

secretType - シークレットの種類
string. action = createSecret の場合に必要です。 使用できる値: dockerRegistry、generic。 既定値: dockerRegistry。

ジェネリック または docker を作成または更新します imagepullsecret。 を指定 dockerRegistry して、選択したレジストリの を imagepullsecret 作成または更新します。 imagePullSecretは、コンテナー レジストリ パスワードを含むシークレットを Kubelet に渡して、ポッドの代わりにプライベート イメージをプルできるようにする方法です。

secretName - シークレット名
string. 省略可能。 の場合は action = createSecretを使用します。

シークレットの名前を指定します。 このシークレット名は、Kubernetes YAML 構成ファイルで使用できます。

secretArguments - 引数
string. 省略可能。 の場合は action = createSecret && secretType = genericを使用します。

シークレットに挿入するキーとリテラル値を指定します。 たとえば、 などです --from-literal=key1=value1--from-literal=key2="top secret"。

dockerRegistryEndpoint - Docker レジストリ サービス接続
string. 任意。 の場合は action = createSecret && secretType = dockerRegistryを使用します。

クラスター内に Docker レジストリ シークレットを作成するために使用される、指定されたサービス接続の資格情報を指定します。 フィールドの下にある imagePullSecrets マニフェスト ファイルは、このシークレットの名前を参照できます。

rolloutStatusTimeout - ロールアウトの状態のタイムアウト
string. 省略可能。 の場合は action = deploy || action = patch || action = scale || action = promoteを使用します。 既定値: 0。

終了 watch on rollout 状態になるまで待機する時間 (秒単位) を指定します。

このタスクでは、ダウンストリームのステップ、ジョブ、およびステージで使用できる次の 出力変数を定義します。

manifestsBundle
ベイク アクションによって作成されるマニフェスト バンドルの場所を指定します。