# 拉取容器镜像

通过 ecs pull 命令可以从 ECS Registry Server 拉取容器镜像，命令示例如下：

ecs pull AccountName/RepoName

# 鉴权拉取

若从 ECS Registry Server 拉取镜像时需要用户名和密码信息，则可以采用命令行或配置文件两种指定用户名和密码。

# 配置文件方式

参考如下示例，在 "/etc/ecs_registry" 文件中配置 ECS Registry Server 仓库的地址、用户名和密码。

[root@sylixos:/root]# vi /etc/ecs_registry
# from private registry server
registry=http://192.168.1.100:3000
username=AccountName
password=Password

其中 registry 应设为实际的服务器地址和端口号。下面以与 Docker Hub 进行通信为例，介绍其配置方法。

[root@sylixos:/root]# vi /etc/ecs_registry
# from docker hub
registry=https://registry-1.docker.io
username=AccountName
password=Password

如果想匿名访问，可以不设置 username 和 password。下面以与 ECSM 进行通信为例，介绍其配置方法。

[root@sylixos:/root]# vi /etc/ecs_registry
# from ECSM
registry=http://ecsm-registry-ip:port

# 命令行方式

可以参考如下方式在 ecs pull 命令中指定用户名和密码，并指定拉取后的存放位置。

ecs pull AccountName/RepoName [--user AccountName Password] [--output Path] 

参数及扩展项说明如下：

• AccountName/RepoName 为需下载的仓库名称，若为公共仓库，则直接为 RepoName。

该命令支持的扩展选项如下：

• --user 选项指定账号和密码：
  • AccountName 为有效的 Registry Server 账号；
  • Password 为该账号有效的登录密码。
• --output 选项指定拉取容器镜像的存储地址，可以通过 path 字段指定，如果不指定则默认拉取到当前路径。
  • Path 为有效目录名称，当目录不存在时会创建。

# 运行效果

拉取容器范例，可以看到如下程序输出：

[root@sylixos:/root]# ecs pull ecs_demo