Skip to content
LocalStack Docs LocalStack Docs Docs

Continuous Integration

Introduction

Section titled “Introduction”

This guide explains how to set up the Snowflake emulator in a continuous integration (CI) environment. You can use the emulator to test your Snowflake integration without connecting to the real Snowflake instance.

To install the Snowflake emulator, you need to set up the LocalStack CLI and pull the Docker image. After starting the Docker container, an endpoint (snowflake.localhost.localstack.cloud) is made available to connect to the emulated Snowflake instance, which you can use to test your data integrations in CI environments.

Configure the LocalStack CI Key

Section titled “Configure the LocalStack CI Key”

Before you begin, set up the LocalStack CI key to activate the Snowflake emulator in your CI environment. LocalStack requires a CI Key for use in continuous integration (CI) or similar machine environments. Each instance startup in a CI or comparable environment consumes one CI token.

To create a CI key, follow these steps:

  1. Open the LocalStack Web Application.
  2. Click the CI Keys on the left navigation pane.
  3. Navigate to the Generate CI Key tab, enter a description, and click Generate CI Key.
  4. Copy the generated CI key and set it as the LOCALSTACK_AUTH_TOKEN environment variable in your CI environment.

Setup the CI configuration

Section titled “Setup the CI configuration”

The following examples demonstrate how to set up the emulator in GitHub Actions, CircleCI, and GitLab CI.

name: LocalStack Test
on: [ push, pull_request ]


jobs:
  localstack-action-test:
    name: 'Test LocalStack GitHub Action'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3


      - name: Start Snowflake emulator
        run:
          docker pull localstack/snowflake:latest
          pip install localstack
          localstack start --stack snowflake -d
          echo "Waiting for LocalStack startup..."
          localstack wait -t 15
          echo "Startup complete"
        env:
          LOCALSTACK_AUTH_TOKEN: ${{ secrets.LOCALSTACK_AUTH_TOKEN }}