亚马逊云服务命令行界面（AWS CLI）

这是AWS CLI的Docker镜像。它是一个统一的命令行工具，用于与AWS服务交互并管理您的AWS资源。

注意： 此镜像仅支持AWS CLI v2

标签

支持两组标签：

• latest - 对应AWS CLI的最新发布版本。依赖latest标签不提供向后兼容性保证。有关更多信息，请参见关于Docker镜像接口和向后兼容性的说明。

• <major.minor.patch> - 对应AWS CLI的每个发布版本。例如，要使用AWS CLI的2.0.6版本，请使用标签2.0.6。这些标签是不可变的，因为它们仅在特定版本的AWS CLI发布时推送一次。

Docker CLI使用方法

可以使用docker run命令从Docker CLI执行AWS CLI：

bash
$ docker run --rm -it amazon/aws-cli --version

此命令将打印容器中使用的AWS CLI版本。注意，docker run命令中未指定aws可执行文件，因为镜像的入口点已定义为aws可执行文件。

对于任何AWS CLI命令，您可以运行其help命令以获取该命令的帮助信息：

bash
$ docker run --rm -it amazon/aws-cli help

要运行进行AWS API调用的命令，可能需要将凭据和配置从主机系统共享到容器。假设凭据和配置在主机系统的~/.aws/credentials和~/.aws/config文件中设置，可通过将~/.aws目录挂载到容器的/root/.aws目录来共享它们：

bash
$ docker run --rm -ti -v ~/.aws:/root/.aws amazon/aws-cli s3 ls

对于某些AWS CLI v2命令，您可能需要从容器中读取主机系统的文件或将容器中的文件写入主机系统。这可以通过挂载到容器的/aws目录实现：

bash
$ docker run --rm -ti -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli s3 cp s3://aws-cli-docker-demo/hello .

/aws目录是镜像的工作目录，专为用户保留。有关更多信息，请参见关于接口的说明。

为缩短docker命令的长度，您可以添加以下别名：

bash
$ alias aws='docker run --rm -ti -v ~/.aws:/root/.aws -v $(pwd):/aws amazon/aws-cli'

这使您可以像在主机系统上安装了AWS CLI v2一样，从Docker容器中运行它：

bash
$ aws --version

关于Docker镜像接口和向后兼容性的说明

• 镜像上仅支持AWS CLI工具。应仅直接执行aws可执行文件。例如，即使less和groff已明确安装在镜像上，也不应在AWS CLI命令之外直接执行它们。

• /aws工作目录由用户控制。除非用户在运行AWS CLI命令时指示，否则镜像不会写入此目录。

• 依赖latest标签不提供向后兼容性保证。例如，理论上，latest标签的更新之间可能发生以下任何变化：

  • 特定工具（如less或groff）从镜像中移除。

  • 基础镜像更新（如从Amazon Linux更改为Alpine Linux）

  • AWS CLI的新版本发布（如AWS CLI v3）

• 为保证向后兼容性，用户必须固定到特定的<major.minor.patch>标签，因为这些标签是不可变的；它们仅在特定版本的AWS CLI发布时推送一次。

通用AWS CLI使用

有关AWS CLI的一般使用信息，请参考：

• AWS CLI用户指南

• AWS CLI参考指南

源代码

AWS CLI的源代码位于其GitHub仓库。Docker镜像是使用AWS CLI v2的Linux可执行安装程序和以下Dockerfile构建的。

反馈

要提交与此Docker镜像相关的功能请求或报告问题，请在AWS CLI的GitHub仓库上打开issue。