Skip to content

Latest commit

 

History

History
92 lines (54 loc) · 3.34 KB

install.md

File metadata and controls

92 lines (54 loc) · 3.34 KB

Install Doit-Easily

This process is the distilled instructions found here, plus information to deploy Doit-Easily.

Terraform modules

There are two Terraform modules in this directory: setup and app_deploy. They correspond with installation steps below.

You can apply the modules using either one of the following methods:

  • Adding a .tfvars file with appropriately configured variables to directly apply the entire modules.

  • Copying the pertinent files to your own terraform modules and apply them there.

We recommend the first approach, using the requested variables.

Setup

Note: These steps can be accomplished by applying this Terraform or gcloud. Terraform is preferred way to execute the setup.

  1. Create a project to hold your listings and backend integration workloads. The project name should be in the format ISV-public.

  2. Grant Google procurement user access to your listing project (role detail).

  3. Create a service account to run your integration workloads.

  4. Verify that the user applying the app deploy terraform has serviceAccountTokenCreator role on the doit-easily SA created in this step

Create a listing and start submitting details

The following steps are completed in your web browser and Producer Portal.

  1. Submit your product information using this Google Form.

  2. Create a new SaaS listing in the Producer Portal.

  3. Start the process of submitting pricing & product information. This can be done in parallel to the technical integration.

  4. In the Producer Portal (see screen capture below):

    1. Link the service account to call the Procurement API and Cloud Pub/Sub Integration.

    2. Copy the Pub/Sub topic string for later users. Use the format projects/cloudcommerceproc-prod/topics/ISV-public.

      Screen Capture

      Diagram

  5. (Optional) In Slack, create a Slack webhook to store this secret in Secret Manager.

Deploy the App

Note: These steps can be accomplished by applying this Terraform.

Please see the README for important instructions about deploying the app and its prerequisites.

  1. Deploy the application in Cloud Run. When finished, continue below.

Finish and test the integration

  1. In the Producer Portal, add the frontend integration URL to the Technical Integration -> Frontend Integration Sign up URL.

    1. (Optional.) Use a custom domain by setting up a load balancer in front of Cloud Run.

    2. (Optional.) Add the SSO Login URL for your console, and support SSO. OR link to your website and disable SSO

    Screen Capture

    Diagram

  2. To test the integration, see our detailed doc on testing

  3. Submit the product details, pricing details, and technical integration for review by Google.

  4. Publish your listing.