Skip to content
Cloudflare Docs
非官方翻译 - 此文档为非官方中文翻译版本，仅供参考。如有疑问请以 英文官方文档 为准。

镜像管理

在 wrangler deploy 期间推送镜像

运行 wrangler deploy 时，如果您在 Wrangler 配置 文件中将 image 属性设置为路径，wrangler 将使用 Docker 在本地构建您的容器镜像，然后将其推送到由 Cloudflare 运行的注册表。 此注册表与您的 Cloudflare 账户集成，并由 R2 支持。推送和拉取镜像时，所有身份验证都由 Cloudflare 自动处理。

只需提供 Dockerfile 的路径：

{
  "containers": {
    "image": "./Dockerfile"
    // ...rest of config...
  }
}

然后使用 wrangler deploy 部署您的 Worker。无需其他镜像管理。

在后续部署中，Wrangler 只会推送已更改的镜像层，这节省了初始部署后 wrangler deploy 调用的空间和时间。

使用预构建的容器镜像

如果您希望使用预构建的镜像，首先，将其推送到 Cloudflare 注册表：

Wrangler 提供了一个命令来将镜像推送到 Cloudflare 注册表：

Terminal window
npx wrangler push <image>:<tag>

此外，您可以将 -p 标志与 wrangler containers build 一起使用，在一个步骤中构建和推送镜像：

Terminal window
npx wrangler containers build -p -t <tag> .

然后您可以在 image 属性中指定 URL：

{
  "containers": {
    "image": "registry.cloudflare.com/your-namespace/your-image:tag"
    // ...rest of config...
  }
}

目前，所有镜像都必须使用 registry.cloudflare.com，这是 Wrangler 的默认注册表。

要使用来自其他仓库的现有镜像，您可以拉取它，标记它，然后将其推送到 Cloudflare 注册表：

Terminal window
docker pull <public-image>
docker tag <public-image> <image>:<tag>
wrangler containers push <image>:<tag>

使用 CI 推送镜像

要使用在持续集成环境中构建的镜像，请安装 wrangler，然后 使用带有 --push 标志的 wrangler containers build 或 使用 wrangler containers push 命令构建和推送镜像。

注册表限制

镜像大小限制为 2 GB，您在账户注册表中总共限制为 50 GB。

使用 wrangler containers delete 删除镜像以释放空间，但请注意，将 Worker 恢复到使用已删除镜像的先前版本将会出错。