Amazon ECS 容器代理

Amazon ECS 容器代理是 Amazon Elastic Container Service（Amazon ECS）的一个组件，负责代表 Amazon ECS 管理容器。

本仓库包含 ECS-Init，这是一个基于 systemd 的服务，用于支持 Amazon ECS 容器代理并保持其运行。它用于使用 systemd 作为初始化系统的系统，并以 deb 或 rpm 包的形式提供。ECS-Init 的源代码可在本仓库的 ./ecs-init 目录中找到，而打包文件在 ./packaging 目录中。

使用方法

运行此软件的最佳信息来源是 Amazon ECS 文档。

在 Amazon Linux AMI 上

在 Amazon Linux AMI 上，我们提供了一个可安装的 RPM 包，可以通过 sudo yum install ecs-init && sudo start ecs 使用。这是在此环境中运行它的推荐方式。

在其他 Linux AMI 上

Amazon ECS 文档 提供了 deb 和 rpm 包以及在非 Amazon Linux 实例上安装 ECS 容器代理的说明。

Amazon ECS 容器代理也可以在安装了最新 Docker 版本的 EC2 实例上的 Docker 容器中运行。Docker 镜像可在 Docker Hub 仓库 和 ECR 公共库 中获取。

# 设置代理使用的目录
mkdir -p /var/log/ecs /etc/ecs /var/lib/ecs/data
touch /etc/ecs/ecs.config
# 设置必要的规则以启用任务的 IAM 角色
sysctl -w net.ipv4.conf.all.route_localnet=1
iptables -t nat -A PREROUTING -p tcp -d 169.254.170.2 --dport 80 -j DNAT --to-destination 127.0.0.1:51679
iptables -t nat -A OUTPUT -d 169.254.170.2 -p tcp -m tcp --dport 80 -j REDIRECT --to-ports 51679
# 运行代理
docker run --name ecs-agent \
    --detach=true \
    --restart=on-failure:10 \
    --volume=/var/run/docker.sock:/var/run/docker.sock \
    --volume=/var/log/ecs:/log \
    --volume=/var/lib/ecs/data:/data \
    --net=host \
    --env-file=/etc/ecs/ecs.config \
    --env=ECS_LOGFILE=/log/ecs-agent.log \
    --env=ECS_DATADIR=/data/ \
    --env=ECS_ENABLE_TASK_IAM_ROLE=true \
    --env=ECS_ENABLE_TASK_IAM_ROLE_NETWORK_HOST=true \
    amazon/amazon-ecs-agent:latest

在启用 awsvpc 网络模式的其他 Linux AMI 上

对于 AWS VPC 网络模式，ECS 代理需要 CNI 插件和 dhclient 可用。ECS 还需要 ecs-init 作为其启动的一部分运行。 以下是在启用 Task ENI 的情况下运行 ecs-agent 的 docker run 配置示例。请注意，ECS 代理目前仅支持 cgroupfs 作为 cgroup 驱动程序。

# 运行代理
/usr/bin/docker run --name ecs-agent \
--init \
--restart=on-failure:10 \
--volume=/var/run:/var/run \
--volume=/var/log/ecs/:/log:Z \
--volume=/var/lib/ecs/data:/data:Z \
--volume=/etc/ecs:/etc/ecs \
--volume=/sbin:/host/sbin \
--volume=/lib:/lib \
--volume=/lib64:/lib64 \
--volume=/usr/lib:/usr/lib \
--volume=/usr/lib64:/usr/lib64 \
--volume=/proc:/host/proc \
--volume=/sys/fs/cgroup:/sys/fs/cgroup \
--net=host \
--env-file=/etc/ecs/ecs.config \
--cap-add=sys_admin \
--cap-add=net_admin \
--env ECS_ENABLE_TASK_ENI=true \
--env ECS_UPDATES_ENABLED=true \
--env ECS_ENGINE_TASK_CLEANUP_WAIT_DURATION=1h \
--env ECS_DATADIR=/data \
--env ECS_ENABLE_TASK_IAM_ROLE=true \
--env ECS_ENABLE_TASK_IAM_ROLE_NETWORK_HOST=true \
--env ECS_LOGFILE=/log/ecs-agent.log \
--env ECS_AVAILABLE_LOGGING_DRIVERS='["json-file","awslogs","syslog","none"]' \
--env ECS_LOGLEVEL=info \
--detach \
amazon/amazon-ecs-agent:latest

另请参阅下面的高级用法部分。

在 ECS 优化的 Windows AMI 上

