Containers - Use Google Artifact Registry images with Containers

<p>Containers now support <a href="https://cloud.google.com/artifact-registry" target="_blank" rel="noopener">Google Artifact Registry<span class="external-link"> ↗︎</span></a> images. After you configure credentials, you can use a fully qualified Google Artifact Registry image reference in your <a href="https://developers.cloudflare.com/workers/wrangler/configuration/#containers">Wrangler configuration</a> instead of first pushing the image to Cloudflare Registry.</p> <p>Provide the service account email with <code>--gar-email</code> and pipe the service account JSON key through <code>stdin</code>:</p> <figure class="nb-code-figure" data-nb-lang="bash"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="bash" data-nb-lang="bash"><code><span class="line"><span class="nb-shiki-1t8gfj">cat</span><span class="nb-shiki-1itgoe"> &lt;</span><span class="nb-shiki-mdbnqw">PATH_TO_KE</span><span class="nb-shiki-140thh">Y</span><span class="nb-shiki-1itgoe">&gt;</span><span class="nb-shiki-1itgoe"> |</span><span class="nb-shiki-1t8gfj"> npx</span><span class="nb-shiki-mdbnqw"> wrangler</span><span class="nb-shiki-mdbnqw"> containers</span><span class="nb-shiki-mdbnqw"> registries</span><span class="nb-shiki-mdbnqw"> configure</span><span class="nb-shiki-1itgoe"> &lt;</span><span class="nb-shiki-mdbnqw">REGIO</span><span class="nb-shiki-140thh">N</span><span class="nb-shiki-1itgoe">&gt;</span><span class="nb-shiki-mdbnqw">-docker.pkg.dev</span><span class="nb-shiki-dzsirb"> --gar-email=</span><span class="nb-shiki-1itgoe">&lt;</span><span class="nb-shiki-dzsirb">SERVICE_ACCOUNT_EMAIL</span><span class="nb-shiki-1itgoe">&gt;</span><span class="nb-shiki-dzsirb"> --secret-name=</span><span class="nb-shiki-1itgoe">&lt;</span><span class="nb-shiki-dzsirb">SECRET_NAME</span><span class="nb-shiki-1itgoe">&gt;</span></span></code></pre></figure> <div data-nb-tabs data-nb-sync-key="wranglerConfig" class><div class="relative flex border-b border-border" role="tablist" data-nb-tabs-list><span class="bg-primary pointer-events-none absolute -bottom-px h-0.5 rounded-t-sm transition-[left,width] duration-200 ease-out" data-nb-tabs-indicator aria-hidden="true"></span></div><div class="mt-3"><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="wrangler.jsonc" class><figure class="nb-code-figure" data-nb-lang="jsonc"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="jsonc" data-nb-lang="jsonc"><code><span class="line"><span class="nb-shiki-140thh">{</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "$schema"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"./node_modules/wrangler/config-schema.json"</span><span class="nb-shiki-140thh">,</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "containers"</span><span class="nb-shiki-140thh">: [</span></span> <span class="line"><span class="nb-shiki-140thh"> {</span></span> <span class="line"><span class="nb-shiki-dzsirb"> "image"</span><span class="nb-shiki-140thh">: </span><span class="nb-shiki-mdbnqw">"&#x3C;REGION>-docker.pkg.dev/&#x3C;PROJECT_ID>/&#x3C;REPOSITORY>/&#x3C;IMAGE>:&#x3C;TAG>"</span></span> <span class="line"><span class="nb-shiki-140thh"> }</span></span> <span class="line"><span class="nb-shiki-140thh"> ]</span></span> <span class="line"><span class="nb-shiki-140thh">}</span></span></code></pre></figure></div><div role="tabpanel" data-nb-tabs-content data-nb-tab-label="wrangler.toml" class><figure class="nb-code-figure" data-nb-lang="toml"><pre class="astro-code astro-code-themes github-light github-dark nb-shiki-c6xiwz" tabindex="0" data-language="toml" data-nb-lang="toml"><code><span class="line"><span class="nb-shiki-21nrsd"># Example: us-central1-docker.pkg.dev/my-project/my-repo/my-image:latest</span></span> <span class="line"><span class="nb-shiki-140thh">[[</span><span class="nb-shiki-1t8gfj">containers</span><span class="nb-shiki-140thh">]]</span></span> <span class="line"><span class="nb-shiki-140thh">image = </span><span class="nb-shiki-mdbnqw">"&#x3C;REGION>-docker.pkg.dev/&#x3C;PROJECT_ID>/&#x3C;REPOSITORY>/&#x3C;IMAGE>:&#x3C;TAG>"</span></span></code></pre></figure></div></div></div><script type="module" src="https://developers.cloudflare.com/home/runner/work/cloudflare-docs/cloudflare-docs/src/components/ui/tabs/Tabs.astro?astro&type=script&index=0&lang.ts"></script> <p>Only <code>*-docker.pkg.dev</code> hosts are supported. To configure credentials, refer to <a href="https://developers.cloudflare.com/containers/guides/image-management/#use-private-google-artifact-registry-images">Use private Google Artifact Registry images</a>.</p> <p>For more information, refer to <a href="https://developers.cloudflare.com/containers/guides/image-management/">Image management</a>.</p>