跳至內容

如何對已中斷連線的 Amazon ECS 代理程式進行疑難排解?

3 分的閱讀內容
0

我的 Amazon Elastic Container Service (Amazon ECS) 的容器執行個體已中斷連線。

簡短說明

您的 Amazon ECS 容器代理程式在一小時內多次斷線並重新連線,屬於正常運作範圍。變更事件僅持續幾分鐘是預期中的狀況,不一定代表容器代理程式或容器執行個體有問題。

但是,如果容器代理程式長時間處於中斷連線狀態,那麼該容器執行個體將無法作為您 Amazon ECS 叢集的一部分運作。此問題可能是下列原因之一所致:

  • 網路問題導致該執行個體與 Amazon ECS 之間無法通訊。
  • 容器代理程式沒有與 Amazon ECS 端點通訊所需的 AWS Identity and Access Management (IAM) 許可。
  • 容器執行個體內的主機或 Docker 常駐程式有問題。
  • 底層主機存在資源爭用問題。

最佳實務是使用最新版 Amazon ECS 容器代理程式。

解決方法

注意: 下列解決方案適用於 Amazon ECS 最佳化 Amazon Linux 2023 AMI。

您可以使用 SSH 金鑰連線到您的 Amazon EC2 執行個體。如果您尚未產生 SSH 金鑰,可以使用 Session Manager (AWS Systems Manager 的一項功能) 來連線到您的執行個體。根據預設,Systems Manager Agent 安裝在 Amazon Linux 2023 AMI 和 Amazon Linux 2023 ECS 最佳化基本 AMI 上。

確認容器代理程式是否正在容器執行個體上執行

若要確認 Amazon ECS 容器代理程式的狀態和連線,請在容器執行個體上執行下列其中一個命令:

sudo systemctl status ecs
sudo docker ps -f name=ecs-agent

輸出會顯示 active (作用中),並類似以下內容:

ecs.service - Amazon Elastic Container Service - container agent
        Loaded: loaded (/usr/lib/systemd/system/ecs.service; enabled; preset: disabled)
        Active: active (running) since Thu 2026-02-19 08:42:39 UTC; 1min 17s ago
          Docs: https://aws.amazon.com/documentation/ecs/
     Main PID: 2578 (amazon-ecs-init)
        Tasks: 5 (limit: 9497)
       Memory: 136.5M
          CPU: 214ms
       CGroup: /system.slice/ecs.service
               └─2578 /usr/libexec/amazon-ecs-init start
CONTAINER ID  IMAGE                           COMMAND   CREATED         STATUS
8ab4e7c372d7  amazon/amazon-ecs-agent:latest  "/agent"  2 minutes ago   Up 2 minutes (healthy)

如果問題是代理程式中斷連線所引起,則執行下列命令重新啟動 ECS 代理程式:

sudo systemctl restart ecs

注意: 執行上述命令後,不會傳回任何輸出。

若要確認代理程式是否正在執行,請執行下列命令:

sudo systemctl status ecs

確認 Docker 服務是否在容器執行個體上執行

若要確認 Docker 服務是否在受影響的容器執行個體上執行,請執行下列命令:

sudo systemctl status docker

輸出會顯示 active (作用中),並類似以下內容:

docker.service - Docker Application Container Engine
        Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; preset: disabled)
        Active: active (running) since Thu 2026-02-19 08:42:37 UTC; 3min 46s ago
   TriggeredBy: docker.socket
          Docs: https://docs.docker.com
     Main PID: 2314 (dockerd)
        Tasks: 13
       Memory: 485.3M
          CPU: 4.846s
       CGroup: /system.slice/docker.service
               └─2314 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock --default-ulimit nofile=32768:65536

如果 Docker 服務處於非作用中狀態,則執行以下命令重新啟動 Docker 服務:

sudo systemctl restart docker

注意: 執行上述命令後,不會傳回任何輸出。

若要確認 Docker 服務已重新啟動,請執行下列命令:

sudo systemctl status docker

查看容器代理程式和 Docker 的日誌檔案

如果您的容器執行個體仍然處於斷線狀態,請查看容器主機上的容器代理程式和 Docker 的日誌檔案。

檢查下列日誌檔案以尋找關鍵字,例如 "error"、"warn" 或 "agent transition state":

  • 查看 Amazon ECS 容器代理程式的最新日誌,位於 /var/log/ecs/ecs-agent.log。您可以透過篩選到 /var/log/ecs/ecs-agent-log.timestamp 來查看輪換日誌
  • 查看 /var/log/ecs/ecs-init.log 中的 Amazon ECS init 日誌
  • 查看 /var/log/cloud-init.log 中的使用者資料執行日誌
  • 使用命令 sudo journalctl -u docker 查看 Docker 常駐程式日誌

如果您使用 Linux,那麼您也可以查看退出代碼,以取得有關已停止代理程式容器的更多資訊。

