配置 Docker 环境

有几种方法可以配置 Elastic Beanstalk Docker 环境的行为。

在 Docker 环境中配置软件

您可以使用 Elastic Beanstalk 控制台来配置在您的环境实例上运行的软件。

有关在任何环境中配置软件设置的信息，请参阅环境属性和其他软件设置。以下各部分介绍特定于 Docker 的信息。

容器选项

容器选项部分具有特定于平台的选项。对于 Docker 环境，它允许您选择您的环境是否包含 NGINX 代理服务器。

使用 Docker Compose 的环境

如果您使用 Docker Compose 管理 Docker 环境，Elastic Beanstalk 假定您将代理服务器作为容器运行。因此，对于代理服务器设置，它默认为无，Elastic Beanstalk 不提供 NGINX 配置。

由于对于使用 Docker Compose 的 Amazon Linux 2 平台上的 Docker 已禁用 NGINX Web 服务器代理，因此您必须按照为增强型运行状况报告生成日志的说明操作。有关更多信息，请参阅为增强型运行状况报告生成日志 (Docker Compose)。

环境属性和环境变量

在 Environment properties (环境属性) 部分，您可以在运行应用程序的 Amazon Elastic Compute Cloud (Amazon EC2) 实例上指定环境配置设置。环境属性会以密钥值对的形式传递到应用程序。在 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 Compose）

Docker Amazon Linux 2 平台分支从 2023 年 7 月 28 日平台版本发布起，提供 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 Compose)

Elastic Beanstalk 运行状况代理为 Elastic Beanstalk 环境提供操作系统和应用程序运行状况指标。它依赖于以特定格式中继信息的 Web 服务器日志格式。

Elastic Beanstalk 假设您将 Web 服务器代理作为容器运行。因此，对于运行 Docker Compose 的 Docker 环境禁用 NGINX Web 服务器代理。您必须将服务器配置为以 Elastic Beanstalk 运行状况代理所使用的位置和格式写入日志。这样就可以充分利用增强型运行状况报告，即使禁用了 Web 服务器代理也是如此。

有关如何执行此操作的说明，请参阅Web 服务器日志配置

Docker 容器自定义日志记录 (Docker Compose)

为了有效地排查问题并监控容器化服务，您可以通过环境管理控制台或 EB CLI 从 Elastic Beanstalk 请求实例日志。实例日志由服务包日志和结尾日志组成，可组合并打包以便您能够以高效、直接的方式查看日志和最近事件。

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 Compose)中所述的标准过程进行操作。

Docker 映像

Elastic Beanstalk 的 Docker 和 ECS 托管式 Docker 平台分支，可支持使用公有或私有线上镜像存储库中存储的 Docker 镜像。

在 Dockerrun.aws.json 中按名称指定映像。记下这些约定：

对于仅使用 Docker 平台的环境，您还可以在创建环境期间使用 Dockerfile 构建自己的映像。有关更多信息，请参阅 使用 Dockerfile 构建自定义映像。多容器 Docker 平台不支持此功能。

{
    "Version": "2012-10-17",
    "Statement": [
      {
        "Sid": "AllowEbAuth",
        "Effect": "Allow",
        "Action": [
          "ecr:GetAuthorizationToken"
        ],
        "Resource": [
          "*"
        ]
      },
      {
        "Sid": "AllowPull",
        "Effect": "Allow",
        "Resource": [
          "arn:aws:ecr:us-east-2:account-id:repository/repository-name"
        ],
        "Action": [
          "ecr:GetAuthorizationToken",
          "ecr:BatchCheckLayerAvailability",
          "ecr:GetDownloadUrlForLayer",
          "ecr:GetRepositoryPolicy",
          "ecr:DescribeRepositories",
          "ecr:ListImages",
          "ecr:BatchGetImage"
        ]
      }
    ]
  }

  "Image": {
      "Name": "account-id.dkr.ecr.us-east-2.amazonaws.com/repository-name:latest",
      "Update": "true"
    },

"containerDefinitions": [
        {
        "name": "my-image",
        "image": "account-id.dkr.ecr.us-east-2.amazonaws.com/repository-name:latest",

$ docker login

$ docker login registry-server-url

配置 Docker 环境的托管更新

利用托管平台更新，您可以将环境配置为按计划自动更新为平台的最新版本。

在使用 Docker 环境时，您可能希望确定在新平台版本包括新 Docker 版本时，是否应跨 Docker 版本进行自动平台更新。从运行高于 2.9.0 的 Docker 平台版本的环境中进行更新时，Elastic Beanstalk 支持跨 Docker 版本的托管平台更新。当新平台版本包含 Docker 的新版本时，Elastic Beanstalk 会递增次要更新版本号。因此，要允许托管平台跨 Docker 版本更新，请为托管平台同时启用次版本更新和修补版本更新。要防止托管平台跨 Docker 版本更新，请为托管平台更新启用仅应用修补版本更新。

例如，以下配置文件在每个星期二上午 9:00 (UTC) 启用次版本更新和修补版本更新，从而允许跨 Docker 版本的托管更新：

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

对于运行 Docker 平台版本 2.9.0 或更早版本的环境，在新平台版本包括新 Docker 版本时，Elastic Beanstalk 从不执行托管平台更新。

Docker 配置命名空间

您可以使用配置文件设置配置选项并在部署期间执行其他实例配置。配置选项可以通过您使用的 Elastic Beanstalk 服务或平台定义并组织到命名空间 中。

除了所有 Elastic Beanstalk 环境支持的选项外，Docker 平台还支持以下命名空间中的选项：

以下示例配置文件将 Docker 环境配置为不运行代理服务器。

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

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

如果您的 Elastic Beanstalk Docker 环境使用 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