Google Cloud: Container Registry will be replaced by Artifact Registry
Spoiler Alert: (you've got some time)
Container Registry will be replaced by Artifact Registry. Please upgrade your projects to Artifact Registry before March 18, 2025.
On March 18, 2025, Container Registry will be replaced by Artifact Registry. We understand this change may affect your production workloads, so we've put together resources to make this transition as smooth as possible for you.
What do you need to
know?
To retain access to your container
images, please take note of these critical dates and actions you need to take
related to the Container Registry shutdown:
- March 18, 2025: You will no longer be able to push new images
to Container Registry.
- April 22, 2025: You will lose access to existing images in
Container Registry. To maintain access, you must copy them to the Artifact
Registry before this date.
- May 22, 2025: All requests to the gcr.io domain will be
handled exclusively by Artifact Registry. Ensure the Artifact Registry API
is enabled.
Can you keep using Container
Registry until the shutdown date?
- For projects already using Container Registry:
Yes, you can continue using Container Registry for both pushing and pulling images until March 18, 2025. - For new projects starting after May 15, 2024:
No, new projects cannot use Container Registry. They must use Artifact Registry for hosting and managing container images. All gcr.io repositories will be hosted on Artifact Registry by default as per the notification sent on May 15, 2023.
What do you need to
do?
Upgrade to Artifact Registry, which
is the recommended service for container image storage and management on Google
Cloud, before
March 18, 2025. Follow the steps below to upgrade:
- Evaluate where Container Registry is used in
your organization:
- Identify projects within your organization
that use Container Registry and images that need to be moved to Artifact
Registry.
- Use this utility to
help identify usage.
- For images that you want to keep:
- Determine your preferred upgrade path to
Artifact Registry.
- Run our automated upgrade utility
with the appropriate flags for your preferred upgrade path.
- If you are transitioning to standard
repositories, complete the manual steps outlined in the
instructions.
- Confirm that your projects are working as
intended.
- Clean up your
Container Registry related storage buckets.
- For images that you no longer need:
- There is no need to copy these images to
Artifact Registry. We recommend that you clean up the storage buckets
that store these images after you have validated that your upgraded
projects are working as intended.
What else do you
need to do?
- If you use Container Registry transitively
through another Google Cloud service, such as Cloud Build, App Engine, or
Cloud Functions, upgrade to Artifact Registry
using repositories with gcr.io support to ensure that your
workflows continue to function.
- gcr.io domain support in Artifact Registry
will be supported throughout the lifetime of Artifact Registry.
You can find your affected projects
using our Container Registry usage finder.
We understand that these changes may
require some planning, but we are here to support you as you make the
transition. Please do not hesitate to reach out to our Google Cloud Support
team, if you have any questions or require assistance.