|
2 | 2 |
|
3 | 3 |  |
4 | 4 |
|
5 | | -[AWS](docs/guides/aws-workspace.md) tutorial |
| 5 | +[Troubleshooting Guide](docs/guides/troubleshooting.md) |
| 6 | +| [AWS](docs/guides/aws-workspace.md) tutorial |
6 | 7 | | [Azure](docs/guides/azure-workspace.md) tutorial |
7 | 8 | | [End-to-end](docs/guides/workspace-management.md) tutorial |
8 | | -| Migration from [0.3.x to 0.4.x](docs/guides/migration-0.4.x.md) |
9 | 9 | | [Changelog](CHANGELOG.md) |
10 | 10 | | [Authentication](docs/index.md) |
11 | 11 | | [databricks_aws_assume_role_policy](docs/data-sources/aws_assume_role_policy.md) data |
|
85 | 85 | | [databricks_zones](docs/data-sources/zones.md) |
86 | 86 | | [Contributing and Development Guidelines](CONTRIBUTING.md) |
87 | 87 |
|
88 | | -[](https://github.com/databrickslabs/terraform-provider-databricks/actions?query=workflow%3Abuild+branch%3Amaster) [](https://codecov.io/gh/databrickslabs/terraform-provider-databricks)  [](https://hanadigital.github.io/grev/?user=databrickslabs&repo=terraform-provider-databricks) |
| 88 | +[](https://github.com/databricks/terraform-provider-databricks/actions?query=workflow%3Abuild+branch%3Amaster) [](https://codecov.io/gh/databricks/terraform-provider-databricks)  [](https://hanadigital.github.io/grev/?user=databricks&repo=terraform-provider-databricks) |
89 | 89 |
|
90 | | -If you use Terraform 0.13 or newer, please refer to instructions specified at [registry page](https://registry.terraform.io/providers/databrickslabs/databricks/latest). If you use older versions of Terraform or want to build it from sources, please refer to [contributing guidelines](CONTRIBUTING.md) page. |
| 90 | +If you use Terraform 0.13 or newer, please refer to instructions specified at [registry page](https://registry.terraform.io/providers/databricks/databricks/latest). If you use older versions of Terraform or want to build it from sources, please refer to [contributing guidelines](CONTRIBUTING.md) page. |
91 | 91 |
|
92 | 92 | ```hcl |
93 | 93 | terraform { |
94 | 94 | required_providers { |
95 | 95 | databricks = { |
96 | | - source = "databrickslabs/databricks" |
97 | | - version = "0.6.2" |
| 96 | + source = "databricks/databricks" |
| 97 | + version = "1.0.0" |
98 | 98 | } |
99 | 99 | } |
100 | 100 | } |
@@ -149,6 +149,19 @@ output "job_url" { |
149 | 149 |
|
150 | 150 | Then run `terraform init` then `terraform apply` to apply the hcl code to your Databricks workspace. |
151 | 151 |
|
152 | | -## Project Support |
| 152 | +# Switching from `databrickslabs` to `databricks` namespace |
153 | 153 |
|
154 | | -**Important:** Projects in the `databrickslabs` GitHub account, including the Databricks Terraform Provider, are not formally supported by Databricks. They are maintained by Databricks Field teams and provided as-is. There is no service level agreement (SLA). Databricks makes no guarantees of any kind. If you discover an issue with the provider, please file a GitHub Issue on the repo, and it will be reviewed by project maintainers as time permits. |
| 154 | +To make Databricks Terraform Provider generally available, we've moved it from [https://github.com/databrickslabs](https://github.com/databrickslabs) to [https://github.com/databricks](https://github.com/databricks). We've worked closely with the Terraform Registry team at Hashicorp to ensure a smooth migration. Existing terraform deployments continue to work as expected without any action from your side. We ask you to replace `databrickslabs/databricks` with `databricks/databricks` in all your `.tf` files. |
| 155 | + |
| 156 | +You should have [`.terraform.lock.hcl`](https://github.com/databrickslabs/terraform-provider-databricks/blob/v0.6.2/scripts/versions-lock.hcl) file in your state directory that is checked into source control. terraform init will give you the following warning. |
| 157 | + |
| 158 | +``` |
| 159 | +Warning: Additional provider information from registry |
| 160 | +
|
| 161 | +The remote registry returned warnings for registry.terraform.io/databrickslabs/databricks: |
| 162 | +- For users on Terraform 0.13 or greater, this provider has moved to databricks/databricks. Please update your source in required_providers. |
| 163 | +``` |
| 164 | + |
| 165 | +After you replace `databrickslabs/databricks` with `databricks/databricks` in the `required_providers` block, the warning will disappear. Do a global "search and replace" in `*.tf` files. Alternatively you can run `python3 -c "$(curl -Ls https://dbricks.co/updtfns)"` from the command-line, that would do all the boring work for you. |
| 166 | + |
| 167 | +If you didn't check-in [`.terraform.lock.hcl`](https://www.terraform.io/language/files/dependency-lock#lock-file-location) to the source code version control, you may you may see `Failed to install provider` error. Please follow the simple steps described in the [troubleshooting guide](docs/guides/troubleshooting.md). |
0 commit comments