KubernetesManifest@1 - Kubernetes v1 タスクにデプロイする

Kubernetes マニフェスト ファイルを使用してクラスターにデプロイしたり、Helm チャートを使用してデプロイに使用するマニフェスト ファイルをベイクしたりできます。

# Deploy to Kubernetes v1
# Use Kubernetes manifest files to deploy to clusters or even bake the manifest files to be used for deployments using Helm charts.
- task: KubernetesManifest@1
  inputs:
    #action: 'deploy' # 'bake' | 'createSecret' | 'delete' | 'deploy' | 'patch' | 'promote' | 'scale' | 'reject'. Action. Default: deploy.
    #connectionType: 'kubernetesServiceConnection' # 'azureResourceManager' | 'kubernetesServiceConnection'. Required when action != bake. Service connection type. Default: kubernetesServiceConnection.
    #kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Required when action != bake && connectionType = kubernetesServiceConnection. Kubernetes service connection. 
    #azureSubscriptionConnection: # string. Alias: azureSubscriptionEndpoint. Required when action != bake && connectionType = azureResourceManager. Azure subscription. 
    #azureResourceGroup: # string. Required when action != bake && connectionType = azureResourceManager. Resource group. 
    #kubernetesCluster: # string. Required when action != bake && connectionType = azureResourceManager. Kubernetes cluster. 
    #useClusterAdmin: false # boolean. Optional. Use when connectionType = azureResourceManager. Use cluster admin credentials. Default: false.
    #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。

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

connectionType - サービス接続の種類
string. action != bake の場合に必要です。 使用できる値: azureResourceManager (Azure Resource Manager) kubernetesServiceConnection 、(Kubernetes Service Connection)。 既定値: kubernetesServiceConnection。

Kubernetes サービス接続の種類を選択します。

• kubernetesServiceConnection (Kubernetes Service Connection) - KubeConfig ファイルを指定したり、サービス アカウントを指定したり、 Azure サブスクリプション オプションを使用して AKS インスタンスをインポートしたりできます。 Azure サブスクリプション オプションを使用して AKS インスタンスをインポートするには、サービス接続の構成時に Kubernetes クラスターにアクセスする必要があります。
• azureResourceManager(Azure Resource Manager) - AKS インスタンスを選択できます。 サービス接続の構成時に Kubernetes クラスターにアクセスしません。

詳細については、「解説」をご覧ください。

kubernetesServiceConnection - Kubernetes サービス接続
入力エイリアス: kubernetesServiceEndpoint。 string. action != bake && connectionType = kubernetesServiceConnection の場合に必要です。

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

azureSubscriptionConnection - Azure サブスクリプション
入力エイリアス: azureSubscriptionEndpoint。 string. action != bake && connectionType = azureResourceManager の場合に必要です。

Azure Container Registryを含む Azure Resource Manager サブスクリプションを選択します。注: 新しいサービス接続を構成するには、一覧から Azure サブスクリプションを選択し、[承認] をクリックします。 自分のサブスクリプションが一覧にない場合、または既存のサービス プリンシパルを使用する場合、[追加] または [管理] ボタンを使用して Azure サービス接続を設定できます。

azureResourceGroup - リソース グループ
string. action != bake && connectionType = azureResourceManager の場合に必要です。

Azure リソース グループを選択します。

kubernetesCluster - Kubernetes クラスター
string. action != bake && connectionType = azureResourceManager の場合に必要です。

Azure マネージド クラスターを選択します。

useClusterAdmin - クラスター管理者の資格情報を使用する
boolean. 省略可能。 の場合は connectionType = azureResourceManagerを使用します。 既定値: false。

既定のクラスター ユーザー資格情報ではなく、クラスター管理者の資格情報を使用します。

namespace - 名前 空間
string.

フラグを使用して、コマンドの名前空間を –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 は例です。

imagePullSecrets - ImagePullSecrets
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 - Helm Chart
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を使用します。

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

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

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

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

使用できる値は、file と name です。

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

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

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

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

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

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

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

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

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

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

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
ベイク アクションによって作成されたマニフェスト バンドルの場所