KubernetesManifest@0 - Kubernetes v0 へのデプロイ タスク

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

このバージョンのタスクは非推奨です。 KubernetesManifest@1 を使用して、 ワークロード ID フェデレーションなどの最新機能を利用できます。

ビルド パイプラインまたはリリース パイプラインで 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.

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

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

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

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

namespace - 名前空間の
string。

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

strategy - 戦略
string。 任意。 action = deploy || action = promote || action = rejectするときに使用します。 使用できる値: canary、none。 既定値: none。

promote アクションまたは reject アクションの前に deploy アクションで使用されるデプロイメント方法を指定します。 現在、 canary が唯一の許容可能なデプロイ戦略です。

trafficSplitMethod - トラフィック分割方式
string。 任意。 strategy = canaryするときに使用します。 使用できる値: pod、smi。 既定値: pod。

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

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

percentage - 百分率
string。 strategy = Canary && action = deployする場合に必要です。 既定値: 0。

マニフェスト ファイルに含まれるワークロードの baseline-variant レプリカと canary-variant レプリカの数を計算するために使用される割合。

指定したパーセンテージ入力に対して、次のように計算します。

(レプリカ数×%)/ 100

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

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

replicas: 4
strategy: canary
percentage: 25

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

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

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

たとえば、入力デプロイ マニフェストで stable バリアントに 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 は一例です。

imagePullSecrets - ImagePullシークレット
string。 任意。 action = deploy || action = promoteするときに使用します。

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

renderType - レンダリングエンジン
string。 任意。 action = bakeするときに使用します。 使用できる値: helm、kompose、kustomize。 既定値: helm。

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

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

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

helmChart - ヘルムチャート
string。 action = bake && renderType = helmする場合に必要です。

ベイクする Helm チャートのパスを指定します。

releaseName - Helm リリース名
string。 任意。 action = bake && renderType = helmするときに使用します。

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

overrideFiles - ファイルの上書き
string。 任意。 action = bake && renderType = helmするときに使用します。

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

overrides - オーバーライド
string。 任意。 action = bake && renderType = helmするときに使用します。

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

kustomizationPath - Kustomization パス
string。 任意。 action = bake && renderType = kustomizeするときに使用します。

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

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

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

• マニフェスト ファイルは、パッチを適用するオブジェクトを識別します。
• 個々のオブジェクトは、種類と名前でパッチ ターゲットとして識別されます。

指定できる値は file と name です。

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

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

kind - 種類
string。 action = scale || resourceToPatch = nameする場合に必要です。 使用できる値: deployment、replicaset、statefulset。

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

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"。

Docker レジストリ サービス接続を dockerRegistryEndpoint - する
string。 任意。 action = createSecret && secretType = dockerRegistryするときに使用します。

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

rolloutStatusTimeout - ロールアウト状態のタイムアウト
string。 任意。 action = deploy || action = patch || action = scale || action = promoteするときに使用します。 既定値: 0。

watch on rolloutステータスが終了するまでの待機時間(秒単位)を指定します。

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

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