了解如何使用 為 Amazon ECS 受管執行個體建立任務 AWS CLI - Amazon Elastic Container Service
先決條件步驟 1：建立叢集步驟 2：建立 Amazon ECS 受管執行個體容量提供者步驟 3：設定叢集的預設容量提供者策略步驟 4：註冊 Linux 任務定義步驟 5：列出任務定義步驟 6：建立服務步驟 7：列出服務步驟 8：描述正在執行中的服務步驟 9：測試步驟 10：清除

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

了解如何使用 為 Amazon ECS 受管執行個體建立任務 AWS CLI

下列步驟會協助您使用 AWS CLI在 Amazon ECS 中搭配 Amazon ECS 受管執行個體設定叢集、建立容量提供者、註冊任務定義、執行 Linux 任務以及執行其他常見案例。使用 AWS CLI的最新版本。如需有關如何升級至最新版本的詳細資訊，請參閱 Installing or updating to the latest version of the AWS CLI。

注意

您可以使用雙堆疊服務端點，透過 IPv4 和 IPv6 從 AWS AWS CLI、SDK 和 Amazon ECS API 與 Amazon ECS 互動。如需詳細資訊，請參閱使用 Amazon ECS 雙堆疊端點。

主題

先決條件

開始本教學之前，先完成下列動作：

  • 您已完成設定使用 Amazon ECS 一節中的步驟。

  • AWS CLI 已安裝並設定最新版本的 。如需安裝或升級 的詳細資訊 AWS CLI，請參閱AWS Command Line Interface 《 使用者指南》中的安裝或更新至最新版本的 AWS CLI。

  • 已完成「設定以使用 Amazon ECS。」中的步驟。

  • 您有 Amazon ECS 受管執行個體所需的 IAM 角色。其中包含：

    • 基礎設施角色 - 允許 Amazon ECS 代表您呼叫 AWS 服務，以管理 Amazon ECS 受管執行個體基礎設施。

      如需詳細資訊，請參閱Amazon ECS 基礎設施 IAM 角色。

    • 執行個體設定檔 – 為在受管執行個體上執行的 Amazon ECS 容器代理程式與 Docker 常駐程式提供許可。

      執行個體角色名稱必須包含 ecsInstanceRole做為字首，以符合基礎設施角色中的 iam:PassRole 動作。

      如需詳細資訊，請參閱Amazon ECS 受管執行個體執行個體設定檔。

  • 您已建立 VPC 和安全群組。本教學課程使用託管於 Amazon ECR Public 的容器映像，因此您的執行個體必須有網際網路存取權。若要將網際網路的路由提供給執行個體，請使用下列其中一個選項：

    • 透過具有彈性 IP 地址的 NAT 閘道使用私有子網路。

    • 使用公有子網路，並將公有 IP 位址指派給執行個體。

    如需詳細資訊，請參閱建立 Virtual Private Cloud。

    如需有關安全群組與規則的資訊，請參閱 Amazon Virtual Private Cloud User Guide 中的 Default security groups for your VPCs 和 Example rules。

  • （選用） AWS CloudShell 是一種工具，可為客戶提供命令列，而不需要建立自己的 EC2 執行個體。如需詳細資訊，請參閱《AWS CloudShell 使用者指南》中的什麼是AWS CloudShell？。

步驟 1：建立叢集

您的帳戶預設會得到 default 叢集。

注意

使用為您提供之 default 叢集的優點是，您不必在後續的命令中指定 --cluster cluster_name 選項。如果您建立的是自己的叢集，不是預設叢集，您必須在打算對該叢集使用的每個命令中指定 --cluster cluster_name。

使用下列命令以唯一的名稱建立您自己的叢集：

aws ecs create-cluster --cluster-name managed-instances-cluster

輸出：

