Migrate to annotating container images with their service name
Stay organized with collections
Save and categorize content based on your preferences.
Starting January 20, 2025, Google Cloud Marketplace is requiring that all new or updated
deployments of Google Kubernetes Engine app product listings or container image products
contain an annotation in their image manifest that identifies the service name
of the product. This annotation has the following format:
Replace SERVICE_NAME with the name of your service.
An annotation is a key-value pair that's added to the image manifest. For more
information about annotations, see the Open Container Initiative's documentation
of
annotations
on GitHub.
Add the annotation to your container image manifest
To add the annotation to your container image manifest, use a tool like
Docker or
Crane.
For steps to add an annotation with Docker, see
Add annotations
in the Docker documentation.
For steps to add an annotation with Crane, see
crane mutate
in the Crane documentation.
To find your service name, refer to the table of products on the Overview page
in Producer Portal.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[],[],null,["# Migrate to annotating container images with their service name\n\nStarting January 20, 2025, Google Cloud Marketplace is requiring that all new or updated\ndeployments of Google Kubernetes Engine app product listings or container image products\ncontain an annotation in their image manifest that identifies the service name\nof the product. This annotation has the following format: \n\n com.googleapis.cloudmarketplace.product.service.name=services/\u003cvar translate=\"no\"\u003eSERVICE_NAME\u003c/var\u003e\n\nReplace \u003cvar translate=\"no\"\u003eSERVICE_NAME\u003c/var\u003e with the name of your service.\n\nAn annotation is a key-value pair that's added to the image manifest. For more\ninformation about annotations, see the Open Container Initiative's documentation\nof\n[annotations](https://github.com/opencontainers/image-spec/blob/main/annotations.md)\non GitHub.\n\nAdd the annotation to your container image manifest\n---------------------------------------------------\n\nTo add the annotation to your container image manifest, use a tool like\n[Docker](https://docs.docker.com/engine/reference/builder/) or\n[Crane](https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane.md).\n\n- For steps to add an annotation with Docker, see [Add annotations](https://docs.docker.com/build/metadata/annotations/#add-annotations) in the Docker documentation.\n- For steps to add an annotation with Crane, see [crane mutate](https://github.com/google/go-containerregistry/blob/main/cmd/crane/doc/crane_mutate.md) in the Crane documentation.\n\nTo find your service name, refer to the table of products on the **Overview** page\nin Producer Portal."]]
