Setup guide - Hybrid SaaS Snowflake on Google Cloud

This document describes the necessary steps to follow to set up your first working project in Maia for the following configuration options:

---

​

Prerequisites

​

Google Cloud requirements

• A Google Cloud account with privileges to deploy and run a Maia runner on Google Kubernetes Engine (GKE). For the full set of required APIs, IAM roles, and infrastructure prerequisites, read Google Cloud IAM permissions for runner deployment and the GKE deployment guide.

​

Snowflake requirements

• A Snowflake account with the following information:
  • Your Snowflake account name and region (found in the URL you use to log in to Snowflake).
  • Your Snowflake login credentials (Snowflake private key).
  • A Snowflake role, warehouse, database, and schema.

​

Connectivity requirements

• Access enabled for the IP addresses listed under the Hybrid SaaS section of Network access and IP Allowlist requirements.

​

Git requirements

If you choose to use your own Git provider instead of the Maia Hosted Git option, you need the following:

• The Maia app installed in your organization’s account with one of the supported Git providers:
  • GitHub.
  • Azure DevOps.
  • GitLab.
  • Bitbucket.

---

​

Setup steps

1. Register for a Maia account.
2. Create accounts for users and admins who will be active in Maia.
3. Create a Maia runner in Maia.
4. Deploy a Maia runner on GKE in your Google Cloud project.
5. Create a project, making the following choices:
   • Select Advanced settings.
   • Select the Maia runner you created and deployed previously.
   • Select the Git provider you wish to use.
6. Create an environment using your Snowflake credentials.
7. Set up secret definitions for passwords, API keys, and tokens.
8. Create a Git branch in which to begin pipeline work.
9. Create your first pipeline.