View a markdown version of this page

更新 Amazon ECS Express Mode 服務 - Amazon Elastic Container Service
部署行為程序

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

更新 Amazon ECS Express Mode 服務

快速模式服務透過提供聯網、負載平衡和 Application Auto Scaling 的可設定選項，以及協調這些服務的變更，來簡化服務更新程序。

您可以更新快速模式服務來修改容器映像、調整資源配置或變更組態設定。使用 Canary 部署搭配警示型復原警示來部署更新，以維持可用性。

部署行為

根據預設，快速模式服務會使用 Canary 部署，以確保安全更新和快速復原：

  • 建立新的環境，並隨您的變更部署任務

  • 5% 的流量會轉移到新環境

  • 如果 3 分鐘內 2 個資料點的 4xx 和 5xx 錯誤百分比總和 > 1，則會觸發警示型轉返

  • 運作狀態檢查會驗證新任務是否正常運作

  • 3 分鐘後，100% 的流量會轉移到新環境

  • 經過 3 分鐘的製作時間進行監控後，舊任務會逐漸停止並取代

如需詳細資訊，請參閱 Amazon ECS Canary 部署

程序

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

  2. 在導覽窗格中，選擇叢集。

  3. 在叢集頁面上，選擇包含快速模式服務的叢集名稱。

  4. 在叢集詳細資訊頁面上，選擇服務索引標籤。

  5. 設定篩選條件以檢視您的快速模式服務。針對篩選資源管理類型，選擇 ECS。

    快速模式服務的名稱旁有一個快速徽章。

  6. 在組態下：

    1. 指定要用於應用程式的映像。針對映像 URI，輸入映像的 URI。若要瀏覽 Amazon ECR 映像，請選擇瀏覽 ECR 映像，然後執行下列動作：

      1. 針對私有儲存庫，選擇 Amazon ECR 私有儲存庫。

      2. 針對映像，選擇您的映像。

      3. 選擇如何識別映像。針對選取影像依據，選擇下列其中一個選項：

        • AWS 建議您選擇映像摘要。

        • 若要使用標籤，請選擇映像標籤，然後選擇標籤。

    2. 若要使用私有登錄檔，請選取私有登錄檔。然後，針對 Secrets Manager ARN 或名稱，輸入您在先決條件中建立的 Secrets Manager ARN。

    3. 針對任務執行角色，選擇角色或建立新的角色並重新整理。當您需要新增其他許可時，可以更新任務執行角色。

  7. 在其他組態下，自訂您的服務。

    1. 在容器下：

      1. 針對容器連接埠，更新應用程式接聽的連接埠 （預設為 80)。

      2. 對於運作狀態檢查路徑，請更新運作狀態檢查的路徑 （例如 /health)。

    2. 在環境變數下，為您的應用程式需要的環境變數新增索引鍵/值對：

      1. 針對金鑰，輸入環境變數名稱。

      2. 針對值類型，選擇環境變數或秘密。

      3. 針對值或值來源，輸入值或參考。

      4. 選擇新增環境變數，視需要新增更多變數。

    3. 在 Command 中，選擇性地輸入自訂命令來覆寫 Docker CMD 指令。

    4. 針對任務角色，新增 IAM 角色，將許可授予在容器中執行的應用程式。這可讓您的應用程式對 AWS 服務進行 API 呼叫。

    5. 在運算下：

      1. 對於 CPU，請更新任務的 vCPU 配置 （例如 1 個 vCPU)。

      2. 針對記憶體，請更新任務的記憶體配置 （例如 2 GB)。

    6. 在 Auto Scaling 下：

      1. 對於 ECS 服務指標，選擇要擴展的指標 （例如，ECS 服務平均記憶體使用率或每個目標的請求計數)。

      2. 針對目標值，輸入擴展的目標 （例如 60 或 1000)。

      3. 針對任務數量下限和任務數量上限，更新擴展限制。

    7. 在日誌下：

      1. 對於 Amazon CloudWatch 日誌群組，請更新應用程式日誌的日誌群組名稱。請注意，這不會移動現有的日誌，而是開始從新的服務修訂版寫入日誌。

      2. 針對 Amazon CloudWatch 日誌串流字首，輸入日誌串流的新字首。

  8. 選擇更新以更新您的快速模式服務。

使用自訂任務定義更新

您可以指定 taskDefinitionArn 參數，以自訂任務定義更新您的快速模式服務。快速模式會依原狀使用您的任務定義，並繼續管理其餘的基礎設施。

在後續更新中，您可以：

  • 建立新的任務定義修訂，並更新 taskDefinitionArn。快速模式使用新修訂版進行下一個服務部署。

  • 直接更新快速模式參數：

    • 對於與任務定義無關的參數 （例如 healthCheckPath、 或 scalingTarget)networkConfiguration，快速模式會套用變更，而不修改任務定義。

    • 對於任務定義相關參數 （例如使用 或 cpu/ 的映像、CPU primaryContainer或記憶體memory)，快速模式會使用您的變更建立新的受管任務定義，同時保留其他任務層級組態。

使用自訂任務定義更新 (Amazon ECS 主控台）

  1. 開啟 Amazon ECS 主控台並導覽至您的快速模式服務。

  2. 選擇更新服務旁的下拉箭頭，然後選擇使用自訂任務定義更新。

  3. 針對任務定義系列，選取現有的任務定義系列。若要建立新的任務定義，請選擇任務定義連結。

  4. 對於任務定義修訂，選取要使用的修訂，或保留空白以使用最新的修訂。

  5. （選用） 展開其他組態以更新運作狀態檢查路徑、聯網或自動擴展設定。

  6. 選擇更新。

下列 AWS AWS CLI 命令會使用自訂任務定義更新您的快速模式服務：

aws ecs update-express-gateway-service \
    --service-arn arn:aws:ecs:us-west-2:123456789012:service/default/my-service \
    --task-definition-arn arn:aws:ecs:us-west-2:123456789012:task-definition/my-td:4
注意

如果您是第一次使用 CloudFormation 和 taskDefinitionArn新增至快速模式服務，請先重新部署堆疊一次。這可確保復原相容性。