全部產品
Search
文件中心

Elastic Container Instance:設定容器啟動和退出順序

更新時間:Jul 06, 2024

本文介紹如何通過環境變數的方式,為一個ECI執行個體內的各個容器設定啟動和退出優先順序,實現容器按順序啟動和退出。

功能說明

預設情況下,ECI執行個體內的各個容器是並發進行啟動和退出的,沒有固定的前後順序。在某些情境下,一個執行個體內的多個容器之間可能存在依賴關係,某一容器需要在另一容器啟動後再啟動,或者某一容器需要在另一容器退出後再退出。例如:

  • istio服務治理情境,需要保證在業務容器產生流量時,istio-proxy容器已經Ready;在業務容器退出後,istio-proxy容器才退出。

  • 採集日誌時,需要保證在業務容器產生日誌前,日誌容器已經Ready;在業務容器退出後,日誌容器才退出。

針對上述情境,ECI支援通過設定容器環境變數的方式,為ECI執行個體內的容器設定啟動和退出優先順序。您可以按照您的業務需求為容器添加相應的環境變數,來保證容器按順序啟動或按順序退出。

配置說明

設定容器啟動和退出順序的環境變數如下:

配置項

環境變數名稱

配置說明

容器啟動優先順序

ECI_CONTAINER_LAUNCH_PRIORITY

  • 取值範圍為-1000~1000,預設值為0。數值越大,啟動優先順序越高。

  • 優先順序高的容器保證會在優先順序低的容器啟動之前啟動,相同優先順序的容器不保證啟動順序(並發啟動)。

  • 如果某容器依賴上一個容器提供服務,需要為容器配置Readiness Probe。例如:B容器依賴A容器提供服務,則在設定A容器的啟動優先順序高於B容器的同時,還需要為A容器配置Readiness Probe,確保A容器準備就緒後才啟動B容器。

容器退出優先順序

ECI_CONTAINER_EXIT_PRIORITY

  • 取值範圍為-1000~1000,預設值為0。數值越大,退出優先順序越高。

  • 優先順序高的容器保證會在優先順序低的容器退出之前退出,相同優先順序的容器不保證退出順序(並發退出)。

重要

通過OpenAPI建立ECI執行個體時,可以設定TerminationGracePeriodSeconds來保證執行個體優雅退出,此時如果設定了容器退出順序,執行個體總體的銷毀時間可能會大於TerminationGracePeriodSeconds聲明的時間。

配置樣本

設定容器啟動順序

API

  1. 建立一台設定了容器啟動順序的ECI執行個體。

    調用CreateContainerGroup介面建立ECI執行個體所採用的參數樣本如下,執行個體內包含兩個容器,c1容器的啟動優先順序高於c2容器,且c1容器配置了Readiness Probe,c2容器會在c1容器準備就緒後才啟動。

    {
      "RegionId": "cn-beijing",
      "SecurityGroupId": "sg-2ze63v3jtm8e6syi****",
      "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
      "ContainerGroupName": "test-launch",
      "Container": [
        {
          "Name": "c1",
          "Image": "registry.cn-shanghai.aliyuncs.com/eci_open/nginx:alpine",
          "EnvironmentVar": [
            {
              "Key": "ECI_CONTAINER_LAUNCH_PRIORITY",
              "Value": "1000"
            }
          ],
          "ReadinessProbe.PeriodSeconds": 3,
          "ReadinessProbe.HttpGet.Path": "/",
          "ReadinessProbe.HttpGet.Port": 80
        },
        {
          "Name": "c2",
          "Image": "registry.cn-shanghai.aliyuncs.com/eci_open/nginx:alpine",
          "EnvironmentVar": [
            {
              "Key": "ECI_CONTAINER_LAUNCH_PRIORITY",
              "Value": "0"
            }
          ],
          "Arg": [
            "/bin/sh",
            "-c",
            "sleep 3600s"
          ]
        }
      ]
    }
  2. 查看執行個體詳情,確認各個容器的啟動時間。

    調用DescribeContainerGroups查詢執行個體詳情,在返回資訊的Containers中查看各個容器的詳細資料,通過CurrentState.StartTime欄位,可以看出c2容器的啟動時間晚於c1容器。

控制台

通過Elastic Container Instance控制台建立ECI執行個體時,您可以在各個容器的進階配置中設定環境變數,為容器設定啟動優先順序,同時在健康檢查處可以設定Readiness Probe(即應用業務探針)。

容器啟動-控制台.png

建立完成後,您可以通過查看執行個體事件,確認各個容器的啟動順序。

設定容器退出順序

API

  1. 建立一台設定了容器退出順序的ECI執行個體。

    調用CreateContainerGroup介面建立ECI執行個體所採用的參數樣本如下,執行個體設定了TerminationGracePeriodSeconds為30s,包含三個容器,容器退出優先順序從高到低依次為c1、c2、c3。

    {
      "RegionId": "cn-beijing",
      "ContainerGroupName": "test-exit",
      "SecurityGroupId": "sg-2ze63v3jtm8e6syi****",
      "VSwitchId": "vsw-2ze94pjtfuj9vaymf****",
      "TerminationGracePeriodSeconds": 30,
      "Container": [
        {
          "Name": "c1",
          "Image": "registry.cn-shanghai.aliyuncs.com/eci_open/nginx:alpine",
          "EnvironmentVar": [
            {
              "Key": "ECI_CONTAINER_EXIT_PRIORITY",
              "Value": "1000"
            }
          ]
        },
        {
          "Name": "c2",
          "Image": "registry.cn-shanghai.aliyuncs.com/eci_open/nginx:alpine",
          "EnvironmentVar": [
            {
              "Key": "ECI_CONTAINER_EXIT_PRIORITY",
              "Value": "0"
            }
          ],
          "Arg": [
            "/bin/sh",
            "-c",
            "sleep 3600s"
          ]
        },
        {
          "Name": "c3",
          "Image": "registry.cn-shanghai.aliyuncs.com/eci_open/nginx:alpine",
          "EnvironmentVar": [
            {
              "Key": "ECI_CONTAINER_EXIT_PRIORITY",
              "Value": "-1000"
            }
          ],
          "Arg": [
            "/bin/sh",
            "-c",
            "sleep 3600s"
          ]
        }
      ]
    }
  2. 刪除執行個體,然後觀察執行個體內容器Killing事件的順序。

    說明

    如果需要確認容器退出順序,請及時查看事件,ECI執行個體徹底刪除後可能無法觀察到相關事件。

    調用DescribeContainerGroupEvents查詢執行個體事件,在返回資訊的Events中查看各個容器Killing事件的時間,可以看出容器退出順序依次為c1、c2、c3。

控制台

通過Elastic Container Instance控制台建立ECI執行個體時,您可以在各個容器的進階配置中設定環境變數,為容器設定退出優先順序。

容器退出-控制台.png