建立 Amazon ECS 藍/綠部署

開啟主控台，網址為 https://console.aws.amazon.com/ecs/v2。

決定您要從中啟動服務的資源。

建立服務頁面隨即顯示。

在服務詳細資訊下，執行下列動作：

1. 在任務定義系列欄位中選擇要使用的任務定義。然後，在任務定義修訂版欄位中輸入要使用的修訂版。

2. 針對 Service name (服務名稱)，輸入服務的名稱。

若要在現有叢集中執行服務，請在現有叢集欄位中選擇叢集。若要在新叢集中執行服務，請選擇建立叢集

選擇任務在叢集基礎結構中的分佈方式。在運算組態下選擇選項。

在部署組態下，執行下列動作：

1. 在服務類型欄位中選擇複本。

2. 針對 Desired tasks (所需任務)，輸入要在服務中啟動並維護的任務數。

3. 若要讓 Amazon ECS 監控可用區域間的任務分佈，並在出現不平衡時重新分佈，請在可用區域服務重新平衡下，選取可用區域服務重新平衡。

4. 在運作狀態檢查寬限期欄位中，輸入時間 (以秒為單位)，這是服務排程器在任務首次啟動後忽略運作狀態不良的 Elastic Load Balancing、VPC Lattice 與容器運作狀態檢查的時間。如果您未指定運作狀態檢查寬限期間值，則會使用預設值 0。

1. 在封裝時間欄位中，輸入在藍色修訂版終止之前，藍色與綠色服務修訂版將同時執行的分鐘數。這為驗證與測試提供了時間。

2. (選用) 執行要在部署的特定階段執行的 Lambda 函式。在部署 lifecycle hook 下，選取要執行 lifecycle hook 的階段。

   若要新增 lifecycle hook：

   1. 選擇新增。

   2. 在 Lambda 函式欄位中，輸入函式名稱或 ARN。

   3. 在角色欄位中，選取具有調用 Lambda 函式許可的 IAM 角色。

   4. 在生命週期階段欄位中，選取 Lambda 函式應執行的階段。

若要設定 Amazon ECS 如何偵測並處理部署失敗，請展開 Deployment failure detection (部署失敗偵測)，然後選擇您的選項。

1. 若要在任務無法啟動時停止部署，請選取 Use the Amazon ECS deployment circuit breaker (使用 Amazon ECS 部署斷路器)。

   在部署斷路器將部署設定為失敗狀態時，若要讓軟體自動將部署復原至上次完成的部署狀態，請選取失敗時復原。

2. 若要根據應用程式指標停止部署，請選取使用 CloudWatch 警示。然後，從CloudWatch 警示名稱欄位中選擇警示。要建立新的警示，請前往 CloudWatch 主控台。

   在 CloudWatch 警示將部署設定為失敗狀態時，若要讓軟體自動將部署復原至上次完成的部署狀態，請選取失敗時復原。

(選用) 若要使用 Service Connect 與服務互連，請展開 Service Connect 區段，然後指定下列項目：

1. 選取開啟 Service Connect。

2. 在 Service Connect configuration (Service Connect 組態) 下，指定用戶端模式。

   • 如果服務執行的網路用戶端應用程式只需要連線至命名空間中的其他服務，請選擇僅用戶端。

   • 如果服務執行的是網路或 Web 服務應用程式，且需要為此服務提供端點，並連線至命名空間中的其他服務，請選擇 Client and server (用戶端和伺服器)。

3. 若要使用非預設叢集命名空間的命名空間，請在 Namespace (命名空間) 欄位中選擇服務命名空間。這可以是在 AWS 帳戶中同一 AWS 區域中單獨建立的命名空間，也可以是使用 AWS Resource Access Manager (AWS RAM) 與帳戶共用的同一區域中的命名空間。如需有關共用 AWS Cloud Map 命名空間的詳細資訊，請參閱 AWS Cloud Map Developer Guide 中的 Cross-account AWS Cloud Map namespace sharing。

4. (選用) 設定藍/綠部署的測試流量標頭規則。在測試流量路由下，指定下列項目：

   1. 選取啟用測試流量標頭規則，以在測試期間將特定請求路由至綠色服務修訂版。

   2. 在標頭比對規則欄位中，設定路由測試流量的條件：

      • 標頭名稱：輸入要比對的 HTTP 標頭名稱 (例如 X-Test-Version 或 User-Agent)。

      • 比對類型：選擇比對條件：

        • 完全相符：標頭值與指定值完全相符的路由請求

        • 標頭存在：包含指定標頭的路由請求，無論其值為何

        • 模式比對：標頭值與指定模式相符的路由請求

      • 標頭值 (如果使用「完全相符」或「模式相符」)：輸入要比對的值或模式。

      您可以新增多個標頭比對規則來建立複雜的路由邏輯。符合任何已設定規則的請求將路由至綠色服務修訂版進行測試。

   3. 選擇新增標頭規則以設定其他標頭比對條件。

   注意

   測試流量標頭規則讓您可以在完成完整部署之前，使用受控流量驗證新功能。這允許您使用特定請求 (例如來自內部測試工具或 Beta 版使用者的請求) 測試綠色服務修訂版，同時維持流向藍色服務修訂版的正常流量流程。

