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 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, and click Install. After a few minutes, your new service install is marked as Ready in the Management tab of the page.

   

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

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 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 GDC 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 Cloud Marketplace 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.