Setup guide - Hybrid SaaS Snowflake on Snowpark

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

---

​

Prerequisites

​

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.

To deploy the Maia runner to Snowpark Container Services, the following are also required:

• A Snowflake role with permissions to create:
  • Integrations.
  • Databases.
  • Applications.
  • Compute pools.
• A warehouse that the role has usage permission on. This can be an existing warehouse, or a new warehouse can be created.

​

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. Install the Maia runner into Snowflake.
5. Configure the Maia runner application in Snowflake.
6. 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.
7. Create an environment using your Snowflake credentials.
8. Set up secret definitions for passwords, API keys, and tokens.
9. Create a Git branch in which to begin pipeline work.
10. Create your first pipeline.