从2025年11月7日起，亚马逊 CodeCatalyst 将不再向新客户开放。如果您想使用该服务，请在2025年11月7日之前注册。有关更多信息，请参阅 如何迁移 CodeCatalyst。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

“部署到 Kubernetes 集群”操作 YAML

下面是部署到 Kubernetes 集群操作的 YAML 定义。要了解如何使用此操作，请参阅使用工作流部署到 Amazon EKS。

此操作定义部分包含在更广泛的工作流定义文件中。有关此文件的更多信息，请参阅工作流 YAML 定义。

# The workflow definition starts here.
# See 顶级属性 for details.
        
Name: MyWorkflow
SchemaVersion: 1.0 
Actions:

# The action definition starts here.   
  DeployToKubernetesCluster_nn: 
    Identifier: aws/kubernetes-deploy@v1
    DependsOn:
      - build-action
    Compute:  
        - Type: EC2 | Lambda
        - Fleet: fleet-name
    Timeout: timeout-minutes
    Environment:
      Name: environment-name
      Connections:
        - Name: account-connection-name
          Role: DeployToEKS
    Inputs:
      # Specify a source or an artifact, but not both.
      Sources:
        - source-name-1
      Artifacts:
        - manifest-artifact
    Configuration:
      Namespace: namespace
      Region: us-east-1 
      Cluster: eks-cluster
      Manifests: manifest-path

DeployToKubernetesCluster

（必需）

指定操作的名称。工作流中的所有操作名称都必须是唯一的。操作名称仅限于字母数字字符（a-z、A-Z、0-9）、连字符（-）和下划线（_）。不允许使用空格。不能使用引号在操作名称中包含特殊字符和空格。

默认值：DeployToKubernetesCluster_nn。

对应的 UI：“配置”选项卡/操作显示名称

Identifier

(DeployToKubernetesCluster/Identifier)

（必需）

标识操作。除非您要更改版本，否则不要更改此属性。有关更多信息，请参阅指定要使用的操作版本。

默认值：aws/kubernetes-deploy@v1。

对应的 UI：工作流图表/DeployToKubernetesCluster_nn/aws/kubernetes-deploy@v1 标签

DependsOn

(DeployToKubernetesCluster/DependsOn)

（可选）

指定必须成功运行才能使该操作运行的操作、操作组或阶段门。

有关“依赖于”功能的更多信息，请参阅顺序操作。

对应的 UI：“输入”选项卡/依赖于 – 可选

Compute

(DeployToKubernetesCluster/Compute)

（可选）

用于运行工作流操作的计算引擎。您可以在工作流级别或操作级别指定计算，但不能同时在这两个级别指定计算。在工作流级别指定计算时，计算配置将应用于工作流中定义的所有操作。在工作流级别，您还可以在同一个实例上运行多个操作。有关更多信息，请参阅跨操作共享计算。

对应的 UI：无

Type

(DeployToKubernetesCluster/Compute/Type)

（如果包含 Compute，则为必需）

计算引擎的类型。可以使用下列值之一：

有关计算类型的更多信息，请参阅计算类型。

相应的 UI：配置 tab/Advanced -可选/计算类型

Fleet

(DeployToKubernetesCluster/Compute/Fleet)

（可选）

指定将运行您的工作流或工作流操作的计算机或实例集。对于按需实例集，当操作开始时，工作流会预置操作所需的资源，操作完成后计算机就会被销毁。按需实例集的示例：Linux.x86-64.Large、Linux.x86-64.XLarge。有关按需实例集的更多信息，请参阅按需实例集属性。

使用预置的实例集，您可以配置一组专用计算机来运行工作流操作。这些计算机保持空闲状态，可随时开始立即处理操作。有关预置实例集的更多信息，请参阅预置实例集属性。

如果省略 Fleet，则默认值为 Linux.x86-64.Large。

相应的 UI：配置 tab/Advanced -可选/计算舰队

Timeout

(DeployToKubernetesCluster/Timeout)

（可选）

指定操作在 CodeCatalyst 结束操作之前可以运行的时间（以分钟（YAML 编辑器）或小时和分钟（可视化编辑器）为单位。最小值为 5 分钟，最大值如 中的工作流程配额 CodeCatalyst 中描述。默认超时值与最大超时值相同。

对应的 UI：“配置”选项卡/超时 – 可选

Environment

(DeployToKubernetesCluster/Environment)

（必需）

指定要用于操作的 CodeCatalyst 环境。该操作连接到在所选环境中指定的 AWS 账户 和可选的 Amazon VPC。该操作使用环境中指定的默认 IAM 角色连接到 AWS 账户，并使用在 A mazon VPC 连接中指定的 IAM 角色连接到亚马逊 VPC。

有关环境的更多信息，请参阅部署到 AWS 账户 和 VPCs和创建环境。

对应的 UI：“配置”选项卡/环境

Name