{
    "cluster": {
        "status": "ACTIVE", 
        "defaultCapacityProviderStrategy": [], 
        "statistics": [], 
        "capacityProviders": [], 
        "tags": [], 
        "clusterName": "managed-instances-cluster", 
        "settings": [
            {
                "name": "containerInsights", 
                "value": "disabled"
            }
        ], 
        "registeredContainerInstancesCount": 0, 
        "pendingTasksCount": 0, 
        "runningTasksCount": 0, 
        "activeServicesCount": 0, 
        "clusterArn": "arn:aws:ecs:region:aws_account_id:cluster/managed-instances-cluster"
    }
}

步驟 2：建立 Amazon ECS 受管執行個體容量提供者

您必須先建立容量提供者來定義基礎結構組態，才能使用 Amazon ECS 受管執行個體執行任務。容量提供者會為受管執行個體指定 IAM 角色、網路組態以及其他設定。

使用容量提供者組態建立 JSON 檔案。使用您的實際資源識別碼取代預留位置的值：

{
    "name": "managed-instances-cp",
    "cluster": "managed-instances-cluster",
    "managedInstancesProvider": {
        "infrastructureRoleArn": "arn:aws:iam::aws_account_id:role/ecsInfrastructureRole",
        "instanceLaunchTemplate": {
            "ec2InstanceProfileArn": "arn:aws:iam::aws_account_id:instance-profile/ecsInstanceRole",
            "networkConfiguration": {
                "subnets": [
                    "subnet-abcdef01234567890",
                    "subnet-1234567890abcdef0"
                ],
                "securityGroups": [
                    "sg-0123456789abcdef0"
                ]
            },
            "storageConfiguration": {
                "storageSizeGiB": 100
            },
            "monitoring": "basic"
        }
    }
}

將此組態儲存為 managed-instances-cp.json 並建立容量提供者：

aws ecs create-capacity-provider --cli-input-json file://managed-instances-cp.json

該命令會在容量提供者建立完成後傳回其描述。

步驟 3：設定叢集的預設容量提供者策略

更新叢集以使用 Amazon ECS 受管執行個體容量提供者作為預設容量提供者策略。這可讓任務和服務自動使用 Amazon ECS 受管執行個體，而無需明確指定容量提供者。

使用叢集容量提供者組態建立 JSON 檔案：

{
    "cluster": "managed-instances-cluster",
    "capacityProviders": [
        "managed-instances-cp"
    ],
    "defaultCapacityProviderStrategy": [
        {
            "capacityProvider": "managed-instances-cp",
            "weight": 1
        }
    ]
}

將此組態儲存為 cluster-cp-strategy.json 並更新叢集：

aws ecs put-cluster-capacity-providers --cli-input-json file://cluster-cp-strategy.json

步驟 4：註冊 Linux 任務定義

您必須先註冊任務定義，才能在您的叢集上執行任務。任務定義是分在一組的容器清單。下列範例是使用託管於 Docker Hub 的 httpd 容器映像來建立 PHP Web 應用程式的簡單任務定義。如需可用之任務定義參數的詳細資訊，請參閱「Fargate 的 Amazon ECS 任務定義參數」。

{
    "family": "sample-managed-instances",
    "networkMode": "awsvpc",
    "containerDefinitions": [
        {
            "name": "managed-instances-app",
            "image": "public.ecr.aws/docker/library/httpd:latest",
            "portMappings": [
                {
                    "containerPort": 80,
                    "hostPort": 80,
                    "protocol": "tcp"
                }
            ],
            "essential": true,
            "entryPoint": [
                "sh",
                "-c"
            ],
            "command": [
                "/bin/sh -c \"echo '<html><head><title>Amazon ECS Sample App</title><style>body {margin-top: 40px; background-color: #333;} </style></head><body><div style=color:white;text-align:center><h1>Amazon ECS Sample App</h1><h2>Congratulations!</h2><p>Your application is now running on a container in Amazon ECS using Amazon ECS Managed Instances.</p></div></body></html>' >  /usr/local/apache2/htdocs/index.html && httpd-foreground\""
            ]
        }
    ],
    "requiresCompatibilities": [
        "MANAGED_INSTANCES"
    ],
    "cpu": "256",
    "memory": "512"
}

