创建容器镜像以在 Amazon ECS 上使用
Amazon ECS 在任务定义中使用 Docker 镜像来启动容器。Docker 技术为您提供了在容器中构建、运行、测试和部署分布式应用程序的工具。
此处概述的步骤的目的是指导您创建第一个 Docker 镜像并将该映像推送到 Amazon ECR(容器注册表),以便在 Amazon ECS 任务定义中使用。此演练假定您已基本了解 Docker 是什么及其工作方式。有关 Docker 的更多信息,请参阅 Docker 是什么?
先决条件
在您开始之前,确保您满足以下先决条件。
-
确保您已完成 Amazon ECR 设置步骤。有关更多信息,请参阅《Amazon Elastic Container Registry 用户指南》中的 Moving an image through its lifecycle in Amazon ECR。
-
您的用户具有访问和使用 Amazon ECR 服务所需的 IAM 权限。有关更多信息,请参阅 Amazon ECR 托管策略。
-
您已安装 Docker。有关 Amazon Linux 2 的 Docker 安装步骤,请参阅 在 AL2023 上安装 Docker。对于所有其他操作系统,请参阅 Docker 桌面概述
中的 Docker 文档。 -
您已经安装并配置 AWS CLI。有关更多信息,请参阅《AWS Command Line Interface 用户指南》中的 Installing or updating to the latest version of the AWS CLI。
如果您没有或不需要本地开发环境,并且更喜欢使用 Amazon EC2 实例来使用 Docker,我们将提供以下步骤来使用 Amazon Linux 2 启动 Amazon EC2 实例并安装 Docker Engine 和 Docker CLI。
Docker 适用于许多不同的操作系统,包括大多数现代 Linux 分发版 (如 Ubuntu) 甚至 MacOS 和 Windows。有关如何在特定的操作系统上安装 Docker 的更多信息,请转到 Docker 安装指南
您无需本地开发系统即可使用 Docker。如果您已在使用 Amazon EC2,则可启动 Amazon Linux 2023 实例并安装 Docker 以开始使用。
如果您已安装 Docker,请跳到创建 Docker 映像。
使用 Amazon Linux 2023 AMI 在 Amazon EC2 实例上安装 Docker
-
使用最新版 Amazon Linux 2023 AMI 启动实例。有关更多信息,请参阅《Amazon EC2 用户指南》中的使用控制台中的启动实例向导来启动 EC2 实例。
-
连接到您的实例。有关更多信息,请参阅《Amazon EC2 用户指南》中的连接到您的 EC2 实例。
-
更新实例上已安装的程序包和程序包缓存。
sudo yum update -y
-
安装最新的 Docker Community Edition 程序包。
sudo yum install docker
-
启动 Docker 服务。
sudo service docker start
-
将
ec2-user
添加到docker
组,以便您能够执行 Docker 命令,而无需使用sudo
。sudo usermod -a -G docker ec2-user
-
退出,再重新登录以接受新的
docker
组权限。您可以关闭当前的 SSH 终端窗口并在新终端窗口中重新连接到实例,完成这一过程。您的新 SSH 会话将具有相应的docker
组权限。 -
验证
ec2-user
是否能在没有sudo
的情况下运行 Docker 命令。docker info
注意
在某些情况下,您可能需要重新启动实例,以便为
ec2-user
提供访问 Docker 进程守护程序的权限。如果您看到以下错误,请尝试重启您的实例:Cannot connect to the Docker daemon. Is the docker daemon running on this host?
创建 Docker 映像
Amazon ECS 任务定义使用 Docker 镜像启动群集中的容器实例上的容器。在本节中,您将创建简单 Web 应用程序的 Docker 镜像,并在本地系统或 Amazon EC2 实例上测试此映像,然后将此映像推送至 Amazon ECR 容器注册表,以便能够在 Amazon ECS 任务定义中使用它。
创建简单 Web 应用程序的 Docker 镜像
-
创建名为
Dockerfile
的文件。Dockerfile 是一个清单文件,描述了用于 Docker 镜像的基本镜像以及要安装的项目以及在此项目上运行的内容。有关 Dockerfile 的更多信息,请转到 Dockerfile 参考。 touch Dockerfile
-
编辑您刚刚创建的
Dockerfile
并添加以下内容。FROM public.ecr.aws/amazonlinux/amazonlinux:latest # Update installed packages and install Apache RUN yum update -y && \ yum install -y httpd # Write hello world message RUN echo 'Hello World!' > /var/www/html/index.html # Configure Apache RUN echo 'mkdir -p /var/run/httpd' >> /root/run_apache.sh && \ echo 'mkdir -p /var/lock/httpd' >> /root/run_apache.sh && \ echo '/usr/sbin/httpd -D FOREGROUND' >> /root/run_apache.sh && \ chmod 755 /root/run_apache.sh EXPOSE 80 CMD /root/run_apache.sh
此 Dockerfile 使用 Amazon ECR Public 上托管的 Amazon Linux 2 公有映像。
RUN
指令更新包缓存,安装一些适用于 Web 服务器的软件包,然后将“Hello World!” 内容写入 Web 服务器的文档根目录。EXPOSE
指令指的是容器的端口 80 为正在侦听的端口,CMD
指令启动 Web 服务器。 -
从您的 Dockerfile 生成 Docker 镜像。
注意
Docker 的某些版本可能需要在以下命令中使用 Dockerfile 完整路径,而不是所示的相对路径。
docker build -t hello-world .
-
列出容器映像。
docker images --filter reference=hello-world
输出:
REPOSITORY TAG IMAGE ID CREATED SIZE hello-world latest e9ffedc8c286 4 minutes ago 194MB
-
运行新构建的镜像。
-p 80:80
选项将容器上公开的端口 80 映射到主机系统上的端口 80。docker run -t -i -p 80:80 hello-world
注意
来自 Apache Web 服务器的输出将显示在终端窗口中。您可以忽略“
Could not reliably determine the fully qualified domain name
”消息。 -
打开浏览器并指向正在运行 Docker 并托管您的容器的服务器。
-
如果您使用的是 EC2 实例,这将是服务器的 Public DNS 值,此值与您用于通过 SSH 连接到实例的地址相同。确保实例的安全组允许端口 80 上的入站流量。
-
如果您正在本地运行 Docker,可将您的浏览器指向 http://localhost/
。 -
如果您正在 Windows 或 Mac 计算机上使用 docker-machine,请使用 docker-machine ip 命令查找托管 Docker 的 VirtualBox VM 的 IP 地址,并将
machine-name
替换为您正在使用的 Docker 计算机的名称。docker-machine ip
machine-name
您应看到一个显示“Hello World!”语句的 网页。
-
-
通过键入 Ctrl + c 来停止 Docker 容器。
将映像推送到 Amazon Elastic Container Registry
Amazon ECR 是一项托管 AWS Docker 注册表服务。您可以使用 Docker CLI 在 Amazon ECR 存储库中推送、拉取和托管映像。有关 Amazon ECR 产品详细信息、特色客户案例研究和常见问题解答,请参阅 Amazon Elastic Container Registry 产品详细信息页面
标记映像并将其推送至 Amazon ECR
-
创建用于存储您的
hello-world
映像的 Amazon ECR 存储库。在输出中记下repositoryUri
。将
region
替换为您的 AWS 区域,例如us-east-1
。aws ecr create-repository --repository-name
hello-repository
--regionregion
输出:
{ "repository": { "registryId": "
aws_account_id
", "repositoryName": "hello-repository", "repositoryArn": "arn:aws:ecr:region
:aws_account_id
:repository/hello-repository", "createdAt": 1505337806.0, "repositoryUri": "aws_account_id
.dkr.ecr.region
.amazonaws.com/hello-repository" } } -
使用上一步中的
repositoryUri
值标记hello-world
映像。docker tag hello-world
aws_account_id
.dkr.ecr.region
.amazonaws.com/hello-repository
-
运行 aws ecr get-login-password 命令。指定要对其进行身份验证的注册表 URI。有关更多信息,请参阅 Amazon Elastic Container Registry 用户指南中的注册表身份验证。
aws ecr get-login-password --region
region
| docker login --username AWS --password-stdinaws_account_id
.dkr.ecr.region
.amazonaws.com输出:
Login Succeeded
重要
如果收到错误,请安装或更新到最新版本的 AWS CLI。有关更多信息,请参阅《AWS Command Line Interface 用户指南》中的 Installing or updating to the latest version of the AWS CLI。
-
使用上一步中的
repositoryUri
值将映像推送至 Amazon ECR。docker push
aws_account_id
.dkr.ecr.region
.amazonaws.com/hello-repository
清理
要继续创建 Amazon ECS 任务定义并使用容器镜像启动任务,请跳至 后续步骤。完成试验 Amazon ECR 映像后,您可以删除存储库,从而无需为映像存储付费。
aws ecr delete-repository --repository-name
hello-repository
--regionregion
--force
后续步骤
您的任务定义需要任务执行角色。有关更多信息,请参阅 Amazon ECS 任务执行 IAM 角色。
在创建容器映像并将其推送到 Amazon ECR 后,您可以在任务定义中使用该映像。有关更多信息,请参阅以下章节之一: