AppSpec 「資源」區段 (僅限 Amazon ECS 和 AWS Lambda 部署)

根據部署的運算平台， AppSpec 檔案'resources'區段中的內容會有所不同。Amazon ECS 部署的部'resources'分包含您的 Amazon ECS 任務定義、用於將流量路由到更新後的 Amazon ECS 任務集的容器和連接埠，以及其他選用資訊。 AWS Lambda 部署的'resources'區段包含 Lambda 函數的名稱、別名、目前版本和目標版本。

AppSpec AWS Lambda 部署的「資源」部分

此'resources'區段會指定要部署的 Lambda 函數，並具有下列結構：

YAML：

resources:
  - name-of-function-to-deploy:
      type: "AWS::Lambda::Function"
      properties:
        name: name-of-lambda-function-to-deploy
        alias: alias-of-lambda-function-to-deploy
        currentversion: version-of-the-lambda-function-traffic-currently-points-to
        targetversion: version-of-the-lambda-function-to-shift-traffic-to

JSON：

"resources": [
    {
        "name-of-function-to-deploy" {
            "type": "AWS::Lambda::Function",
            "properties": {
                "name": "name-of-lambda-function-to-deploy",
                "alias": "alias-of-lambda-function-to-deploy",
                "currentversion": "version-of-the-lambda-function-traffic-currently-points-to",
                "targetversion": "version-of-the-lambda-function-to-shift-traffic-to"
            }
        }
    }
]

每個屬性皆以字串指定。

• name - 必要。這是要部署的 Lambda 函數的名稱。

• alias - 必要。這是 Lambda 函數的別名名稱。

• currentversion - 必要。這是 Lambda 函數流量目前指向的版本。此值必須是有效的正整數。

• targetversion - 必要。這是 Lambda 函數流量轉移到的版本。此值必須是有效的正整數。

AppSpec Amazon ECS 部署的「資源」部分

本'resources'節指定要部署的 Amazon ECS 服務，其結構如下：

YAML：

Resources:
  - TargetService:
      Type: AWS::ECS::Service
      Properties:
        TaskDefinition: "task-definition-arn"
        LoadBalancerInfo: 
          ContainerName: "ecs-container-name" 
          ContainerPort: "ecs-application-port"
# Optional properties
        PlatformVersion: "ecs-service-platform-version"
        NetworkConfiguration:
          AwsvpcConfiguration:
            Subnets: ["ecs-subnet-1","ecs-subnet-n"] 
            SecurityGroups: ["ecs-security-group-1","ecs-security-group-n"] 
            AssignPublicIp: "ENABLED | DISABLED"
        CapacityProviderStrategy:
          - Base: integer
            CapacityProvider: "capacityProviderA"
            Weight: integer
          - Base: integer
            CapacityProvider: "capacityProviderB"
            Weight: integer

JSON：

"Resources": [
    {
        "TargetService": {
            "Type": "AWS::ECS::Service",
            "Properties": {
                "TaskDefinition": "task-definition-arn",
                "LoadBalancerInfo": {
                    "ContainerName": "ecs-container-name",
                    "ContainerPort": "ecs-application-port"
                },
                "PlatformVersion": "ecs-service-platform-version",
                "NetworkConfiguration": {
                    "AwsvpcConfiguration": {
                        "Subnets": [
                            "ecs-subnet-1",
                            "ecs-subnet-n"
                        ],
                        "SecurityGroups": [
                            "ecs-security-group-1",
                            "ecs-security-group-n"
                        ],
                        "AssignPublicIp": "ENABLED | DISABLED"
                    }
                },
                "CapacityProviderStrategy": [
                    {
                        "Base": integer,
                        "CapacityProvider": "capacityProviderA",
                        "Weight": integer
                    },
                    {
                        "Base": integer,
                        "CapacityProvider": "capacityProviderB",
                        "Weight": integer
                    }
                ]
            }
        }
    }
]

每個屬性都使用一個字串 (除了ContainerPort:數字) 來指定。

• TaskDefinition - 必要。這是要部署之 Amazon ECS 服務的任務定義。這包含任務定義的 ARN 指定。ARN 的格式為 arn:aws:ecs:aws-region:account-id:task-definition/task-definition-family:task-definition-revision。如需詳細資訊，請參閱 Amazon 資源名稱 (ARN) 和 AWS 服務命名空間。

  注意

  ARN 的:task-definition-revision部分是可選的。如果省略它，Amazon ECS 會使用任務定義的最新作用中修訂版本。

• ContainerName - 必要。這是包含您的 Amazon ECS 應用程式的 Amazon ECS 容器的名稱。它必須是 Amazon ECS 任務定義中指定的容器。

• ContainerPort - 必要。這是要將流量路由到的容器上的連接埠。

• PlatformVersion：選用。已部署的 Amazon ECS 服務中 Fargate 任務的平台版本。如需詳細資訊，請參閱 AWS Fargate 平台版本。如果未指定，LATEST則依預設使用。

• NetworkConfiguration：選用。在 AwsvpcConfiguration 下，您可以指定下列項目。如需詳細資訊，請參閱 Amazon ECS 容器服務 API 參考AwsVpcConfiguration中的。

  • Subnets：選用。Amazon ECS 服務中一或多個子網路的逗號分隔清單。

  • SecurityGroups：選用。Amazon 彈性容器服務中一或多個安全群組的逗號分隔清單。

  • AssignPublicIp：選用。字串；指定 Amazon ECS 服務的 elastic network interface 是否接收公有 IP 位址。有效值為 ENABLED 和 DISABLED。

  注意

  NetworkConfiguration 下的設定必須全部指定，或都不指定。例如，如果您想要指定 Subnets，您還必須指定 SecurityGroups 和 AssignPublicIp。如果未指定任何項目，則 CodeDeploy 會使用目前的網路 Amazon ECS 設定。

• CapacityProviderStrategy：選用。您要用於部署的 Amazon ECS 容量提供者清單。如需詳細資訊，請參閱 Amazon 彈性容器服務開發人員指南中的 Amazon ECS 容量提供者。您可以為每個容量提供者指定下列設定。有關這些設定的詳細資訊，請參閱《AWS CloudFormation 使用指南》AWS::ECS::ServiceCapacityProviderStrategyItem中的

  • Base：選用。基礎值指定至少要在指定容量提供者上執行多少任務數量。容量提供者策略中只有一個容量提供者可以定義基礎。如果未指定任何值，則會使用預設值 0。

  • CapacityProvider：選用。容量提供者的簡短名稱。示例：capacityProviderA 提供

  • Weight：選用。

    加權值會指定應使用指定容量提供者之已啟動任務總數的相對百分比。如果已定義，則會在滿足 base 值之後考量 weight 值。

    如果未指定任何 weight 值，則會使用 0 的預設值。在容量提供者策略中指定多個容量供應商時，至少有一個容量供應商必須具有大於零的加權值，且不會使用具有加權 0 的任何容量提供者來放置任務。如果您在策略中指定多個容量提供者均具有加權 0，則使用容量提供者策略的任何 RunTask 或 CreateService 動作都會失敗。

    使用加權的一個範例案例為定義策略，該策略包含兩個容量提供者，而且兩者都具有 1 加權，則當滿足 base 時，任務將會平均分割到兩個容量提供者。依此邏輯，如果您為 capacityProviderA 指定 1 的權重，並為 capacityProviderB 指定 4 的權重，則對於使用 capacityProviderA 執行的每一個任務而言，四個任務將使用 capacityProviderB。