You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
-> Before upgrading to version 2.0.0, please first upgrade to the most recent 1.X version and ensure that your environment successfully runs[`terraform plan`](https://developer.hashicorp.com/terraform/cli/commands/plan) without unexpected changes or deprecation notices.
22
+
23
+
We highly recommend using[version constraints](https://developer.hashicorp.com/terraform/language/providers/requirements#version-constraints) when configuring Terraform providers.
24
+
25
+
26
+
For example, given the previous configuration:
27
+
28
+
```terraform
29
+
terraform {
30
+
required_providers {
31
+
coder = {
32
+
source = "coder/coder"
33
+
version = "~> 1.0.0"
34
+
}
35
+
}
36
+
}
37
+
38
+
provider "coder" {
39
+
feature_use_managed_variables = true
40
+
}
41
+
```
42
+
43
+
Update to the latest 2.X version:
44
+
45
+
```terraform
46
+
terraform {
47
+
required_providers {
48
+
coder = {
49
+
source = "coder/coder"
50
+
version = "~> 2.0.0"
51
+
}
52
+
}
53
+
}
54
+
55
+
provider "coder" {}
56
+
```
57
+
58
+
##Provider Arguments
59
+
60
+
Version 2.0.0 removes the[`feature_use_managed_variables`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs#feature_use_managed_variables-1) argument from the`provider` block.
If you are using this data source, you must replace it with the[`coder_external_auth`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/external_auth) data source. The`coder_external_auth` data source is a more generic data source that can be used to create any external authentication provider which supports OAuth2.
If you are using the`owner` properties of the`coder_workspace` data source, you must remove them and use the[`coder_workspace_owner`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner) data source instead. The`coder_workspace_owner` data source provides additional properties of the workspace owner.
86
+
87
+
Update your Terraform configuration to use the`coder_workspace_owner` data source instead and update the following attributes:
->While we do not anticipate these changes to affect existing resources, we strongly advice reviewing the plan produced by Terraform to ensure no resources are accidentally removed or altered in an undesired way. If you encounter any unexpected behavior, please report it by opening a GitHub[issue](https://github.com/coder/terraform-provider-coder/issues).
Copy file name to clipboardExpand all lines: docs/index.md
+5-1Lines changed: 5 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,11 @@ description: |-
8
8
9
9
#Coder Provider
10
10
11
-
Terraform provider for managing Coder[templates](https://coder.com/docs/templates), which are the underlying infrastructure for Coder[workspaces](https://coder.com/docs/workspaces).
11
+
Terraform provider for managing Coder[templates](https://coder.com/docs/admin/templates), which are the underlying infrastructure for Coder[workspaces](https://coder.com/docs/user-guides/workspace-management).
12
+
13
+
-> Requires Coder[v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
14
+
15
+
!>[`coder_git_auth`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs/data-sources/git_auth) and owner related fields of[`coder_workspace`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs/data-sources/workspace) data source have been removed. Follow the[Version 2 Upgrade Guide](https://registry.terraform.io/providers/codercom/coder/latest/docs/guides/version-2-upgrade) to update your code.
-> Before upgrading to version 2.0.0, please first upgrade to the most recent 1.X version and ensure that your environment successfully runs [`terraform plan`](https://developer.hashicorp.com/terraform/cli/commands/plan) without unexpected changes or deprecation notices.
22
+
23
+
We highly recommend using [version constraints](https://developer.hashicorp.com/terraform/language/providers/requirements#version-constraints) when configuring Terraform providers.
24
+
25
+
26
+
For example, given the previous configuration:
27
+
28
+
```terraform
29
+
terraform {
30
+
required_providers {
31
+
coder = {
32
+
source = "coder/coder"
33
+
version = "~> 1.0.0"
34
+
}
35
+
}
36
+
}
37
+
38
+
provider "coder" {
39
+
feature_use_managed_variables = true
40
+
}
41
+
```
42
+
43
+
Update to the latest 2.X version:
44
+
45
+
```terraform
46
+
terraform {
47
+
required_providers {
48
+
coder = {
49
+
source = "coder/coder"
50
+
version = "~> 2.0.0"
51
+
}
52
+
}
53
+
}
54
+
55
+
provider "coder" {}
56
+
```
57
+
58
+
## Provider Arguments
59
+
60
+
Version 2.0.0 removes the [`feature_use_managed_variables`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs#feature_use_managed_variables-1) argument from the `provider` block.
61
+
62
+
63
+
## Data Source: [`coder_git_auth`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs/data-sources/git_auth)
64
+
65
+
If you are using this data source, you must replace it with the [`coder_external_auth`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/external_auth) data source. The `coder_external_auth` data source is a more generic data source that can be used to create any external authentication provider which supports OAuth2.
66
+
67
+
For example, given the previous configuration:
68
+
69
+
```terraform
70
+
data "coder_git_auth" "example" {
71
+
id = "example"
72
+
}
73
+
```
74
+
75
+
Update to the new data source:
76
+
77
+
```terraform
78
+
data "coder_external_auth" "example" {
79
+
id = "example"
80
+
}
81
+
```
82
+
83
+
## Data Source: [`coder_workspace`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs/data-sources/workspace)
84
+
85
+
If you are using the `owner` properties of the `coder_workspace` data source, you must remove them and use the [`coder_workspace_owner`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner) data source instead. The `coder_workspace_owner` data source provides additional properties of the workspace owner.
86
+
87
+
Update your Terraform configuration to use the `coder_workspace_owner` data source instead and update the following attributes:
88
+
89
+
```terraform
90
+
data "coder_workspace_owner" "me" {}
91
+
```
92
+
93
+
- Remove `owner_id` attribute. Use [`data.coder_workspace_owner.me.id`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner#id) instead.
94
+
- Remove `owner` attribute. Use [`data.coder_workspace_owner.me.name`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner#name) instead.
95
+
- Remove `owner_name` attribute. Use [`data.coder_workspace_owner.me.full_name`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner#full_name) instead.
96
+
- Remove `owner_email` attribute. Use [`data.coder_workspace_owner.me.email`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner#email) instead.
97
+
- Remove `owner_groups` attribute. Use [`data.coder_workspace_owner.me.groups`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner#groups) instead.
98
+
- Remove `owner_oidc_access_token` attribute. Use [`data.coder_workspace_owner.me.oidc_access_token`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner#oidc_access_token) instead.
99
+
- Remove `owner_session_token` attribute. Use [`data.coder_workspace_owner.me.session_token`](https://registry.terraform.io/providers/coder/coder/2.0.0/docs/data-sources/workspace_owner#session_token) instead.
100
+
101
+
->While we do not anticipate these changes to affect existing resources, we strongly advice reviewing the plan produced by Terraform to ensure no resources are accidentally removed or altered in an undesired way. If you encounter any unexpected behavior, please report it by opening a GitHub [issue](https://github.com/coder/terraform-provider-coder/issues).
Copy file name to clipboardExpand all lines: templates/index.md.tmpl
+5-1Lines changed: 5 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,11 @@ description: |-
8
8
9
9
# Coder Provider
10
10
11
-
Terraform provider for managing Coder [templates](https://coder.com/docs/templates), which are the underlying infrastructure for Coder [workspaces](https://coder.com/docs/workspaces).
11
+
Terraform provider for managing Coder [templates](https://coder.com/docs/admin/templates), which are the underlying infrastructure for Coder [workspaces](https://coder.com/docs/user-guides/workspace-management).
12
+
13
+
-> Requires Coder [v2.18.0](https://github.com/coder/coder/releases/tag/v2.18.0) or later.
14
+
15
+
!> [`coder_git_auth`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs/data-sources/git_auth) and owner related fields of [`coder_workspace`](https://registry.terraform.io/providers/coder/coder/1.0.4/docs/data-sources/workspace) data source have been removed. Follow the [Version 2 Upgrade Guide](https://registry.terraform.io/providers/codercom/coder/latest/docs/guides/version-2-upgrade) to update your code.