Life cycle of a marketplace deployment

This page explains how to install, upgrade, and uninstall Google Distributed Cloud (GDC) air-gapped Marketplace software packages using the GDC console.

You can also use the gdcloud marketplace CLI or the Marketplace API to achieve the same results.

Before you begin

To get the permissions you need to install, upgrade, and uninstall Distributed Cloud Marketplace software packages, ask your Security Admin to grant you the Marketplace Editor (marketplace-editor) role.

Install a Distributed Cloud marketplace software package

You discover, select, and install software packages from the Distributed Cloud Marketplace page of the GDC console.

To install a software package from the Distributed Cloud marketplace, complete the following steps:

1. Using the project selector at the top of the GDC console, select the project you want to install the software package in.
2. In the Distributed Cloud marketplace, visit the listing page for the product that you want to install. From this page, you can review details of the product and follow links to its documentation, pricing, and terms of services.
3. If it's the first time you are installing this product, click Install. Otherwise, go to the Management tab and click New Instance.
4. In the dialog, select which user cluster you want to install the software package in. If you want to customize its configuration, click Next. If you want to use the default configuration, click Install.
5. If you clicked Next, you can now examine the default configuration. Click Custom configuration to enter your own parameters, following the vendor's documentation. When finished, click Install to proceed with the installation. For Kubernetes software packages, the parameters that you configure here override the default values provided by the vendor in their Helm values file.

6. Wait a few minutes for your new instance to be marked as Ready in the Management tab of the page.

   

7. Consult the documentation of the relevant software vendor to learn how to use their solution once it's installed.

Reconfigure an instance of a Distributed Cloud marketplace software package

Warning: While you can reconfigure a running instance of a Distributed Cloud marketplace software package, the reconfiguration process is implemented by the vendor who published the product. The reconfiguration process therefore varies from one software package to another. We recommend you carefully review the documentation of the relevant vendor before proceeding with a reconfiguration. Depending on how the vendor implemented their reconfiguration process, you may encounter downtime in the service delivered.

Some Distributed Cloud marketplace software packages can be reconfigured when they are already running. For Kubernetes-based services, this is equivalent to applying new values to the vendor's Helm chart.

To reconfigure a running instance of a Distributed Cloud marketplace software package, work through the following steps:

1. Using the project selector at the top of the GDC console, select the project in which you want to upgrade the software package.
2. On the Distributed Cloud marketplace page, visit the listing page for the product you want to upgrade.
3. Click the Management tab.
4. Click Configuration file for the instance you want to reconfigure.
5. In the panel that opens, enter your custom parameters, following the vendor's documentation.
6. Click Save to apply the new parameters. The reconfiguration completes in a few minutes.

Upgrade a Distributed Cloud marketplace software package

Warning: While you can trigger the upgrade of a software package using the Distributed Cloud marketplace, the upgrade process is implemented by the vendor who published the product. The upgrade process therefore varies from one software package to another. We recommend you carefully review the release notes and upgrade documentation of the relevant vendor before proceeding with an upgrade. Depending on how the vendor implemented their upgrade process, you may encounter downtime in the service delivered, or compatibility issues between older and newer versions.

Some Distributed Cloud marketplace software packages can be upgraded to a new version through the Google Distributed Cloud marketplace after your Infrastructure Operator makes those new versions available to you.

To upgrade a Distributed Cloud marketplace software package, work through the following steps:

1. Using the project selector at the top of the GDC console, select the project in which you want to upgrade the software package.
2. On the Distributed Cloud marketplace page, visit the listing page for the product you want to upgrade.
3. Click the Management tab.
4. Click Upgrade on the instance you want to upgrade. The upgrade completes in a few minutes.

Note: Upgrading a software package through the Distributed Cloud console leads to the next available version of the software being installed. If there are multiple new versions of the software available, you need to repeat the process for each of them. If required, use the Marketplace API to upgrade to a specific version.

Uninstall a Distributed Cloudmarketplace software package

Warning: Uninstalling a Distributed Cloud marketplace software package is a destructive action, and may result in loss of data or downtime of systems dependent on this software. Ensure that you have backed up all important data and that no important system depends on the software you want to uninstall before proceeding. Consult the documentation of the relevant vendor to learn how to back up any data managed by their software.

To uninstall a Distributed Cloud marketplace software package, complete the following steps:

1. Using the project selector at the top of the GDC console, select the project you want to uninstall the software package from.
2. On the Distributed Cloud marketplace page, visit the listing page for the product you want to uninstall.
3. Click the Management tab.
4. Click Uninstall for the instance you want to uninstall. The software package is uninstalled in a few minutes.