5. (選用) 指定日誌組態。選取使用日誌收集。預設選項會將容器日誌傳送至 CloudWatch 日誌。其他日誌驅動程式選項會使用 AWS FireLens 來設定。如需更多詳細資訊，請參閱 將 Amazon ECS 日誌傳送至 AWS 服務或 AWS Partner。

   下方更詳細地描述了每個容器日誌目的地。

   • Amazon CloudWatch – 將任務設定為將容器日誌傳送至 CloudWatch Logs。系統會提供預設日誌驅動程式選項，用來代表您建立 CloudWatch 日誌群組。若要指定不同的日誌群組名稱，請變更驅動程式選項值。

   • Amazon Data Firehose – 將任務設定為將容器日誌傳送至 Firehose。系統會提供預設日誌驅動程式選項，用來將日誌傳送至 Firehose 傳送串流。若要指定不同的交付串流名稱，請變更驅動程式選項值。

   • Amazon Kinesis Data Streams – 將任務設定為將容器日誌傳送至 Amazon Kinesis Data Streams。系統會提供預設日誌驅動程式選項，用來將日誌傳送至 Kinesis Data Streams 串流。若要指定不同的串流名稱，請變更驅動程式選項值。

   • Amazon OpenSearch Service – 將任務設定為將容器日誌傳送至 OpenSearch Service 網域。務必提供日誌驅動程式選項。

   • Amazon S3：將任務設定為將容器日誌傳送至 Amazon S3 儲存貯體。系統會提供預設日誌驅動程式選項，但您必須指定有效的 Amazon S3 儲存貯體名稱。

(選用) 設定藍/綠部署的負載平衡。

(選用) 為協助識別您的服務和任務，請展開 Tags (標籤) 區段，然後設定標籤。

若要讓 Amazon ECS 使用叢集名稱和任務定義標籤，自動標記所有新啟動的任務，請選取 Turn on Amazon ECS managed tags (開啟 Amazon ECS 受管標籤)，然後針對 Propagate tags from (傳播標籤來源)，選取 Task definitions (任務定義)。

若要讓 Amazon ECS 使用叢集名稱和服務標籤，自動標記所有新啟動的任務，請選取 Turn on Amazon ECS managed tags (開啟 Amazon ECS 受管標籤)，然後針對 Propagate tags from (傳播標籤來源)，選取 Service (服務)。

新增或移除標籤。

選擇建立。

建立名為 service-definition.json 且具有下列內容的檔案。

將 user-input 取代為實際值。

{
  "serviceName": "myBlueGreenService",
  "cluster": "arn:aws:ecs:us-west-2:123456789012:cluster/sample-fargate-cluster",
  "taskDefinition": "sample-fargate:1",
  "desiredCount": 5,
  "launchType": "FARGATE",
  "networkConfiguration": {
    "awsvpcConfiguration": {
      "subnets": [
        "subnet-09ce6e74c116a2299",
        "subnet-00bb3bd7a73526788",
        "subnet-0048a611aaec65477"
      ],
      "securityGroups": [
        "sg-09d45005497daa123"
      ],
      "assignPublicIp": "ENABLED"
    }
  },
  "deploymentController": {
    "type": "ECS"
  },
  "deploymentConfiguration": {
    "strategy": "BLUE_GREEN",
    "maximumPercent": 200,
    "minimumHealthyPercent": 100,
    "bakeTimeInMinutes": 2,
    "alarms": {
      "alarmNames": [
        "myAlarm"
      ],
      "rollback": true,
      "enable": true
    },
    "lifecycleHooks": [
      {
        "hookTargetArn": "arn:aws:lambda:us-west-2:7123456789012:function:checkExample",
        "roleArn": "arn:aws:iam::123456789012:role/ECSLifecycleHookInvoke",
        "lifecycleStages": [
          "PRE_SCALE_UP"
        ]
      }
    ]
  },
  "loadBalancers": [
    {
      "targetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/blue-target-group/54402ff563af1197",
      "containerName": "fargate-app",
      "containerPort": 80,
      "advancedConfiguration": {
        "alternateTargetGroupArn": "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/green-target-group/cad10a56f5843199",
        "productionListenerRule": "arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/my-blue-green-demo/32e0e4f946c3c05b/9cfa8c482e204f7d/831dbaf72edb911",
        "roleArn": "arn:aws:iam::123456789012:role/LoadBalancerManagementforECS"
      }
    }
  ]
}

執行 create-service。

將 user-input 取代為實際值。

aws ecs create-service --cli-input-json file://service-definition.json

或者，您可以使用下列範例來建立具有負載平衡器組態的藍/綠部署服務：

aws ecs create-service \
   --cluster "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster" \
   --service-name "blue-green-example-service" \
   --task-definition "nginxServer:1" \
   --launch-type "FARGATE" \
   --network-configuration "awsvpcConfiguration={subnets=[subnet-12345,subnet-67890,subnet-abcdef,subnet-fedcba],securityGroups=[sg-12345],assignPublicIp=ENABLED}" \
   --desired-count 3 \
   --deployment-controller "type=ECS" \
   --deployment-configuration "strategy=BLUE_GREEN,maximumPercent=200,minimumHealthyPercent=100,bakeTimeInMinutes=0" \
   --load-balancers "targetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/MyBGtg1/abcdef1234567890,containerName=nginx,containerPort=80,advancedConfiguration={alternateTargetGroupArn=arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/MyBGtg2/0987654321fedcba,productionListenerRule=arn:aws:elasticloadbalancing:us-west-2:123456789012:listener-rule/app/MyLB/1234567890abcdef/1234567890abcdef,roleArn=arn:aws:iam::123456789012:role/ELBManagementRole}"