亚马逊云服务(AWS)的通用命令行界面,用于与AWS服务交互和管理AWS资源的Docker镜像,仅支持AWS CLI v2。
亚马逊云服务命令行界面(AWS CLI)
这是https://aws.amazon.com/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可执行文件,因为镜像的https://docs.docker.com/engine/reference/builder/#entrypoint已定义为`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的一般使用信息,请参考:
-
https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html
-
https://docs.aws.amazon.com/cli/latest/reference/
源代码
AWS CLI的源代码位于其https://github.com/aws/aws-cli/tree/v2。Docker镜像是使用AWS CLI v2的https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2-linux.html和以下https://github.com/aws/aws-cli/tree/v2/docker/Dockerfile构建的。
反馈
要提交与此Docker镜像相关的功能请求或报告问题,请在AWS CLI的https://github.com/aws/aws-cli上打开issue。
amazon 命名空间的其他可用镜像:
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
DockerHub 原生拉取命令
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务