ECS 优化的 Windows AMI 附带预安装的 PowerShell 模块 ECSTools，用于安装、配置和运行 ECS 代理作为 Windows 服务。 要安装该服务，您可以在 EC2 实例上运行以下 PowerShell 命令。要启动到 windows 以外的其他集群，请将下面脚本中的 'windows' 替换为您的集群名称。

PS C:\> Import-Module ECSTools
PS C:\> # -EnableTaskIAMRole 选项是启用任务 IAM 角色所必需的。
PS C:\> Initialize-ECSAgent -Cluster 'windows' -EnableTaskIAMRole

下载不同版本的 ECS 代理

要下载不同版本的 ECS 代理，您可以执行以下操作：

PS C:\> # 使用 agentVersion = "latest" 获取最新可用的代理版本
PS C:\> $agentVersion = "v1.20.4"
PS C:\> Initialize-ECSAgent -Cluster 'windows' -EnableTaskIAMRole -Version $agentVersion

从源代码构建 ECS 代理

构建 ECS 代理镜像（Linux）

ECS 代理也可以在 Linux 机器上从源代码本地构建。使用以下步骤构建 ECS 代理

• 获取 ECS 代理源代码

git clone https://github.com/aws/amazon-ecs-agent.git

• 使用 release-agent make 目标构建代理镜像

make release-agent

这将安装所需的构建依赖项，构建 ECS 代理镜像并将其保存在路径 ecs-agent-v${AGENT_VERSION}.tar 中。使用以下命令加载它

docker load < ecs-agent-v${AGENT_VERSION}.tar

按照上面的说明继续安装

构建和运行独立版本（Linux）

Amazon ECS 容器代理也可以在 Docker 容器外作为 Go 二进制文件运行。目前，这在 Linux 上不推荐用于生产环境，但它对于开发或更易与本地 Go 工具集成可能很有用。

以下命令在 Docker 外运行代理：

make gobuild
./out/amazon-ecs-agent

独立版本（Windows）

可以通过调用 scripts\build_agent.ps1 来构建 Amazon ECS 容器代理

脚本（Windows）

以下脚本可用于在 Windows 上开发 Amazon ECS 容器代理：

• scripts\run-integ-tests.ps1 - 运行 engine 和 stats 包中的所有集成测试
• misc\windows-deploy\Install-ECSAgent.ps1 - 将 ECS 代理安装为 Windows 服务
• misc\windows-deploy\amazon-ecs-agent.ps1 - 帮助脚本，用于设置主机并将代理作为进程运行
• misc\windows-deploy\user-data.ps1 - 示例用户数据，可与带容器的 Windows Server 2016 AMI 一起使用，以将代理作为进程运行

构建 ECS-Init 包（Linux）

ECS-Init 包也可以根据您运行的 Linux 系统构建为 deb 或 rpm 包。按照 generic-deb-integrated 或 generic-rpm-integrated 中的说明构建并安装带有 Init 的 ECS 代理，使用 deb 或 rpm。

高级用法

Amazon ECS 容器代理支持多种配置选项，其中大多数应通过环境变量设置。

环境变量

下表提供了可用于配置 ECS 代理的可选环境变量概览。有关每个可用环境变量的更多详细信息，请参阅 Amazon ECS 开发者指南。

持久性

在生产环境中运行Amazon ECS容器代理时，其datadir应在Docker容器的多次运行之间保持持久。如果不保持这些数据的持久性，代理每次启动时都会注册一个新的容器实例ARN，并且无法更新之前运行的任务状态。

标志

代理还支持以下标志：

• -k — 代理将不要求与之通信的服务具有有效的SSL证书。我们不建议使用此标志。
• -loglevel — 选项：[<crit>|<error>|<warn>|<info>|<debug>]。代理将在给定级别输出到stdout。如果存在ECS_LOGLEVEL环境变量，则会覆盖此设置。

Make目标（在Linux上）

以下目标可用。每个目标可以通过make <target>运行。

贡献

欢迎贡献和反馈！我们将考虑并回应提案和拉取请求。有关更多信息，请参阅CONTRIBUTING.md文件。

如果您发现ECS代理行为存在bug/问题，请在此处提出。

如果您有功能请求，请在AWS Containers路线图上提出。

Amazon Web Services目前不为此软件的修改版本提供支持。

安全披露

如果您认为发现了潜在的安全问题，请不要在Issues中发布。相反，请按照此处的说明操作或直接发送电子邮件至AWS安全团队。

许可证

Amazon ECS容器代理根据Apache 2.0许可证授权。