Skip to Content
DocumentationEnabling dbt Features

Enabling dbt Features in Etleap

To enable dbt features that allow you to edit models, create schedules, and run preview CI builds, complete the following setup.

Etleap can connect to one dbt project repository that is hosted in GitHub.

Step 1. Install the Etleap GitHub App in your repo

Log in to Etleap and navigate to the Admin Console. Select dbt Settings and complete the GitHub app installation wizard.

dbt app setup
Authorize the Etleap GitHub app.
Warning

Multiple Repo Selection Handling

If the Etleap application has been installed in multiple repos, the first repo listed will be used.

Step 2. Connect a Warehouse for CI

In order to run CI and draft builds, Etleap needs a default warehouse connection which it will create a temporary schema in to test the builds.

To setup CI and draft builds, select a warehouse connection on the dbt Settings screen.

dbt warehouse setup
Select a warehouse to run CI builds in.

Step 3. Create your dbt Project

To use dbt features, your main branch must contain a valid dbt project. A valid dbt project is one in which dbt parse runs successfully.

At a minimum, the project must:

  • Include a dbt_project.yml  file in the project’s root with required configuration defined
  • Include a models folder, for either the default /models path or the first path defined in the [model-paths] field of your dbt_project.yml
  • Ensure all ref() and source() Jinja calls point to existing models or sources
  • Include any macros referenced in models in the project or imported packages