使用Vercel CLI管理Vercel容器注册表
内容提要
Vercel CLI新增`vercel vcr`命令组，用于管理容器注册表。用户可连接Docker、Podman等工具，通过`vercel vcr login docker`认证，用`vercel vcr build docker --push`一步构建推送镜像，或使用标准`docker push`命令。仓库自动创建，也可用`vercel vcr add`显式添加，并支持列出、检查仓库、镜像和标签。更新至最新CLI即可使用。
延伸解读
认证与推送的便捷性
Vercel CLI 新增的 `vercel vcr` 命令组简化了容器镜像的推送流程。通过 `vercel vcr login docker` 进行认证后，开发者可以使用 `vercel vcr build docker --push` 一步完成构建和推送，无需手动配置 Docker 登录信息。这种集成方式降低了使用 Vercel 容器注册表的门槛，尤其适合习惯命令行操作的开发者。
与现有工具链的兼容性
该功能不仅支持 Docker，还兼容 Podman 和 Buildah 等容器工具。认证后，开发者可以使用标准的 `docker push` 命令推送镜像，这意味着现有的 CI/CD 流程和脚本无需大幅修改即可接入 Vercel 容器注册表。这种设计体现了对开发者现有工作流的尊重，减少了迁移成本。
仓库管理的自动化
Vercel 容器注册表支持仓库的自动创建，首次推送时无需手动创建仓库，简化了初始设置。同时，`vercel vcr add` 命令允许显式创建仓库，便于提前规划。此外，`vercel vcr ls` 和 `vercel vcr image ls` 等命令提供了对仓库、镜像和标签的查看功能，方便开发者管理容器资源。
Q&A
如何使用Vercel CLI登录容器注册表？
使用`vercel vcr login docker`命令可以认证Docker，该命令会生成一个短期令牌，并自动配置Docker客户端。
如何一步构建并推送镜像到Vercel容器注册表？
使用`vercel vcr build docker --push`命令，它会构建当前目录并推送镜像。也可以指定路径和标签，如`vercel vcr build docker ./app my-api:1.2.3 --push`。
能否使用标准docker push命令推送镜像到Vercel容器注册表？
可以。认证后，可以使用标准命令`docker push vcr.vercel.com/my-team/my-project/my-repository:latest`推送镜像。
如何显式创建仓库？
使用`vercel vcr add my-repository`命令可以显式创建仓库。
如何列出仓库和查看镜像？
使用`vercel vcr ls`列出所有仓库，使用`vercel vcr image ls my-repository`列出仓库中的镜像，加`--untagged`参数可只显示未标记的镜像。
如何检查镜像标签的详细信息？
使用`vercel vcr tag inspect my-repository latest`命令可以检查指定标签的详细信息。
如何更新Vercel CLI以使用vcr命令？
使用`pnpm i -g vercel@latest`命令更新到最新版Vercel CLI。
