Offering container image products

This page is an overview of what you need to do to distribute and maintain a container image product on Cloud Marketplace.

Before you begin

• Review the open source compliance recommendations and restrictions.
• Create your Google Cloud project and grant the Project Editor role to [e-mail].
• Complete the Project Info form that the Cloud Marketplace team sends you. To fill out the form, you might need to request access to it.

After you send us the above information, we give you access to Producer Portal, which you use in the next step, technical integration.

Overview of technical integration

As a partner, you can use Producer Portal to create Google Cloud Marketplace products. You can enter product details, configure what images are shown, and preview how your listing appears in Cloud Marketplace.

Users pull container images from a Google-owned container registry repository, marketplace.gcr.io/YOUR-PARTNER-PUBLISHED-NAME/YOUR-PRODUCT-PUBLISHED-NAME. You provide Google product images via a staging repository (specified during product creation, with the prefix gcr.io). You specify which Container Registry tags you'd like to present in Cloud Marketplace. When your product is published, Google copies the specified images from your staging gcr.io repository to the official marketplace.gcr.io repository, from which users download your container images.

Note: Starting January 20, 2025, Google Cloud Marketplace is requiring that all new or updated deployments of container image products contain an annotation in their image manifest that identifies the service name of the product. For more information, see Migrate to annotating container images with their service name.

Requirements for container image products

Your product's container image must contain the following annotation in its image manifest:

com.googleapis.cloudmarketplace.product.service.name=services/SERVICE_NAME

Replace SERVICE_NAME with the name of your service. To find your service name, refer to the table of products on the Overview page in Producer Portal. For more information about annotations, see the Open Container Initiative's documentation of annotations on GitHub.

Best practices for container image products

We recommend the following best practices for all container image products:

• Create Getting Started documentation
• Add User Support documentation

Note: The Cloud Marketplace Partners documentation focuses on onboarding your product; you should be aware that you are expected to maintain fresh, up-to-date, and secure products after launch. For more detailed information, refer to your Google Cloud Marketplace Partner Agreement.

Reviewing and launching

After you submit your product, cloud-partner-eng will review your submission and work with you to resolve any issues before approving it. When the product is approved, it is launched within 15 minutes of approval.