教學課程：使用 YAML 檔案部署多容器群組

發行項
04/29/2024

Azure 容器執行個體支援使用容器群組將多個容器部署至單一主機。在建置應用程式 Sidecar 以便記錄、監視或進行服務需要第二個附加程序的任何其他設定時，容器群組非常有用。

在本教學課程中，您會遵循步驟，藉由使用 Azure CLI 部署 YAML 檔案，以執行簡單的雙容器 Sidecar 組態。 YAML 檔案提供精簡的格式，以指定執行個體設定。您將學習如何：

設定 YAML 檔案
部署容器群組
檢視容器記錄

注意

多容器群組目前僅限於 Linux 容器。

如果您沒有 Azure 訂閱，請在開始之前，先建立 Azure 免費帳戶。

必要條件

在 Azure Cloud Shell 中使用 Bash 環境。如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。
若要在本地執行 CLI 參考命令，請安裝 Azure CLI。若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。
- 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。請遵循您終端機上顯示的步驟，完成驗證程序。如需其他登入選項，請參閱使用 Azure CLI 登入。
- 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。
- 執行 az version 以尋找已安裝的版本和相依程式庫。若要升級至最新版本，請執行 az upgrade。

設定 YAML 檔案

若要在 Azure CLI 中使用 az container create 命令部署多容器群組，您必須在 YAML 檔案中指定群組組態。然後將 YAML 檔案以參數形式傳遞給命令。

一開始先將下列 YAML 複製到名為 deploy-aci.yaml 的新檔案中。在 Azure Cloud Shell 中，您可以使用 Visual Studio Code，在工作目錄中建立檔案：

code deploy-aci.yaml

此 YAML 檔案會定義名為 "myContainerGroup"，且含有兩個容器 (一個公用 IP 位址和兩個公開連接埠) 的容器群組。容器是從公有 Microsoft 映像部署。群組中第一個容器會執行網際網路對向的 Web 應用程式。第二個容器 sidecar 會透過容器群組的區域網路，定期對第一個容器中執行的 Web 應用程式執行 HTTP 要求。

apiVersion: 2019-12-01
location: eastus
name: myContainerGroup
properties:
  containers:
  - name: aci-tutorial-app
    properties:
      image: mcr.microsoft.com/azuredocs/aci-helloworld:latest
      resources:
        requests:
          cpu: 1
          memoryInGb: 1.5
      ports:
      - port: 80
      - port: 8080
  - name: aci-tutorial-sidecar
    properties:
      image: mcr.microsoft.com/azuredocs/aci-tutorial-sidecar
      resources:
        requests:
          cpu: 1
          memoryInGb: 1.5
  osType: Linux
  ipAddress:
    type: Public
    ports:
    - protocol: tcp
      port: 80
    - protocol: tcp
      port: 8080
tags: {exampleTag: tutorial}
type: Microsoft.ContainerInstance/containerGroups

若要使用私人容器映像登錄，請將 imageRegistryCredentials 屬性新增至容器群組，包含針對您的環境修改的值：

  imageRegistryCredentials:
  - server: imageRegistryLoginServer
    username: imageRegistryUsername
    password: imageRegistryPassword

部署容器群組

使用 az group create 命令，建立資源群組：

az group create --name myResourceGroup --location eastus

使用 az container create 命令，部署容器群組，以引數的形式傳遞 YAML 檔案：

az container create --resource-group myResourceGroup --file deploy-aci.yaml

在幾秒內，您應該會從 Azure 收到首次回應。

檢視部署狀態

若要檢視部署狀態，請使用下列 az container show 命令：

az container show --resource-group myResourceGroup --name myContainerGroup --output table

若要檢視執行中的應用程式，請在瀏覽器中瀏覽至其公用 IP 位址。例如，在此範例輸出中，IP 是 52.168.26.124：

Name              ResourceGroup    Status    Image                                                                                               IP:ports              Network    CPU/Memory       OsType    Location
----------------  ---------------  --------  --------------------------------------------------------------------------------------------------  --------------------  ---------  ---------------  --------  ----------
myContainerGroup  danlep0318r      Running   mcr.microsoft.com/azuredocs/aci-tutorial-sidecar,mcr.microsoft.com/azuredocs/aci-helloworld:latest  20.42.26.114:80,8080  Public     1.0 core/1.5 gb  Linux     eastus

檢視容器記錄

使用 az container logs 命令，檢視容器的記錄輸出。 --container-name 引數會指定要從中提取記錄的容器。在此範例中，已指定 aci-tutorial-app 容器。

az container logs --resource-group myResourceGroup --name myContainerGroup --container-name aci-tutorial-app

輸出：

listening on port 80
::1 - - [02/Jul/2020:23:17:48 +0000] "HEAD / HTTP/1.1" 200 1663 "-" "curl/7.54.0"
::1 - - [02/Jul/2020:23:17:51 +0000] "HEAD / HTTP/1.1" 200 1663 "-" "curl/7.54.0"
::1 - - [02/Jul/2020:23:17:54 +0000] "HEAD / HTTP/1.1" 200 1663 "-" "curl/7.54.0"

若要查看 Sidecar 容器的記錄，請執行類似指定 aci-tutorial-sidecar 容器的命令。

az container logs --resource-group myResourceGroup --name myContainerGroup --container-name aci-tutorial-sidecar

輸出：

Every 3s: curl -I http://localhost                          2020-07-02 20:36:41

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0  1663    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
HTTP/1.1 200 OK
X-Powered-By: Express
Accept-Ranges: bytes
Cache-Control: public, max-age=0
Last-Modified: Wed, 29 Nov 2017 06:40:40 GMT
ETag: W/"67f-16006818640"
Content-Type: text/html; charset=UTF-8
Content-Length: 1663
Date: Thu, 02 Jul 2020 20:36:41 GMT
Connection: keep-alive

如您所見，Sidecar 會透過群組的區域網路定期地向主要 Web 應用程式提出 HTTP 要求，以確保它正在執行。您可以擴充此 Sidecar 範例，以便在其收到 200 OK 以外的 HTTP 回應碼時觸發警示。

下一步

在本教學課程中，您使用 YAML 檔案，在 Azure 容器執行個體中部署多容器群組。您已了解如何︰

為多容器群組設定 YAML 檔案
部署容器群組
檢視容器記錄

您也可以使用 Resource Manager 範本，指定多容器群組。當您需要使用容器群組來部署其他 Azure 服務資源時，可以隨時調整 Resource Manager 範本以因應各種情況。