設定 Elastic Beanstalk 泊塢視窗環境

本章說明所有受支援的 Docker 平台分支 (包括ECS託管 Docker 平台分支) 的其他組態資訊。除非在區段中識別特定的平台分支或平台分支元件，否則它會套用至執行受支援的 Docker 和ECS經過管理的 Docker 平台的所有環境。

在 Docker 環境中設定軟體

您可使用 Elastic Beanstalk 主控台來設定於您環境的執行個體上執行的軟體。

如需有關在任何環境中配置軟體設定的資訊，請參閱 環境屬性與其他軟體設定。以下各節介紹 Docker 的特定資訊。

容器選項

Container options (容器選項) 區段具有平台特定選項。對於 Docker 環境，它可讓您選擇您的環境是否包含NGINX代理伺服器。

使用 Docker Compose 的環境

如果您使用 Docker Compose 來管理 Docker 環境，則 Elastic Beanstalk 會假定您以容器身分來執行代理伺服器。因此，代理伺服器設定的預設值為「無」，且 Elastic Beanstalk 不提供組NGINX態。

由於使用 Docker 撰寫功能的 Amazon Linux 2 平台上的 Docker 停用NGINX網頁伺服器代理伺服器，因此您必須遵循產生記錄以增強健全狀態報告的指示。如需詳細資訊，請參閱使用 Docker 撰寫生成日誌以增強健康報告。

環境屬性和環境變數

環境屬性區段可讓您在執行應用程式的 Amazon 彈性運算雲端 (AmazonEC2) 執行個體上指定環境組態設定。環境屬性會以金鑰值對的形式傳到應用程式。在 Docker 環境中，Elastic Beanstalk 會將環境屬性傳遞給容器做為環境變數。

您在容器中執行的應用程式的程式碼，可以依名稱參照環境變數並讀取其值。讀取這些環境變數的原始程式碼會因程式語言而有所不同。您可以在個別平台主題中，找到在 Elastic Beanstalk 受管平台支援之程式設計語言中讀取環境變數值的指示。如需這些主題的連結清單，請參閱 環境屬性與其他軟體設定。

使用 Docker Compose 的環境

如果您使用 Docker Compose 來管理 Docker 環境，您必須進行一些額外的設定，以擷取容器中的環境變數。若要讓容器中執行的可執行檔存取這些環境變數，您必須在 docker-compose.yml 中參考這些變數。如需詳細資訊，請參閱 在容器中參考環境變數。

在容器中參考環境變數

如果您在 Amazon Linux 2 Docker 平台上使用 Docker Compose 工具，Elastic Beanstalk 會在應用程式專案的根目錄中產生名為 .env 的 Docker Compose 環境。此檔案會存放針對 Elastic Beanstalk 設定的環境變數。

為了讓容器參考您在 Elastic Beanstalk 中定義的環境變數，您必須遵循其中一種或兩種設定方法。

以下檔案提供範例。範例 docker-compose.yml 檔案會示範這兩種方法。

若要進一步了解 Docker Compose 中的環境變數，請參閱 Compose 中的環境變數

使用 Docker 撰寫環境變量的插值功能

從 2023 年 7 月 28 日的平台發行開始，Docker Amazon Linux 2 平台分支提供 Docker Compose 插補功能。使用此功能，Compose 檔案中的值可由變數設定，並在執行期進行插補。如需有關此功能的詳細資訊，請參閱 Docker 文件網站上的插補。

以下是平台勾點指令碼範例，您可以將其設定為允許使用插補功能。

#!/bin/bash

: '
example data format in .env file
key1=value1
key2=value2
'
envfile="/var/app/staging/.env"
tempfile=$(mktemp)

