Submit your app

This page covers the process for submitting your product for testing and review.

Before you begin

Upload your images

Refer to the verification guidelines in the Cloud Marketplace tools GitHub repository to ensure that your container images pass the automated tests for all apps on Cloud Marketplace.

After your container images pass the verification tests, make sure that all the images for a version are tagged with the release track and version numbers, according to the guidelines for organizing your releases.

Finally, build your images and push them to your Container Registry repository, which you created when you set up your environment.

Note: If you are developing using a continuous integration (CI) pipeline, upload the images as the final step, after all tests have passed.

You can then add your release to your Cloud Marketplace listing in Producer Portal.

Before you publish your release for customers, you can preview the release in Cloud Marketplace and update its images. The Cloud Marketplace team also tests and approves your version before it is published to customers.

Add your product in Producer Portal

Before publishing your product, you must submit all of its components for review. You can submit the following reviews in any order to the Cloud Marketplace team:

  • Product details
  • Pricing
  • Container images

Some reviews might take up to two weeks for approval, so we recommend that you review the requirements and get started as early as possible.

Add your product details

The product details include your product listing on Cloud Marketplace, marketing information, and links to documentation.

To add your product details:

  1. Open Producer Portal in the Google Cloud console:

    Replace YOUR_PUBLIC_PROJECT_ID with the ID for the public project that you created for Cloud Marketplace—for example, my-organization-public.

  2. In the list of products, click the product ID that you created.

  3. On the Overview page of your product, go to the Product details, and click Edit.

  4. Complete the Product info tab of the Product details section. While completing Product info, you can add Category IDs. Category IDs allow customers to find your product under select categories or filters as they search Cloud Marketplace. You can select up to two Category IDs for a product.

  5. To add tutorials, documentation, and, optionally, additional license agreements, complete the Documentation tab of the Product details section. Your documentation must meet the requirements for user guides.

  6. To add search metadata or keywords, or to customize the URL of the details page for your product, complete the Product metadata tab of the Product details section.

  7. When you are ready to submit your product details for processing, click Submit. It takes approximately 2-5 days for the Partner Engineering team to review and approve your product details. You can start editing details now and submit the review later.

Add your container images

Each release corresponds to a minor version of your software and to an image tag in your Container Registry staging repository.

To add your container images:

  1. In the list of products, click the product ID that you created.

  2. On the Overview page of your product, go to the Container images section.

  3. In the Container images section, enter the URL for your Container Registry repository.

  4. Click Specify Release. It might take a few seconds to read the repository and load your tags.

  5. In Display tag, select the release you want to include in your Kubernetes app.

  6. Add a short description of the release.

  7. In the Public Git repo box, enter the URL for the Git repository that you created when you created your app package.

  8. In the Deploy documentation URL box, enter a link to the documentation that describes the steps to deploy the app from a command line interface (CLI). For example, the documentation might be the readme in your Git repository.

  9. Click Done when you've added all the information for that release.

  10. To add more releases, click Add Release, and enter the information for that release.

  11. In Select default releases, select the release your customers see on the product details page.

  12. When you're done adding supported releases to your product, click Save and Validate. The images are copied into a public repository, and then we run a series of tests against the images.

  13. Click Submit to submit the container images for review.

Preview your Kubernetes app

You can preview your Cloud Marketplace listing before it's visible to users, by clicking Full Preview. After your container image verification tasks have completed successfully, this preview option also allows you to test deploying your product.

Publish your Kubernetes app

To publish your product on Cloud Marketplace, you must:

After all reviews have been approved, you can publish and launch the product within a few minutes. To publish your product:

  1. Go to your product's Overview page in Producer Portal.

  2. Click Publish.