若要取得退出程式碼,請執行下列命令:

docker inspect <your container ID>

注意: 請將您的容器 ID 替換為已停止容器的 ID。

您可以使用 Amazon ECS 日誌收集器收集 Amazon ECS 的一般作業系統日誌、Docker 日誌和容器代理程式日誌。

確認 IAM 執行個體設定檔是否具有必要的許可

如果容器代理程式仍中斷連線,請確認與容器執行個體相關聯的 IAM 執行個體設定檔具有必要的 IAM 許可:

  1. 使用 SSH 或 Session Manager 連線到執行個體。

  2. 若要查看與執行個體關聯的執行個體設定檔上的執行個體中繼資料,請執行下列命令:

    TOKEN=$(curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600")
    curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/iam/info

    輸出內容大致如下:

    {
       "Code" : "Success",
       "LastUpdated" : "2026-02-19T08:42:14Z",
       "InstanceProfileArn" : "arn:aws:iam::1122334455:instance-profile/ecsInstanceRole",
       "InstanceProfileId" : "AIPA4VIZXOFF55F72XIZN"
    }
  3. 確認 IAM 角色包含容器執行個體的正確許可。

  4. 若要確認特定的憑證錯誤,請執行下列命令以檢查容器代理程式日誌:

    cat /var/log/ecs/ecs-agent.log.YYYY-MM-DD-##

    注意: 請將 YYYY-MM-DD-## 替換為相關時間戳記。

    容器代理程式日誌每小時輪換一次。尾碼會自動變更,以反映目前的日期和時間。更新命令以包含問題發生時的日期範圍和日誌 ID。

確認您的容器執行個體具有足夠的資源來執行 ECS 代理程式

如果您的任務具有較高的記憶體或 CPU 使用率,那麼您的容器執行個體可能沒有足夠的資源來執行 ECS 代理程式。

Amazon ECS 容器代理程式使用 Docker ReadMemInfo() 函式查詢作業系統可用的記憶體量。

在您的容器執行個體上執行下列命令,以查看作業系統識別的總記憶體:

free -b

執行針對 Amazon ECS 最佳化的 Amazon Linux 2023 AMI 的 t2.large 執行個體的範例輸出結果:

               total        used        free      shared  buff/cache   available
Mem:     8327938048   337494016  6402355200      557056  1588088832  7745118208
Swap:             0           0           0

您可以為 Amazon ECS 容器代理程式及其他重要系統程序在您的容器執行個體上保留部分記憶體。保留這部分記憶體,有助於確認您的工作負載容器不會與其他程序爭用相同的記憶體資源。如需更多資訊,請參閱 Reserving Amazon ECS Linux container instance memory (預留 Amazon ECS Linux 容器執行個體記憶體)。

確認環境變數 ECS_CLUSTER 具有正確的叢集名稱

如果 Amazon ECS 容器代理程式組態參數 ECS_CLUSTER 具有錯誤的叢集名稱,則該容器執行個體將無法加入叢集。若要檢查 /etc/ecs/ecs.config 檔案的內容並確認此參數,請執行以下命令:

cat /etc/ecs/ecs.config

確認 ECS 代理程式能夠與 ECS 端點進行通訊

若要連線 ECS 端點,網路存取控制清單和容器執行個體安全群組必須允許連接埠 443 (HTTPS) 上的傳出連線。

如果您的容器執行個體位於公有子網路中,請確認該執行個體具備公有 IP 位址,且該子網路的路由表有指向網際網路閘道的路由。

如果您的容器執行個體位於私有子網路中,請確認該子網路的路由表有指向 NAT 閘道的路由,或是您已為 Amazon ECS 設定 VPC 端點。

若要檢查到 ECS 端點 (ACS/TCS) 的傳出連線,請在容器執行個體上執行下列其中一個命令:

sudo yum install telnet -y
telnet ecs.REGION.amazonaws.com 443

或

curl https://ecs.REGION.amazonaws.com

注意: 請將 REGION 替換為您的 AWS 區域。

請檢視下列最佳實務:

  • 除非您的應用程式需要特定的作業系統或針對 Amazon ECS 最佳化的 AMI 中不適用的 Docker 版本,否則請使用針對 Amazon ECS 最佳化的 AMI 來執行您的 ECS 工作負載。
  • 請使用最新版的 Amazon ECS 容器代理程式。最新版本包含強化的功能並提供重要的更新。
  • 設定任務的 CPU 和記憶體限制。

相關資訊

Amazon ECS troubleshooting (Amazon ECS 疑難排解)

Amazon ECS container instance IAM role (Amazon ECS 容器執行個體 IAM 角色)

Viewing Amazon ECS container agent logs (查看 Amazon ECS 容器代理程式日誌)

AWS 官方已更新 8 個月前