將任務定義 JSON 儲存為檔案，並使用 --cli-input-json file://path_to_file.json 選項進行傳遞。

將 JSON 檔案用於容器定義中：

aws ecs register-task-definition --cli-input-json file://$HOME/tasks/managed-instances-task.json

register-task-definition 命令會在完成註冊後傳回任務定義的描述。

步驟 5：列出任務定義

您可以使用 list-task-definitions 命令隨時列出您帳戶的任務定義。這個命令的輸出會顯示 family 和 revision 值，可在呼叫 run-task 或 start-task 時一起使用。

aws ecs list-task-definitions

輸出：

{
    "taskDefinitionArns": [
        "arn:aws:ecs:region:aws_account_id:task-definition/sample-managed-instances:1"
    ]
}

步驟 6：建立服務

為您的帳戶註冊任務之後，您就可以在您的叢集中建立已註冊任務的服務。在此範例中，您將透過在叢集中執行之 sample-managed-instances:1 任務定義的一個執行個體建立服務。該任務需要網際網路的路由，因此您可透過兩種方法達成。一種方法是，使用透過 NAT 閘道所設定的私有子網路，而該閘道在公有子網路中具有彈性 IP 地址。另一種方法是，使用公有子網路並將公有 IP 地址指派至任務。以下提供這兩種範例。

使用私有子網路的範例：

aws ecs create-service --cluster managed-instances-cluster --service-name managed-instances-service --task-definition sample-managed-instances:1 --desired-count 1 --network-configuration "awsvpcConfiguration={subnets=[subnet-abcd1234],securityGroups=[sg-abcd1234]}"

使用公有子網路的範例：

aws ecs create-service --cluster managed-instances-cluster --service-name managed-instances-service --task-definition sample-managed-instances:1 --desired-count 1 --network-configuration "awsvpcConfiguration={subnets=[subnet-abcd1234],securityGroups=[sg-abcd1234],assignPublicIp=ENABLED}"

create-service 命令會在服務建立完成後傳回服務的描述。

步驟 7：列出服務

列出您叢集的服務。您應該會看到您在先前一節所建立的服務。您可以記下這個命令傳回的服務名稱或完整的 ARN，稍後將用以描述服務。

aws ecs list-services --cluster managed-instances-cluster

輸出：

{
    "serviceArns": [
        "arn:aws:ecs:region:aws_account_id:service/managed-instances-cluster/managed-instances-service"
    ]
}

步驟 8：描述正在執行中的服務

使用之前擷取的服務名稱來描述服務，以取得任務的詳細資訊。

aws ecs describe-services --cluster managed-instances-cluster --services managed-instances-service

如果成功，這會傳回服務失敗和服務的描述。例如，在 services 區段中，您將可以找到部署的相關資訊，例如執行中或擱置中的任務狀態。您也可以找到任務定義、網路組態和時間戳記事件的相關資訊。在失敗區段中，您將可以找到與呼叫相關聯的失敗 (如果有的話) 的相關資訊。

輸出將顯示服務正在使用 Amazon ECS 受管執行個體容量提供者：

{
    "services": [
        {
            "capacityProviderStrategy": [
                {
                    "capacityProvider": "managed-instances-cp",
                    "weight": 1,
                    "base": 0
                }
            ],
            "networkConfiguration": {
                "awsvpcConfiguration": {
                    "subnets": [
                        "subnet-abcd1234"
                    ], 
                    "securityGroups": [
                        "sg-abcd1234"
                    ], 
                    "assignPublicIp": "ENABLED"
                }
            }, 
            "enableECSManagedTags": false, 
            "loadBalancers": [], 
            "deploymentController": {
                "type": "ECS"
            }, 
            "desiredCount": 1, 
            "clusterArn": "arn:aws:ecs:region:aws_account_id:cluster/managed-instances-cluster", 
            "serviceArn": "arn:aws:ecs:region:aws_account_id:service/managed-instances-service", 
            "serviceName": "managed-instances-service",
            "taskDefinition": "arn:aws:ecs:region:aws_account_id:task-definition/sample-managed-instances:1"
        }
    ], 
    "failures": []
}