(DeployToKubernetesCluster/Environment/Name)

（如果包含 Environment，则为必需）

指定要与操作关联的现有环境的名称。

对应的 UI：“配置”选项卡/环境

Connections

(DeployToKubernetesCluster/Environment/Connections)

（在新版本的操作中为可选；在旧版本中为必需）

指定要与操作关联的账户连接。您在 Environment 下最多只能指定一个账户连接。

如果您不指定账户连接：

有关账户连接的更多信息，请参阅允许在已连接的情况下访问 AWS 资源 AWS 账户。有关向环境添加账户连接的信息，请参阅创建环境。

对应的 UI：根据操作版本的不同，为下列项之一：

Name

(DeployToKubernetesCluster/Environment/Connections/Name)

（可选）

指定账户连接的名称。

对应的 UI：根据操作版本的不同，为下列项之一：

Role

(DeployToKubernetesCluster/Environment/Connections/Role)

（如果包含 Connections，则为必需）

指定部署到 Kubernetes 集群操作用于访问 AWS的 IAM 角色的名称。请确保您已将该角色添加到您的 CodeCatalyst 空间，并且该角色包含以下策略。

如果您未指定 IAM 角色，则该操作将使用 CodeCatalyst 控制台中环境中列出的默认 IAM 角色。如果您使用此环境中的默认角色，请确保该角色具有以下策略。

确保将此角色添加到：

对应的 UI：根据操作版本的不同，为下列项之一：

Inputs

(DeployToKubernetesCluster/Inputs)

（如果包含 Connections，则为必需）

Inputs 部分中定义了工作流运行期间 DeployToKubernetesCluster 所需的数据。

对应的 UI：输入选项卡

Sources

(DeployToKubernetesCluster/Inputs/Sources)

（如果您的清单文件存储在源存储库中，则为必需）

如果您的 Kubernetes 清单文件存储在源存储库中，请指定该源存储库的标签。目前，唯一支持的标签是 WorkflowSource。

如果您的清单文件不包含在源存储库中，则必须位于另一个操作生成的构件中。

有关来源的更多信息，请参阅将源存储库连接到工作流。

对应的 UI：“输入”选项卡/来源 – 可选

Artifacts - input

(DeployToKubernetesCluster/Inputs/Artifacts)

（如果您的清单文件存储在上一操作生成的输出构件中，则为必需）

如果一个或多个 Kubernetes 清单文件包含在上一操作生成的构件中，请在此处指定该构件。如果您的清单文件不包含在构件中，则必须位于源存储库中。

有关构件的更多信息（包括示例），请参阅在操作之间共享构件和文件。

对应的 UI：“配置”选项卡/构件 – 可选

Configuration

(DeployToKubernetesCluster/Configuration)

（必需）

可在其中定义操作的配置属性的部分。

对应的 UI：配置选项卡

Namespace

(DeployToKubernetesCluster/Configuration/Namespace)

（可选）

指定 Kubernetes 应用程序将部署到的 Kubernetes 命名空间。如果未将命名空间与集群结合使用，请使用 default。有关命名空间的更多信息，请参阅 Kubernetes 文档中的 Subdividing your cluster using Kubernetes namespaces。

如果省略命名空间，则使用值 default。

对应的 UI：“配置”选项卡/命名空间

Region

(DeployToKubernetesCluster/Configuration/Region)

（必需）

指定您的 Amazon EKS 集群和服务所在的 AWS 区域。有关区域代码的列表，请参阅《AWS 一般参考》中的 Regional endpoints。

对应的 UI：“配置”选项卡/区域

Cluster

(DeployToKubernetesCluster/Configuration/Cluster)

（必需）

指定现有 Amazon EKS 集群的名称。部署到 Kubernetes 集群操作会将容器化应用程序部署到该集群中。有关 Amazon EKS 集群的更多信息，请参阅《Amazon EKS 用户指南》中的集群。

对应的 UI：“配置”选项卡/集群

Manifests

(DeployToKubernetesCluster/Configuration/Manifests)

（必需）

指定 YAML 格式的 Kubernetes 清单文件的路径，这些文件在 Kubernetes 文档中称作配置文件、config 文件，或简称为配置。

如果您使用了多个清单文件，请将它们置于一个文件夹中并引用该文件夹。Kubernetes 会按字母数字顺序处理清单文件，因此请务必在文件名前添加递增数字或字母，以便控制处理顺序。例如：

00-namespace.yaml

01-deployment.yaml

如果清单文件位于源存储库中，则该路径相对于源存储库根文件夹。如果该文件位于上一工作流操作生成的构件中，则该路径相对于构件根文件夹。

示例：

Manifests/

deployment.yaml

my-deployment.yml

请勿使用通配符（*）。

有关清单文件的更多信息，请参阅 Kubernetes 文档中的 Organizing resource configurations。

对应的 UI：“配置”选项卡/清单