while IFS= read -r line; do
  # split each env var string at '='
  split_str=(${line//=/ })
  if [ ${#split_str[@]} -eq 2 ]; then
    # replace '$$' with '$'
    replaced_str=${split_str[1]//\$\$/\$}
    # update the value of env var using ${replaced_str}
    line="${split_str[0]}=${replaced_str}"
  fi
  # append the updated env var to the tempfile
  echo "${line}" ≫"${tempfile}"
done < "${envfile}"
# replace the original .env file with the tempfile
mv "${tempfile}" "${envfile}"

將平台勾點放在這兩個目錄下：

如需詳細資訊，請參閱本指南的擴充 Linux 平台主題中的 平台勾點。

使用 Docker 撰寫生成日誌以增強健康報告

Elastic Beanstalk 運作狀態代理程式提供 Elastic Beanstalk 環境的作業系統和應用程式運作狀態指標。其依賴以特定格式轉送資訊的 Web 伺服器日誌格式。

Elastic Beanstalk 假設您以容器身分來執行 Web 伺服器 Proxy。因此，在執行 Docker 撰寫的 Docker 環境中，會停用 NGINX Web 伺服器代理伺服器。您必須將伺服器設為以 Elastic Beanstalk 運作狀態代理程式所使用的位置和格式來寫入日誌。這麼做可讓您即使在已停用 Web 伺服器 Proxy 的狀態下，也能充分利用增強型運作狀態報告。

如需如何執行此動作的詳細資訊，請參閱 Web 伺服器日誌組態

使用 Docker 撰寫的碼頭容器自定義日誌記錄

為了有效率地疑難排解問題並監控您的容器化服務，您可以透過環境管理主控台或 EB 向 Elastic Beanstalk 要求執行個體記錄。CLI執行個體日誌由套件日誌和結尾日誌組成，經過組合和封裝，可讓您以有效且直接的方式，檢視日誌和最近的事件。

Elastic Beanstalk 會在容器執行個體上建立日誌目錄，針對 docker-compose.yml 檔案中定義的每個服務建立一個日誌目錄，位置是 /var/log/eb-docker/containers/<service name>。如果您在 Amazon Linux 2 Docker 平台上使用 Docker Compose 功能，您可以將這些目錄掛載到容器檔案結構中寫入日誌的位置。當您掛載日誌目錄以寫入日誌資料時，Elastic Beanstalk 可從這些目錄收集日誌資料。

如果您的應用程式位於未使用 Docker Compose 的 Docker 平台上，則可以遵循 使用 Docker 撰寫的碼頭容器自定義日誌記錄 中所述的標準程序。

Docker 影像

適用於 Elastic Beanstalk 的 Docker 和ECS託管式碼頭平台分支支援使用儲存在公共或私人線上映像儲存庫中的 Docker 映像檔。

根據 Dockerrun.aws.json 中的名稱來指定映像。請注意這些慣例：

您也可以在環境建立期間，使用 Dockerfile 建置自己的映像。這僅適用於使用 Docker 平台的環境。如需詳細資訊，請參閱「透過 Dockerfile 建置自訂映像」。ECS託管的 Docker 平台平台不支持此功能。

為 Docker 環境設定受管更新

使用受管平台更新，您可以設定環境，根據排程自動更新至平台的最新版本。

如果是 Docker 環境，您可能會要決定自動平台更新是否應跨 Docker 版本實施 — 當新的平台版本包含新的 Docker 版本時。當從執行 2.9.0 版本以上的 Docker 平台版本的環境更新時，Elastic Beanstalk 支援跨 Docker 版本的受管理平台更新。當新的平台版本包含新版本的 Docker 時，Elastic Beanstalk 便會增加小型更新版本的號碼。因此，要允許跨 Docker 版本的受管平台更新，啟用次要和修補程式版本更新的受管平台更新。要避免跨 Docker 版本的受管平台更新，僅啟用修補程式版本更新的受管平台更新。

例如，下列組態檔案會在UTC每個星期二上午 9:00 針對次要版本和修補程式版本更新啟用受管理平台更新，因此允許跨 Docker 版本進行受管理的更新：

option_settings:
  aws:elasticbeanstalk:managedactions:
    ManagedActionsEnabled: true
    PreferredStartTime: "Tue:09:00"
  aws:elasticbeanstalk:managedactions:platformupdate:
    UpdateLevel: minor

針對執行 2.9.0 或更早版本 Docker 平台的環境，若新的平台版本包含新的 Docker 版本，則 Elastic Beanstalk 永遠不會執行受管平台更新。

Docker 組態命名空間

您可以使用組態檔案來設定組態選項，並在部署期間執行其他的執行個體設定工作。組態選項可由 Elastic Beanstalk 服務或您使用的平台來定義，並且會組織成「命名空間」。

除了適用於所有 Elastic Beanstalk 環境的支援選項之外，Docker 也支援使用下列命名空間的選項：

下列範例配置檔案會將 Docker 環境設定為在沒有代理伺服器的情況下運作。

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: none

Amazon Linux 上的碼頭配置AMI（在 Amazon Linux 2 之前）

如果您的 Elastic Beanstalk 泊塢視窗環境使用 Amazon Linux AMI 平台版本（在 Amazon Linux 2 之前），請閱讀本節中的其他信息。

{
    "auths":{
      "server":{
        "auth":"key"
      }
    }
  }

{
    "server" :
    {
      "auth" : "auth_token",
      "email" : "email"
    }
  }

option_settings:
  aws:autoscaling:launchconfiguration:
    BlockDeviceMappings: /dev/xvdcz=:100::io1:500

option_settings:
  aws:autoscaling:launchconfiguration:
    BlockDeviceMappings: /dev/xvdcz=:12:true:gp2,/dev/sdh=:24