Skip to content

Commit 0b4167c

Browse files
update docs - specify which resources require admin token
1 parent 4ed8435 commit 0b4167c

17 files changed

+30
-26
lines changed

codefresh/data_account.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import (
99

1010
func dataSourceAccount() *schema.Resource {
1111
return &schema.Resource{
12-
Description: "This data source retrieves an account by _id or name.",
12+
Description: "This data source retrieves an account by _id or name. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.",
1313
Read: dataSourceAccountRead,
1414
Schema: map[string]*schema.Schema{
1515
"_id": {

codefresh/data_idps.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import (
1010

1111
func dataSourceIdps() *schema.Resource {
1212
return &schema.Resource{
13-
Description: "This data source retrieves all Identity Providers (IdPs) in the system.",
13+
Description: "This data source retrieves all Identity Providers (IdPs) in the system. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.",
1414
Read: dataSourceIdpRead,
1515
Schema: IdpSchema(),
1616
}

codefresh/data_user.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ import (
1010

1111
func dataSourceUser() *schema.Resource {
1212
return &schema.Resource{
13-
Description: "This data source retrieves a user by email.",
13+
Description: "This data source retrieves a user by email. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.",
1414
Read: dataSourceUserRead,
1515
Schema: *UserSchema(),
1616
}

codefresh/data_users.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import (
99

1010
func dataSourceUsers() *schema.Resource {
1111
return &schema.Resource{
12-
Description: "This data source retrieves all users in the system.",
12+
Description: "This data source retrieves all users in the system. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.",
1313
Read: dataSourceUsersRead,
1414
Schema: map[string]*schema.Schema{
1515
"users": {

codefresh/resource_account.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ import (
88
func resourceAccount() *schema.Resource {
99
return &schema.Resource{
1010
Description: `
11-
By creating different accounts for different teams within the same company a customer can achieve complete segregation of assets between the teams.
11+
By creating different accounts for different teams within the same company a customer can achieve complete segregation of assets between the teams. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1212
`,
1313
Create: resourceAccountCreate,
1414
Read: resourceAccountRead,

codefresh/resource_account_admins.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ import (
99
func resourceAccountAdmins() *schema.Resource {
1010
return &schema.Resource{
1111
Description: `
12-
Use this resource to set a list of admins for any account.
12+
Use this resource to set a list of admins for any account. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1313
`,
1414
Create: resourceAccountAdminsCreate,
1515
Read: resourceAccountAdminsRead,

codefresh/resource_api_key.go

+1
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,7 @@ func resourceApiKey() *schema.Resource {
1414
return &schema.Resource{
1515
Description: `
1616
Manages an API Key tied to an Account and a User.
17+
Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1718
`,
1819
Create: resourceApiKeyCreate,
1920
Read: resourceApiKeyRead,

codefresh/resource_user.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import (
1111

1212
func resourceUser() *schema.Resource {
1313
return &schema.Resource{
14-
Description: "This resource is used to manage a Codefresh user.",
14+
Description: "This resource is used to manage a Codefresh user. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.",
1515
Create: resourceUsersCreate,
1616
Read: resourceUsersRead,
1717
Update: resourceUsersUpdate,

docs/data-sources/account.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
page_title: "codefresh_account Data Source - terraform-provider-codefresh"
33
subcategory: ""
44
description: |-
5-
This data source retrieves an account by _id or name.
5+
This data source retrieves an account by _id or name. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
66
---
77

88
# codefresh_account (Data Source)
99

10-
This data source retrieves an account by _id or name.
10+
This data source retrieves an account by _id or name. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1111

1212
## Example Usage
1313

docs/data-sources/idps.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: |-
77

88
# codefresh_idps (Data Source)
99

10-
This data source retrieves all Identity Providers (IdPs) in the system.
10+
This data source retrieves all Identity Providers (IdPs) in the system. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1111

1212
## Example Usage
1313

@@ -55,7 +55,7 @@ resource "codefresh_user" "user1" {
5555
idp_id = data.codefresh_idps.idp_azure.id
5656
sso = true
5757
}
58-
58+
5959
login {
6060
idp_id = data.codefresh_idps.local.id
6161
//sso = false
@@ -99,4 +99,4 @@ resource "codefresh_idp_accounts" "acc_idp" {
9999
- `cookie_key` (String)
100100
- `id` (String) The ID of this resource.
101101
- `scopes` (Set of String)
102-
- `tenant` (String)
102+
- `tenant` (String)

docs/data-sources/user.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
page_title: "codefresh_user Data Source - terraform-provider-codefresh"
33
subcategory: ""
44
description: |-
5-
This data source retrieves a user by email.
5+
This data source retrieves a user by email. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
66
---
77

88
# codefresh_user (Data Source)
@@ -88,4 +88,4 @@ Read-Only:
8888

8989
Read-Only:
9090

91-
- `user_name` (String)
91+
- `user_name` (String)

docs/data-sources/users.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
page_title: "codefresh_users Data Source - terraform-provider-codefresh"
33
subcategory: ""
44
description: |-
5-
This data source retrieves all users in the system.
5+
This data source retrieves all users in the system. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
66
---
77

88
# codefresh_users (Data Source)
@@ -81,4 +81,4 @@ Read-Only:
8181

8282
Read-Only:
8383

84-
- `user_name` (String)
84+
- `user_name` (String)

docs/resources/account.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: |-
77

88
# codefresh_account (Resource)
99

10-
By creating different accounts for different teams within the same company a customer can achieve complete segregation of assets between the teams.
10+
By creating different accounts for different teams within the same company a customer can achieve complete segregation of assets between the teams. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1111

1212
See the [documentation](https://codefresh.io/docs/docs/administration/account-user-management/).
1313

@@ -86,4 +86,4 @@ Optional:
8686
## Import
8787
```sh
8888
terraform import codefresh_account.test xxxxxxxxxxxxxxxxxxx
89-
```
89+
```

docs/resources/account_admins.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: |-
77

88
# codefresh_account_admins (Resource)
99

10-
Use this resource to set a list of admins for any account.
10+
Use this resource to set a list of admins for any account. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1111

1212
## Example usage
1313

@@ -72,4 +72,4 @@ resource "codefresh_account_admins" "test" {
7272

7373
```sh
7474
terraform import codefresh_account_admins.test xxxxxxxxxxxxxxxxxxx
75-
```
75+
```

docs/resources/account_gitops_settings.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ resource "codefresh_account_gitops_settings" "gitops-settings" {
4141
- `id` (String) Account Id
4242
- `name` (String) Account name for active account
4343

44-
~>
44+
[!WARNING]
4545
Once internal config repository is cloned successfully by one or more runtimes it can no longer be changed and all attempted updates will fail.
4646
If you need to change the repository please contact Codefresh support.
4747

docs/resources/api_key.md

+5-3
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,16 @@
22
page_title: "codefresh_api_key Resource - terraform-provider-codefresh"
33
subcategory: ""
44
description: |-
5-
Manages an API Key tied to an Account and a User. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
5+
Manages an API Key tied to an Account and a User.
6+
Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
67
---
78

89
# codefresh_api_key (Resource)
910

1011
Manages an API Key tied to an Account and a User.
12+
Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1113

12-
terraform-provider-codefresh itself uses an API key, passed as provider's attribute, but it's possible to use that API Key to generate a new one.
14+
terraform-provider-codefresh itself uses an API key, passed as provider's attribute, but it's possible to use that API Key to generate a new one.
1315
This resource requires Codefresh system admin permissions, hence is relevant for on-prem deployments of Codefresh only.
1416

1517

@@ -106,4 +108,4 @@ resource "codefresh_team" "team_1" {
106108
### Read-Only
107109

108110
- `id` (String) The ID of this resource.
109-
- `token` (String, Sensitive) The resulting API key.
111+
- `token` (String, Sensitive) The resulting API key.

docs/resources/user.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ description: |-
77

88
# codefresh_user (Resource)
99

10-
This resource is used to manage a Codefresh user.
10+
This resource is used to manage a Codefresh user. Requires Codefresh admin token and hence is relevant only for on premise installations of Codefresh.
1111

1212

1313

@@ -43,7 +43,7 @@ resource "codefresh_user" "new" {
4343
idp_id = data.codefresh_idps.idp_azure.id
4444
sso = true
4545
}
46-
46+
4747
login {
4848
idp_id = data.codefresh_idps.local.id
4949
//sso = false
@@ -119,3 +119,4 @@ Read-Only:
119119
```sh
120120
terraform import codefresh_user.new xxxxxxxxxxxxxxxxxxx
121121
```
122+

0 commit comments

Comments
 (0)