google/docker-registry

docker-registry-driver-gcs

2015年2月更新说明

我们已推出Google Container Registry，建议使用它替代google/docker-registry。Google Container Registry是运行在Google Cloud Storage上的私有Docker registry，使用与google/docker-registry相同的身份验证、存储和计费方式，无需自行运行registry。可从Google Compute Engine、Managed VMs、Google Container Engine、非Google云提供商或本地机器轻松访问其中的镜像。

镜像概述和主要用途

该镜像为带有Google Cloud Storage (GCS)驱动的Docker Registry，用于将Docker镜像存储到Google Cloud Storage存储桶中。通过配置环境变量和凭证，可实现Docker镜像的推送和拉取操作。

核心功能和特性

• 支持将Docker镜像存储到Google Cloud Storage存储桶
• 可通过环境变量配置存储桶和存储路径
• 提供多种凭证配置方式（OAuth刷新令牌、.boto文件卷、GCE服务账户）
• 兼容标准Docker Registry的使用流程

使用场景和适用范围

适用于需要将Docker镜像存储在Google Cloud Storage中的场景，尤其适合已使用Google Cloud Platform的用户。注意：2015年2月后官方推荐使用Google Container Registry，本镜像为较旧解决方案。

详细使用方法和配置说明

前提条件

已安装Docker，且可访问https://index.docker.io/u/google/docker-registry%E9%95%9C%E5%83%8F%E3%80%82

指定存储桶

需通过环境变量指定用于存储镜像的GCS存储桶：

bash
docker run -d -e GCS_BUCKET=your-bucket -p 5000:5000 google/docker-registry

可选设置STORAGE_PATH环境变量指定存储桶内的路径（需以斜杠开头，不以斜杠结尾）：

bash
docker run -d -e GCS_BUCKET=your-bucket -e STORAGE_PATH=/containers -p 5000:5000 google/docker-registry

凭证配置

有三种方式配置访问GCS的凭证：

1. 使用环境变量中的OAuth刷新令牌

通过gcloud获取刷新令牌，然后通过环境变量传入：

bash
# 获取刷新令牌
gcloud auth print-refresh-token
# 创建环境变量文件 registry-params.env
cat registry-params.env
GCP_OAUTH2_REFRESH_TOKEN=your-refresh-token
GCS_BUCKET=your-bucket
# 运行容器
docker run -d --env-file=registry-params.env -p 5000:5000 google/docker-registry

2. 使用google/cloud-sdk容器的配置卷

通过google/cloud-sdk容器生成凭证并共享卷：

bash
# 创建gcloud配置容器并登录
docker run -ti --name gcloud-config google/cloud-sdk gcloud auth login
# 根据提示在浏览器中完成登录并输入验证码
# 设置项目
docker run -ti --volumes-from gcloud-config google/cloud-sdk gcloud config set project <project>
# 使用配置卷运行registry
docker run -d -e GCS_BUCKET=your-bucket -p 5000:5000 --volumes-from gcloud-config google/docker-registry

3. 在Google Compute Engine上使用服务账户

在GCE实例上配置具有storage-rw作用域的服务账户：

bash
# 创建GCE实例
gcutil addinstance --zone=us-central1-a --machine_type=f1-micro \
  --image=projects/google-containers/global/images/container-vm-v20140522 \
  --service_account_scopes=storage-rw \
  my-docker-vm
# 登录实例并运行registry
gcutil ssh my-docker-vm
sudo docker run -d -e GCS_BUCKET=your-bucket -p 5000:5000 google/docker-registry

使用Registry

配置完成后，可通过以下命令推送镜像：

bash
# 标记镜像
docker tag myawesomeimage localhost:5000/myawesomeimage
# 推送镜像
docker push localhost:5000/myawesomeimage