dbt deploy action for deploying dbt code to Astro

If you have a dbt project that you want to use with the deploy action for a GitHub action, you can choose to use either the dbt deploy on its own, or you can create GitHub actions that combine the infer action with a dbt deploy.

Prerequisites

An Astro project hosted in a GitHub repository.
An Astro Deployment.
A Deployment API token, Workspace API token, or Organization API token.
Access to GitHub Actions.

Each CI/CD template implementation might have additional requirements.

If you use a self-hosted runner to execute jobs from GitHub Actions, the Astro CLI’s config.yaml file, which stores default deploy details, might be shared across your organization and hence multiple CI/CD pipelines. To reduce the risk of accidentally deploying to the wrong Deployment, ensure the following:

Add ASTRO_API_TOKEN to your repository and include a check in your GitHub workflow to verify that it exists.
Use Deployment API tokens, which are scoped only to one Deployment, instead of Workspace or Organization API tokens.
Specify deployment-id or deployment-name in your action. For example, astro deploy <deployment-id> or astro deploy -n <deployment-name>.
Add the command astro logout at the end of your workflow to ensure that your authentication token is cleared from the config.yaml file

Setup

Single branch

Multiple branch

Combine dbt and Astro project

Prerequisites

The root folder name for the directory that contains your dbt project.

Implementation

To automate code deploys to a single Deployment using GitHub Actions for a dbt project, complete the following setup in a Git-based repository that hosts an Astro project:

Set the following as a GitHub secret:

ASTRO_API_TOKEN: The value for your Workspace or Organization API token.

In your project repository, create a new YAML file in .github/workflows that includes the following configuration:

1 name: Astronomer CI - Deploy dbt code
2 
3 on:
4   push:
5     branches:
6       - main
7 
8 env:
9   ## Sets Deployment API credentials as environment variables
10   ASTRO_API_TOKEN: ${{ secrets.ASTRO_API_TOKEN }}
11 
12 jobs:
13   build:
14     runs-on: ubuntu-latest
15     steps:
16     - name: Deploy to Astro
17       uses: astronomer/deploy-action@v0.10.1
18       with:
19             deployment-id: <deployment id>
20             deploy-type: dbt
21             root-folder: <dbt-root-folder>

(Optional) You can add optional configurations to customize your workflow. For example, if you add wake-on-deploy to your configuration, the Deploy Action wakes a hibernating Deployment before deploying code to it.

Using wake-on-deploy takes precedence over any existing Deployment hibernation overrides that you configured through the Astro UI or config.yaml file.