Containers

使用 Wrangler 与 Containers 交互。

从 Dockerfile 构建 Container 镜像。

wrangler containers build [PATH] [OPTIONS]

• PATH stringoptional
  • 包含要构建的 Dockerfile 的目录路径。
• -t, --tag stringrequired
  • 名称，可选标签（格式："name:tag"）。
• --path-to-docker stringoptional
  • 如果 docker 二进制文件不在 $PATH 中，请指定其路径。
  • 默认值："docker"
• -p, --push booleanoptional
  • 将构建的镜像推送到 Cloudflare 托管的 registry。
  • 默认值：false

删除 Container（应用程序）。

wrangler containers delete <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID stringrequired
  • 要删除的 Container 的 ID。

对 containers registry 中的镜像执行操作。

列出 containers registry 中的镜像。

wrangler containers images list [OPTIONS]

• --filter stringoptional
  • 用于筛选结果的正则表达式。
• --json booleanoptional
  • 以干净的 JSON 格式返回输出。
  • 默认值：false

从 containers registry 中移除镜像。

wrangler containers images delete [IMAGE] [OPTIONS]

• IMAGE stringrequired
  • 要删除的镜像，格式为 IMAGE:TAG

配置并查看 container 可用的 registry。 了解更多关于我们当前支持的外部 registry。

列出 containers 可使用的 registry。

wrangler containers registries list [OPTIONS]

• --json booleanoptional
  • 以干净的 JSON 格式返回输出。
  • 默认值：false

为你的账户配置新的 registry。

wrangler containers registries configure [DOMAIN] [OPTIONS]

• DOMAIN stringrequired
  • 要为 registry 配置的域名。
• --dockerhub-username stringoptional
  • 用于身份验证的 Docker Hub 用户名。与 docker.io 域名一起使用。密钥为 Docker Hub 个人访问令牌。
• --aws-access-key-id stringoptional
  • 用于身份验证的 AWS 访问密钥 ID。与 Amazon ECR 域名一起使用。密钥为匹配的 AWS 秘密访问密钥。
• --gar-email stringoptional
  • 用于身份验证的 Google 服务账户电子邮件。与 *-docker.pkg.dev 域名一起使用。
• --secret-store-id stringoptional
  • 用于存储 registry 凭据的 secret store 的 ID
• --secret-name stringoptional
  • Wrangler 应存储 registry 凭据的名称

凭据标志互斥。请使用与你要配置的 registry 匹配的标志。

在交互模式下运行时，wrangler 会提示你输入密钥并将其存储在 Secrets Store 中。 要以非交互方式运行，你可以通过 stdin 将密钥值发送给 wrangler，以便为你创建密钥。

从账户中移除 registry 配置。

wrangler containers registries delete [DOMAIN] [OPTIONS]

• DOMAIN stringrequired
  • 要删除的 registry 的域名

生成临时凭据，用于从 Cloudflare 托管的 registry（registry.cloudflare.com）推送或拉取镜像。

wrangler containers registries credentials [OPTIONS]

• --push booleanoptional
  • 生成具有推送权限的凭据。
• --pull booleanoptional
  • 生成具有拉取权限的凭据。
• --expiration-minutes numberoptional
  • 凭据的有效期（分钟）。
  • 默认值：15

必须指定 --push 或 --pull 中的至少一个。

获取特定 Container 的信息，包括顶层详情和实例列表。

wrangler containers info <CONTAINER_ID> [OPTIONS]

• CONTAINER_ID stringrequired
  • 要获取信息的 Container 的 ID。

列出给定应用程序的所有 Container 实例。显示实例 ID、名称、状态、位置、版本和创建时间。

在交互模式下，结果会分页显示。按 Enter 加载下一页，或按 Esc/q 停止。在非交互式环境（例如，管道输出或在 CI 中运行时），会自动获取所有页面。

使用 --json 标志以扁平 JSON 数组形式返回输出。每个元素包含 id、name、state、location、version 和 created 字段。这也是非交互式环境中的默认输出格式。

wrangler containers instances <APPLICATION_ID> [OPTIONS]

• APPLICATION_ID stringrequired
  • 要列出实例的应用程序的 UUID。使用 wrangler containers list 查找应用程序 ID。
• --per-page numberoptional
  • 每页实例数。
  • 默认值：25
• --json booleanoptional
  • 以干净的 JSON 格式返回输出。
  • 默认值：false

例如，列出某个应用程序的实例：

wrangler containers instances 12345678-abcd-1234-abcd-123456789abc

INSTANCE                              NAME        STATE          LOCATION  VERSION  CREATED
a1b2c3d4-e5f6-7890-abcd-ef1234567890  worker-12   running        sfo06     3        2025-06-01T12:00:00Z
b2c3d4e5-f6a7-8901-bcde-f12345678901  worker-47   provisioning   iad01     2        2025-06-01T13:00:00Z

以 JSON 格式获取相同数据：

wrangler containers instances 12345678-abcd-1234-abcd-123456789abc --json

[
	{
		"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
		"name": "worker-12",
		"state": "running",
		"location": "sfo06",
		"version": 3,
		"created": "2025-06-01T12:00:00Z"
	}
]

列出账户中的 Containers。

wrangler containers list [OPTIONS]

将带标签的镜像推送到 Cloudflare 托管的 registry，该 registry 会自动与你的账户集成。

wrangler containers push [TAG] [OPTIONS]

• TAG stringrequired
  • 要推送的 container 镜像的名称和标签。
• --path-to-docker stringoptional
  • 如果 docker 二进制文件不在 $PATH 中，请指定其路径。
  • 默认值："docker"

使用 SSH 连接到正在运行的 Container 实例。有关配置详情，请参阅 SSH。

wrangler containers ssh <INSTANCE_ID>

你也可以指定要运行的命令，而不是默认 shell。例如：

wrangler containers ssh <INSTANCE_ID> -- ls -al

• INSTANCE_ID stringrequired
  • 要 SSH 连接的 Container 实例的 ID。