Viewing and launching solutions

In this article, you learn how to view and launch solutions from Service Catalog.

Before you begin

  • To launch a solution using Service Catalog, you must meet the following requirements:

    • You must have the following Identity and Access Management (IAM) roles:

      • For the Google Cloud project where the solution has been shared with you:

        If you don't have either role for the Google Cloud project, contact your Organization Administrator to request access.

      • For the Google Cloud project where you want to launch the solution:

    • You must provide a service account in the Google Cloud project where you want to launch the solution, with the following Identity and Access Management (IAM) roles:

      • For the Google Cloud project where you want to create the solution:
        • Storage Admin (roles/storage.admin)
        • Logs Writer (roles/logging.logWriter)
        • Any additional IAM roles that your service account needs to run the solution, which are specific to the solution you're using. For a list of all additional IAM roles that your service account must have to deploy Terraform, contact the administrator who created the solution that you're using.
      • If your Terraform config is located in a different project:
        • Storage Object Viewer (roles/storage.objectViewer), for that project If you don't have these roles, contact the Project Owner OR someone who has the setIAMpolicy permission for the project to request access.
  • If you're deploying a solution using Cloud Deployment Manager, the Deployment Manager Editor (roles/deploymentmanager.editor) role for the project where you're deploying the solution.

    If you don't have this role, contact the Project Owner OR someone who has the setIAMpolicy permission for the project to request access.

  • If you're launching a Terraform configuration, you must enable the Cloud Build API.

View Service Catalog solutions

In Service Catalog, you see a union of solutions from all the catalogs you have access to in your Google Cloud hierarchy.

To view available solutions, go to the Google Cloud console Service Catalog page. Solutions that have been shared with you appear in the main panel.

To launch a reference link-based solution:

  1. Go to the Google Cloud console Service Catalog page.

    Go to the Service Catalog page

  2. Under TYPE, filter by Link and click a solution.

  3. Click Go to link.

    This takes you to a link outside of the Google domain where you can download a solution.

Launch a Deployment Manager (DM)-based solution

To launch a DM-based solution:

  1. Go to the Google Cloud console Service Catalog page.

    Go to the Service Catalog page

  2. Under TYPE, filter by DM Template and click a solution.

  3. Click Launch on Compute Engine.

  4. If prompted, enable the Deployment Manager API and the Service Catalog API.

    Enabling the APIs takes several minutes to complete, but you only need to do it once per Google Cloud project (not per solution).

  5. Complete the deployment form.

    You must enter the zone parameter manually by specifying the Compute Engine region and zone you prefer. Enter the region followed by a dash and then the zone (without spaces): region-zone. For example, us-central1-a where us-central1 is the region and a is the zone.

  6. Click Deploy.

The solution is deployed.

Launch a Terraform configuration

To launch a Terraform configuration:

  1. Go to the Google Cloud console Service Catalog page.

    Go to the Service Catalog page

  2. Under TYPE, filter by Terraform and click a solution.

  3. Click Deploy.

  4. If prompted, in the window that appears, click Start a new deployment.

  5. If prompted, enable the Cloud Build API.

    Enabling the APIs takes several minutes to complete, but you only need to do it once per Google Cloud project (not per solution).

  6. Create a name for your deployment.

  7. Provide a service account from the same Google Cloud project as the solution, with any required IAM roles.

  8. Fill in the parameters.

  9. Click Preview and deploy.

  10. Review the deployment and click Deploy.

The solution is deployed.

Update a Terraform deployment

For an existing deployment of a Terraform solution, you can update deployment details, including parameters. If there is a new version of the Terraform configuration available for the solution, you can update your deployment to the latest version of the configuration.

To update an existing deployment:

  1. Go to the Deployments page in Service Catalog.

    Go to the Deployments page

  2. In the table of deployments, click the name of the deployment that you want to update.

  3. On the Deployment Details page, click Update deployment.

  4. Update the deployment details.

  5. Provide a service account from the same Google Cloud project as the solution, with any required IAM roles.

  6. Click Preview and deploy.

  7. Review the deployment and click Deploy.

View and apply the latest version of a configuration

When you manage your Terraform deployments, you can view if the associated solution has released a newer version of the Terraform configuration and update the deployment to the latest configuration.

To view if a deployment has available updates and apply the latest version of the configuration:

  1. Go to the Deployments page in Service Catalog.

    Go to the Deployments page

  2. Click View deployments with updates to filter the table of deployments. In the table, find the deployment that you want to update and click New Version Available.

  3. On the Deployment Details page, click Update deployment.

  4. Under Select version, select Update to the latest version.

  5. Provide a service account with the required permissions for your Google Cloud project.

  6. If prompted, enter values for any additional parameters.

  7. Provide a service account from the same Google Cloud project as the solution, with any required IAM roles.

  8. Click Preview and deploy.

  9. Review the deployment and click Deploy.

Deprovision a Terraform deployment

You deprovision a Terraform deployment to permanently delete all of its resources.

To deprovision a deployment:

  1. Go to the Google Cloud console Service Catalog page.

    Go to the Service Catalog page

  2. Click Terraform deployments.

  3. In the table, find the deployment you want to deprovision.

  4. Provide a service account from the same Google Cloud project as the solution, with any required IAM roles.

  5. Click the more actions menu (displayed as three dots arranged vertically) , and then click Deprovision.

The deployment is deprovisioned.