KubernetesManifest@0 - 部署到 Kubernetes v0 任务

使用生成或发布管道中的 Kubernetes 清单任务，使用 Helm 图表将清单烘焙和部署到 Kubernetes 群集。

此版本的任务已弃用;使用 KubernetesManifest@1 利用 工作负载标识联合等最新功能。

使用生成或发布管道中的 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。

指定要执行的作。

kubernetesServiceConnection - Kubernetes 服务连接
string。 action != bake时是必需的。

指定 Kubernetes 服务连接。

namespace - 命名空间
string。

使用 –namespace 标志指定命令的命名空间。 如果未提供命名空间，命令将在默认命名空间中运行。

strategy - 策略
string。 可选。 当 action = deploy || action = promote || action = reject时使用。 允许的值：canary、none。 默认值：none。

指定在 deploy作或 promote作之前 reject作中使用的部署策略。 目前，canary 是唯一可接受的部署策略。

trafficSplitMethod - 流量拆分方法
string。 可选。 当 strategy = canary时使用。 允许的值：pod、smi。 默认值：pod。

对于值 smi，流量拆分的百分比是在请求级别使用服务网格完成的。 服务网格必须由群集管理员设置。此任务处理 SMI TrafficSplit 对象的业务流程。

对于值 pod，在缺少服务网格的情况下，无法在请求级别拆分百分比。 相反，百分比输入用于计算基线和 Canary 的副本。 计算是稳定变体的输入清单中指定的副本的百分比。

percentage - 百分比
string。 strategy = Canary && action = deploy时是必需的。 默认值：0。

用于计算清单文件中包含的工作负荷的基线变体和 canary-variant 副本数的百分比。

对于指定的百分比输入，计算：

（百分比 × 副本数） / 100

如果结果不是整数，则会在创建基线和 Canary 变体时使用结果的数学底层。

例如，假设部署 hello-world 位于输入清单文件中，并且以下行位于任务输入中：

replicas: 4
strategy: canary
percentage: 25

在这种情况下，将创建部署 hello-world-baseline 和 hello-world-canary，每个副本都有一个副本。 基线变体是使用与稳定版本相同的映像和标记创建的，这是部署前的四个副本变体。 Canary 变体是使用与新部署的更改对应的映像和标记创建的。

baselineAndCanaryReplicas - 基线和 canary 副本
string。 strategy = Canary && action = deploy && trafficSplitMethod = SMI时是必需的。 默认值：1。

将 trafficSplitMethod 设置为 smi时，流量拆分百分比控制在服务网格平面中。 可以独立于流量拆分来控制 Canary 和基线变体的实际副本数。

例如，假设输入部署清单为稳定变体指定 30 个副本。 另外，假设你为任务指定了以下输入：

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

在这种情况下，稳定变体接收流量的 80%，而基线和 canary 变体分别接收指定 20%的一半。 基线和 Canary 变体不会分别接收三个副本。 相反，它们接收指定的副本数，这意味着每个副本都会收到一个副本。

manifests - 清单
string。 action = deploy || action = promote || action = reject时是必需的。

指定要用于部署的清单文件的路径。 每行表示单个路径。 文件匹配模式 是每行可接受的值。

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 图表
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。

指示以下修补程序方法之一：

• 清单文件标识要修补的对象。
• 单个对象按种类和名称标识为修补程序目标。

可接受的值为 文件 和 名称。

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 的一种方法，因此它可以代表 Pod 拉取专用映像。

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
指定通过烘焙作创建的清单捆绑包的位置。