Module API
Requirements¶
| Name | Version |
|---|---|
| terraform | >= 1.14 |
| dbtcloud | ~> 1.8 |
Providers¶
| Name | Version |
|---|---|
| terraform | n/a |
Modules¶
| Name | Source | Version |
|---|---|---|
| account_features | ./modules/account_features | n/a |
| credentials | ./modules/credentials | n/a |
| environment_variable_job_overrides | ./modules/environment_variable_job_overrides | n/a |
| environment_variables | ./modules/environment_variables | n/a |
| environments | ./modules/environments | n/a |
| extended_attributes | ./modules/extended_attributes | n/a |
| global_connections | ./modules/global_connections | n/a |
| groups | ./modules/groups | n/a |
| ip_restrictions | ./modules/ip_restrictions | n/a |
| jobs | ./modules/jobs | n/a |
| lineage_integrations | ./modules/lineage_integrations | n/a |
| notifications | ./modules/notifications | n/a |
| oauth_configurations | ./modules/oauth_configurations | n/a |
| profiles | ./modules/profiles | n/a |
| project | ./modules/project | n/a |
| project_artefacts | ./modules/project_artefacts | n/a |
| project_repository | ./modules/project_repository | n/a |
| repository | ./modules/repository | n/a |
| semantic_layer | ./modules/semantic_layer | n/a |
| service_tokens | ./modules/service_tokens | n/a |
| user_groups | ./modules/user_groups | n/a |
Resources¶
| Name | Type |
|---|---|
| terraform_data.validate_yaml_config | resource |
Inputs¶
| Name | Description | Type | Default | Required |
|---|---|---|---|---|
| connection_credentials | Map of global connection keys to their OAuth/auth credential objects (client_id, client_secret, private_key, etc.) | map(any) |
{} |
no |
| dbt_account_id | dbt Cloud account ID | number |
null |
no |
| dbt_host_url | dbt Cloud host URL (e.g., https://cloud.getdbt.com or custom domain) | string |
null |
no |
| dbt_pat | dbt Cloud personal access token for GitHub App integration discovery (service tokens cannot access the integrations API) | string |
null |
no |
| dbt_token | dbt Cloud API token for authentication | string |
null |
no |
| enable_gitlab_deploy_token | Preserve native GitLab deploy_token strategy. Defaults to false due to a known API limitation (GitlabGetError on some accounts). Set to true only when GitLab OAuth access is confirmed. | bool |
false |
no |
| environment_credentials | Map of environment credential keys to their warehouse credential objects. Key format: project_key_env_key. Supports 14 warehouse types via credential_type field. | map(any) |
{} |
no |
| lineage_tokens | Map of lineage integration keys to their authentication tokens (Tableau, Looker, etc.) | map(string) |
{} |
no |
| oauth_client_secrets | Map of OAuth configuration keys to their client secrets | map(string) |
{} |
no |
| target_name | Default target name for the dbt project (e.g., 'dev', 'prod') | string |
"" |
no |
| token_map | Map of credential token names to their actual values (e.g., Databricks tokens). Token names correspond to credential.token_name in YAML. | map(string) |
{} |
no |
| yaml_file | Path to the YAML file defining dbt Cloud resources (projects, environments, jobs, etc.) | string |
n/a | yes |
Outputs¶
| Name | Description |
|---|---|
| connection_ids | Map of global connection key to dbt Cloud connection ID |
| credential_ids | Map of composite key (project_key_env_key) to credential ID |
| environment_ids | Map of composite key (project_key_env_key) to dbt Cloud environment ID |
| extended_attribute_ids | Map of composite key (project_key_ea_key) to extended_attributes resource ID |
| group_ids | Map of group key to dbt Cloud group ID |
| ip_rule_ids | Map of IP rule key to dbt Cloud IP restriction rule ID |
| job_ids | Map of composite key (project_key_job_key) to dbt Cloud job ID |
| lineage_integration_ids | Map of composite key (project_key_integration_key) to lineage integration ID |
| oauth_configuration_ids | Map of OAuth configuration key to dbt Cloud OAuth configuration ID |
| profile_ids | Map of composite key (project_key_profile_key) to dbt Cloud profile ID |
| project_ids | Map of project key to dbt Cloud project ID |
| repository_ids | Map of project key to repository ID |
| service_token_ids | Map of service token key to dbt Cloud service token ID |