步驟 9：測試

若要測試您的部署，您需要找到執行任務之受管執行個體的公有 IP 位址。

使用公有子網路部署的測試任務

首先，從服務中取得任務 ARN：

aws ecs list-tasks --cluster managed-instances-cluster --service managed-instances-service

輸出包含任務 ARN：

{
    "taskArns": [
        "arn:aws:ecs:region:aws_account_id:task/managed-instances-cluster/EXAMPLE"
    ]
}

描述任務以取得容器執行個體 ARN。將任務 ARN 用於 tasks 參數：

aws ecs describe-tasks --cluster managed-instances-cluster --tasks arn:aws:ecs:region:aws_account_id:task/managed-instances-cluster/EXAMPLE

輸出顯示任務正在 Amazon ECS 受管執行個體上執行，並包含容器執行個體 ARN：

{
    "tasks": [
        {
            "launchType": "MANAGED_INSTANCES",
            "capacityProviderName": "managed-instances-cp",
            "containerInstanceArn": "arn:aws:ecs:region:aws_account_id:container-instance/managed-instances-cluster/CONTAINER_INSTANCE_ID",
            "taskArn": "arn:aws:ecs:region:aws_account_id:task/managed-instances-cluster/EXAMPLE",
            "taskDefinitionArn": "arn:aws:ecs:region:aws_account_id:task-definition/sample-managed-instances:1"
        }
    ]
}

描述容器執行個體以取得 EC2 執行個體 ID：

aws ecs describe-container-instances --cluster managed-instances-cluster --container-instances CONTAINER_INSTANCE_ID

輸出包含 EC2 執行個體 ID：

{
    "containerInstances": [
        {
            "ec2InstanceId": "i-1234567890abcdef0",
            "capacityProviderName": "managed-instances-cp",
            "containerInstanceArn": "arn:aws:ecs:region:aws_account_id:container-instance/managed-instances-cluster/CONTAINER_INSTANCE_ID"
        }
    ]
}

描述 EC2 執行個體以取得公有 IP 位址：

aws ec2 describe-instances --instance-ids i-1234567890abcdef0

輸出中包含公有 IP 位址：

{
    "Reservations": [
        {
            "Instances": [
                {
                    "PublicIpAddress": "198.51.100.2",
                    "InstanceId": "i-1234567890abcdef0"
                }
            ]
        }
    ]
}

在 Web 瀏覽器中輸入公有 IP 位址，然後您應該會看到一個網頁，其中顯示正在 Amazon ECS 受管執行個體上執行的 Amazon ECS 範例應用程式。

使用私有子網路部署的測試任務

對於部署在私有子網路中的任務，您可以使用 Amazon ECS Exec 連線至容器，並從執行個體內測試部署。請遵循上述相同步驟取得任務 ARN，然後使用 ECS Exec：

aws ecs execute-command --cluster managed-instances-cluster \
    --task arn:aws:ecs:region:aws_account_id:task/managed-instances-cluster/EXAMPLE \
    --container managed-instances-app \
    --interactive \
    --command "/bin/sh"

在互動式 Shell 執行後，您可以測試該 Web 伺服器：

curl localhost

您應該會看到相當於 Amazon ECS 範例應用程式網頁的 HTML。

步驟 10：清除

完成此教學課程時，建議您清除相關聯的資源，以免未使用的資源產生費用。

刪除服務：

aws ecs delete-service --cluster managed-instances-cluster --service managed-instances-service --force

等待刪除服務並停止所有任務，然後刪除容量提供者：

aws ecs delete-capacity-provider --capacity-provider managed-instances-cp

刪除 叢集：

aws ecs delete-cluster --cluster managed-instances-cluster
注意

容量提供者刪除後，受管執行個體會自動終止。您無需手動終止 EC2 執行個體。