Docker更改镜像仓库名称或重命名镜像的方法

技术背景

在使用Docker时，有时需要更改镜像的仓库名称或对镜像进行重命名。例如，将镜像从一个私有仓库迁移到另一个私有仓库，或者在开发过程中为镜像赋予更具描述性的名称。Docker本身没有直接的重命名命令，但可以通过标签（tag）操作来实现类似的效果。

实现步骤

单个镜像重命名

可以使用docker image tag命令为镜像添加新的标签，从而实现重命名的效果。以下是具体步骤：

查看当前镜像：使用docker images命令查看当前所有镜像，找到需要重命名的镜像。
1
docker images
添加新标签：使用docker image tag命令为镜像添加新的标签。可以使用镜像的仓库名称和标签，也可以使用镜像ID。
- 使用仓库名称和标签：
  1
  docker image tag server:latest myname/server:latest
- 使用镜像ID：
  1
  docker image tag d583c3ac45fd myname/server:latest
删除旧标签（可选）：如果不再需要旧的标签，可以使用docker rmi命令删除它。
1
docker rmi server

批量重命名

如果需要批量重命名具有相同仓库名称的多个镜像，可以使用以下脚本：

OLD_REPONAME='old_name'
NEW_REPONAME='new_name'
TAG='latest'

# extract image name, e.g. "old_name/image_name_1"
for image in $(docker images | awk '{ if( FNR>1 ) { print $1 } }' | grep $OLD_REPONAME)
do \
  OLD_NAME="${image}:${TAG}" && \
  NEW_NAME="${NEW_REPONAME}${image:${#OLD_REPONAME}:${#image}}:${TAG}" && \
  docker image tag $OLD_NAME $NEW_NAME && \
  docker rmi $image:${TAG}  # omit this line if you want to keep the old image
done

跨仓库迁移并重命名

如果需要将镜像从一个仓库迁移到另一个仓库并重命名，可以按照以下步骤操作：

拉取镜像：从旧仓库拉取镜像。

1	`docker pull docker.mycompany.com/something/redis:4.0.10`

添加新标签：为镜像添加新的标签，指定新的仓库名称。

1	`docker tag docker.mycompany.com/something/redis:4.0.10 docker.artifactory.mycompany.com/something/redis:4.0.10`

推送镜像：将带有新标签的镜像推送到新仓库。

1	`docker push docker.artifactory.mycompany.com/something/redis:4.0.10`

核心代码

单个镜像重命名

1 2	`docker image tag server:latest myname/server:latest docker rmi server`

批量重命名

OLD_REPONAME='old_name'
NEW_REPONAME='new_name'
TAG='latest'

for image in $(docker images | awk '{ if( FNR>1 ) { print $1 } }' | grep $OLD_REPONAME)
do \
  OLD_NAME="${image}:${TAG}" && \
  NEW_NAME="${NEW_REPONAME}${image:${#OLD_REPONAME}:${#image}}:${TAG}" && \
  docker image tag $OLD_NAME $NEW_NAME && \
  docker rmi $image:${TAG}
done

跨仓库迁移并重命名

1
2
3

docker pull docker.mycompany.com/something/redis:4.0.10
docker tag docker.mycompany.com/something/redis:4.0.10 docker.artifactory.mycompany.com/something/redis:4.0.10
docker push docker.artifactory.mycompany.com/something/redis:4.0.10