Configure your Terraform Kubernetes app's deployment
Stay organized with collections
Save and categorize content based on your preferences.
You offer Terraform Kubernetes apps through Google Cloud Marketplace as Helm charts,
which customers use to deploy your apps. After you've uploaded your app's Helm
chart to Artifact Registry, use Producer Portal to configure your app's
deployment and submit it for review.
Before you begin
Create a public Git repository for the configuration files, user guide, and
other resources to run your app. You can host the repository with a provider
such as GitHub, Cloud Source Repositories, or on your own server. We
recommend a dedicated repository for each product that you're
distributing.
Verify that you've
prepared your Terraform Kubernetes app
for Cloud Marketplace, including uploading your app's Helm chart to
Artifact Registry and Terraform module to Cloud Storage.
Configure your app's Helm chart and container images
Specify your app's Helm chart and container images in
Producer Portal.
You can offer multiple releases, or versions, of your app through
Cloud Marketplace, and let your users select between the available
releases. To specify your app's releases, complete the following steps:
In Producer Portal, in the Deployment configuration tab,
under Image release, click Specify releases.
Under New release, add the following information:
A display tag, which should match the tag of the corresponding Helm
chart that you uploaded to Artifact Registry.
A version title, which Cloud Marketplace shows to your users.
A short description, which explains how this release differs from other
available releases.
For Module, specify the Cloud Storage location of the corresponding
Terraform module for this release.
For each additional release that you want to add, click Add release and
then complete the previous steps.
For Default release, select which release should be the default release
for your app's Cloud Marketplace listing.
Click Save and validate.
After you click Save and validate, Cloud Marketplace automatically runs
validation tests on your releases. Under Proposed releases, you see a brief
description of the progress of the validation tests, including an estimate of
how long they might take to complete. Validation involves testing to ensure
that the provided Terraform module successfully runs terraform plan.
Your releases must pass validation before you can publish them to
Cloud Marketplace.
What's next
Publish your product to Cloud Marketplace.
To publish your product, you submit various parts of your product for
review. The Cloud Marketplace team reviews each submission and works
with you to resolve any issues before approving it. When all of your
submissions are approved, you can publish and launch the product within a
few minutes.
[[["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,["# Configure your Terraform Kubernetes app's deployment\n\nYou offer Terraform Kubernetes apps through Google Cloud Marketplace as Helm charts,\nwhich customers use to deploy your apps. After you've uploaded your app's Helm\nchart to Artifact Registry, use Producer Portal to configure your app's\ndeployment and submit it for review.\n| **Note:** If you have questions during the onboarding process, talk to your Cloud Marketplace Partner Engineer. If you don't know who your assigned Partner Engineer is, use the [Google Cloud Support Portal](https://g.co/cloud/psd-partner) to request assistance, and include the word \"Marketplace\" in your description. For more information about the Google Cloud Support Portal, visit [Request assistance with Cloud Marketplace](/marketplace/docs/partners/get-support).\n\nBefore you begin\n----------------\n\n- Create a public Git repository for the configuration files, user guide, and other resources to run your app. You can host the repository with a provider such as GitHub, Cloud Source Repositories, or on your own server. We recommend a dedicated repository for each product that you're distributing.\n- Verify that you've [prepared your Terraform Kubernetes app](/marketplace/docs/partners/kubernetes/set-up-environment) for Cloud Marketplace, including uploading your app's Helm chart to Artifact Registry and Terraform module to Cloud Storage.\n\nConfigure your app's Helm chart and container images\n----------------------------------------------------\n\nSpecify your app's Helm chart and container images in\nProducer Portal.\n\nFor steps to upload a Helm chart to Artifact Registry, see\n[Prepare your Terraform Kubernetes app](/marketplace/docs/partners/terraform-kubernetes/set-up-environment).\n\n### Specify your app's Helm chart\n\nTo specify your app's Helm chart, complete the following steps:\n\n1. In Artifact Registry, navigate to the Helm chart that you want to use.\n2. Click to copy your Helm chart's URL.\n3. In Producer Portal, in the **Deployment configuration** tab, for **Specify Helm chart**, paste your Helm chart's URL.\n\nThe format of your Helm chart's URL should be as follows: \n\n us-docker.pkg.dev/\u003cvar translate=\"no\"\u003ePROJECT_NAME\u003c/var\u003e/\u003cvar translate=\"no\"\u003ePRODUCT_NAME\u003c/var\u003e/\u003cvar translate=\"no\"\u003eCHART_NAME\u003c/var\u003e\n\n### Specify your app's releases\n\nYou can offer multiple *releases*, or versions, of your app through\nCloud Marketplace, and let your users select between the available\nreleases. To specify your app's releases, complete the following steps:\n\n1. In Producer Portal, in the **Deployment configuration** tab, under **Image release** , click **Specify releases**.\n2. Under **New release** , add the following information:\n - A *display tag*, which should match the tag of the corresponding Helm chart that you uploaded to Artifact Registry.\n - A *version title*, which Cloud Marketplace shows to your users.\n - A short *description*, which explains how this release differs from other available releases.\n3. For **Module**, specify the Cloud Storage location of the corresponding Terraform module for this release.\n4. For each additional release that you want to add, click **Add release** and then complete the previous steps.\n5. For **Default release**, select which release should be the default release for your app's Cloud Marketplace listing.\n6. Click **Save and validate**.\n\nAfter you click **Save and validate** , Cloud Marketplace automatically runs\nvalidation tests on your releases. Under **Proposed releases** , you see a brief\ndescription of the progress of the validation tests, including an estimate of\nhow long they might take to complete. Validation involves testing to ensure\nthat the provided Terraform module successfully runs `terraform plan`.\n\nYour releases must pass validation before you can publish them to\nCloud Marketplace.\n\nWhat's next\n-----------\n\n- [Publish your product to Cloud Marketplace](/marketplace/docs/partners/terraform-kubernetes/publish). To publish your product, you submit various parts of your product for review. The Cloud Marketplace team reviews each submission and works with you to resolve any issues before approving it. When all of your submissions are approved, you can publish and launch the product within a few minutes."]]