OpenAICloudflare Developer PlatformJul 1, 2026, 12:00 AM

Containers - Use Google Artifact Registry images with Containers

A condensed section focused on the key takeaways first.

Original Post

OpenAI Claude

Quick Digest

Summary

A condensed section focused on the key takeaways first.

openaienmodel: gpt-5-mini-2025-08-07

Containers - Use Google Artifact Registry images with Containers

cloudflare containers google-artifact-registry wrangler registry images

Key Points

Use GAR images directly in Wrangler
Configure credentials by piping service account key
Only *-docker.pkg.dev hosts supported

Summary

Cloudflare Containers now supports using images hosted in Google Artifact Registry (GAR). After configuring credentials with Wrangler, you can reference a fully qualified GAR image (for example: us-central1-docker.pkg.dev/<PROJECT>/<REPO>/<IMAGE>:<TAG>) in your Wrangler config instead of first pushing the image to the Cloudflare Registry.

Key Points

Configure GAR credentials with Wrangler by piping the service account JSON key to stdin and providing the service account email and a secret name. Example: cat <PATH_TO_KEY> | npx wrangler containers registries configure <REGION>-docker.pkg.dev --gar-email=<SERVICE_ACCOUNT_EMAIL> --secret-name=<SECRET_NAME>
In your wrangler.jsonc or wrangler.toml, set the container image to the fully qualified GAR reference. JSONC example: { "containers": [ { "image": "<REGION>-docker.pkg.dev/<PROJECT_ID>/<REPOSITORY>/<IMAGE>:<TAG>" } ] } TOML example: [[containers]] image = "<REGION>-docker.pkg.dev/<PROJECT_ID>/<REPOSITORY>/<IMAGE>:<TAG>"
Only hosts that match *-docker.pkg.dev are supported for GAR images.
No need to push the image to Cloudflare Registry first; Wrangler will use the configured GAR credentials to pull images during deployment.
See the Cloudflare docs: "Use private Google Artifact Registry images" and "Image management" for full configuration and troubleshooting steps.

Full Translation

Translations

A translation section that keeps the flow of the original article.

openaijamodel: gpt-5-mini-2025-08-07

Containers — Google Artifact Registry イメージを Containers で使用する

Changelog Cloudflare の新機能と改善。RSS を購読 — View RSS feeds ← Back to all posts

Containers — Google Artifact Registry イメージを Containers で使用する

公開日: 2026-07-01

概要

Containers は Google Artifact Registry ↗ のイメージをサポートするようになりました。資格情報を設定すると、イメージを先に Cloudflare Registry にプッシュする代わりに、Wrangler の設定で完全修飾された Google Artifact Registry のイメージ参照を使用できます。

設定方法

サービスアカウントのメールアドレスを --gar-email で指定し、サービスアカウントの JSON キーを stdin 経由で渡します：

cat <PATH_TO_KEY> | npx wrangler containers registries configure <REGION>-docker.pkg.dev --gar-email=<SERVICE_ACCOUNT_EMAIL> --secret-name=<SECRET_NAME>

wrangler.jsonc / wrangler.toml の例を示します。

JSONC:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "containers": [
    {
      "image": "<REGION>-docker.pkg.dev/<PROJECT_ID>/<REPOSITORY>/<IMAGE>:<TAG>"
    }
  ]
}

TOML:

# Example: us-central1-docker.pkg.dev/my-project/my-repo/my-image:latest
[[containers]]
image = "<REGION>-docker.pkg.dev/<PROJECT_ID>/<REPOSITORY>/<IMAGE>:<TAG>"

制限事項

サポートされるホストは *-docker.pkg.dev のみです。
資格情報の設定については "Use private Google Artifact Registry images" を参照してください。
詳細は "Image management" を参照してください。