Deploy a SaaS offering

This page describes how to deploy a SaaS offering, which means that SaaS Runtime provisions the Google Cloud resources and deploys the SaaS application in the regions specified in the SaaS offering resource.

To deploy the SaaS offering, SaaS Runtime creates the unit by deploying the blueprint associated with a unit kind.

Before you begin

Ensure you have created the following:

  1. A SaaS offering resource for your SaaS application.
  2. Unit kinds to model the SaaS offering.

Deploy the SaaS offering

To deploy the SaaS offering, SaaS Runtime provisions the resources that are part of a unit kind. The term in SaaS Runtime for the provisioned resources or deployed application is a unit.

When you create a unit, SaaS Runtime provisions the resources defined in the Terraform configuration that is connected to the unit kind. The resources are provisioned in each region that is part of the SaaS offering.

For example, if you had a unit kind for a single VM, then when you create a unit, SaaS Runtime provisions the VM in the regions defined in the SaaS offering.

  1. Create a unit:

    1. In the console, go to SaaS Runtime > Units.

      Go to Units

    2. Select Create.

    3. On the Unit details page:

      1. For Unit name, type a name for the unit. The name must contain only lowercase letters, numbers, or hyphens.

      2. Under SaaS offering, select the SaaS offering resource that you created earlier.

      3. Under Region, select the region where you want to deploy the resources or application.

      4. Under Unit kind, select the unit kind that defines the resources or application that you want to deploy.

      5. Under Management mode, select User.

        • Unspecified if
        • User to have units deprovisioned manually. Units are not deprovisioned automatically by SaaS Runtime.
        • System to have SaaS Runtime deprovision dependent units when they are no longer needed.

      6. Optional: Add a label to the resources that you are deploying. For more details about labels, see the Labels overview.

        To add a label:

        1. Under Labels select Add labels.

        2. For Key 1 and for Value 1, enter the desired key-value pair.

        3. Repeat the steps above for each label that you want add.

      7. Select Create.

  2. To provision the resources or deploy the application:

    1. On the Units > Create a unit page, select Provision.

    2. For the release field, select the release for the versions of the Terraform configuration that you want to deploy.

    3. For the Service account, select the service account

    4. Add a Tenant project:

      1. Select Add tenant project variables.
      2. Define the first input variable:
        1. For Name, keep the name tenant_project_id
        2. For Variable type, select String.
        3. For Variable value type quickstart-tenant-project.
      3. Define the second input variable:
        1. For Name, keep the name tenant_project_number
        2. For Variable type, select Integer.
        3. For Variable value enter your project number.

    5. Select Provision.

View the deployed unit

You have now used SaaS Runtime to create a unit, which deploys the resources or application in the associated unit kind.

To view the resources that you deployed:

  1. In console, go to the SaaS Runtime > Units > Unit details page.

    Go to Units

  2. Click the name of your unit.

  3. On the Unit details page:

    1. See that the State is Ready (or the state might be Provisioning while the operation is still in progress).
    2. Expand the Variables section.
    3. In the Output variables, you can see details related to any output variables specified in the Terraform configuration. For more details about variables, see Variables and variable mapping.

What's next