Skip to content

Commit

Permalink
Update docs for v17.5.0 release
Browse files Browse the repository at this point in the history
  • Loading branch information
gitlab-terraform-provider-bot committed Oct 17, 2024
1 parent 9c3cf57 commit 3a945b3
Show file tree
Hide file tree
Showing 17 changed files with 475 additions and 22 deletions.
27 changes: 27 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,30 @@
## 17.5.0 (2024-10-17)

This release was tested against GitLab 17.5, 17.4, and 17.3 for both CE and EE

## FEATURES (3 changes)

- **New Resource** resource/gitlab_group_service_account: [Allows creating service accounts for a gitlab group](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/a1e1686636ee2d901344163bac22bc032ad52056) by @michal.szczepek ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2122))
- **New Resource** resource/gitlab_group_service_account_token: [Allows creating service account tokens for a service account](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/a1e1686636ee2d901344163bac22bc032ad52056) by @michal.szczepek ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2122))
- **New Datasource** data/gitlab_group_service_account: [Allows creating service accounts for a gitlab group](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/a1e1686636ee2d901344163bac22bc032ad52056) by @michal.szczepek ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2122))
- **New Datasource** data/gitlab_group_provisioned_users: [Allows listing users provisioned by an Identity Provider](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/7daffab21eedd594746671a28becd20adba15f8c) by @nvh04121 ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2107))

## IMPROVEMENTS (9 changes)

- provider/gitlab: [Add support for `headers` to the provider to allow setting custom headers](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/72f1a49dddcaa9ad18a81a604066b9959f565bed) by @ruben.aleman ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2136))
- resource/gitlab_application_settings: [Add support for 20 additional new fields](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/5a6321fb096c80be4319dc29cf2186f66163bd88) by @Jitsusama ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2110))
- resource/gitlab_application_settings: [Add support for 23 (for a total of 43 in 17.5) additional new fields](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/4c07217976e4cebcbda7ee02bbda71a6696e9dac) by @Jitsusama ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2109))
- resource/gitlab_project: [Support `allow_pipeline_trigger_approve_deployment`](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/2497fc45f72577292412a398302b508c357e9a5c) by @loozhengyuan ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2141))
- resource/gitlab_project: [Support `model_experiments_access_level` and `model_registry_access_level`](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/aec6e45be6f6ee687062afa96b8b8b9347540bad) by @jeremad ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2125))
- resource/gitlab_group: [Add support for specifying the default branch](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/b0983be7c8cec2651af5ce82cdbda1caf5e82c56) by @jae-sorcero ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2155))
- resource/gitlab_group: [Add `no one` as a valid permissions when using `default_branch_protection_defaults`](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/bb0242b353c34907d88e47a418a51404228af7d9) by @jae-sorcero ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2147))
- resource/gitlab_personal_access_token: [Add support for `rotation_configuration`](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/afa261c798635521fd660b04b1a6a7d9100113a7) by @ruben.aleman ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2143))
- data/gitlab_pipeline_schedules: [Add `id` for each schedule found using the datasource](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/169c4daf5bf51e9f9176ea76c00e518117e0de4e) by @nicolas.boussuge.fintech ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2149))

## BUG FIXES (1 change)

- resource/gitlab_project: [Only apply `use_custom_template` during creation if the value is `true`. Fixes an issue where using `use_custom_template = false` would cause a 500 error](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/commit/bf658535994f38b8dcf743e2827abe4e3e66e20b) by @PatrickRice ([merge request](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/2140))

## 17.4.0 (2024-09-19)

This release was tested against GitLab 17.4, 17.3, and 17.2 for both CE and EE
Expand Down
1 change: 1 addition & 0 deletions docs/data-sources/group.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ data "gitlab_group" "foo" {

### Read-Only

- `default_branch` (String) The default branch of the group.
- `default_branch_protection` (Number) Whether developers and maintainers can push to the applicable default branch.
- `description` (String) The description of the group.
- `extra_shared_runners_minutes_limit` (Number) Can be set by administrators only. Additional CI/CD minutes for this group.
Expand Down
67 changes: 67 additions & 0 deletions docs/data-sources/group_provisioned_users.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "gitlab_group_provisioned_users Data Source - terraform-provider-gitlab"
subcategory: ""
description: |-
The gitlab_group_provisioned_users data source allows details of the provisioned users of a given group.
Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/groups.html#list-provisioned-users
---

# gitlab_group_provisioned_users (Data Source)

The `gitlab_group_provisioned_users` data source allows details of the provisioned users of a given group.

**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/groups.html#list-provisioned-users)



<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `id` (String) The ID or URL-encoded path of the group.

### Optional

- `active` (Boolean) Return only active provisioned users.
- `blocked` (Boolean) Return only blocked provisioned users.
- `created_after` (String) Return only provisioned users created on or after the specified date. Expected in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
- `created_before` (String) Return only provisioned users created on or before the specified date. Expected in ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).
- `search` (String) The search query to filter the provisioned users.
- `username` (String) The username of the provisioned user.

### Read-Only

- `provisioned_users` (Block List) The list of provisioned users. (see [below for nested schema](#nestedblock--provisioned_users))

<a id="nestedblock--provisioned_users"></a>
### Nested Schema for `provisioned_users`

Read-Only:

- `avatar_url` (String) The avatar URL of the provisioned user.
- `bio` (String) The bio of the provisioned user.
- `bot` (Boolean) Whether the provisioned user is a bot.
- `confirmed_at` (String) The confirmation date of the provisioned user.
- `created_at` (String) The creation date of the provisioned user.
- `email` (String) The email of the provisioned user.
- `external` (Boolean) Whether the provisioned user is external.
- `id` (String) The ID of the provisioned user.
- `job_title` (String) The job title of the provisioned user.
- `last_activity_on` (String) The last activity date of the provisioned user.
- `last_sign_in_at` (String) The last sign-in date of the provisioned user.
- `linkedin` (String) The LinkedIn ID of the provisioned user.
- `location` (String) The location of the provisioned user.
- `name` (String) The name of the provisioned user.
- `organization` (String) The organization of the provisioned user.
- `private_profile` (Boolean) Whether the provisioned user has a private profile.
- `pronouns` (String) The pronouns of the provisioned user.
- `public_email` (String) The public email of the provisioned user.
- `skype` (String) The Skype ID of the provisioned user.
- `state` (String) The state of the provisioned user.
- `twitter` (String) The Twitter ID of the provisioned user.
- `two_factor_enabled` (Boolean) Whether two-factor authentication is enabled for the provisioned user.
- `username` (String) The username of the provisioned user.
- `web_url` (String) The web URL of the provisioned user.
- `website_url` (String) The website URL of the provisioned user.
33 changes: 33 additions & 0 deletions docs/data-sources/group_service_account.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "gitlab_group_service_account Data Source - terraform-provider-gitlab"
subcategory: ""
description: |-
The gitlab_group_service_account data source retrieves information about a gitlab service account for a group.
Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/group_service_accounts.html#list-service-account-users
---

# gitlab_group_service_account (Data Source)

The `gitlab_group_service_account` data source retrieves information about a gitlab service account for a group.

**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/group_service_accounts.html#list-service-account-users)



<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `group` (String) The ID or URL-encoded path of the target group. Must be a top-level group.
- `service_account_id` (String) The service account id.

### Optional

- `name` (String) The name of the user. If not specified, the default Service account user name is used.
- `username` (String) The username of the user. If not specified, it's automatically generated.

### Read-Only

- `id` (String) The ID of this Terraform resource. In the format of `<group>:<service_account_id>`.
2 changes: 1 addition & 1 deletion docs/data-sources/pipeline_schedules.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ data "gitlab_pipeline_schedules" "example" {

Required:

- `id` (String) The pipeline schedule id.
- `id` (Number) The pipeline schedule id.

Optional:

Expand Down
3 changes: 3 additions & 0 deletions docs/data-sources/project.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ data "gitlab_project" "example" {

### Read-Only

- `allow_pipeline_trigger_approve_deployment` (Boolean) Set whether or not a pipeline triggerer is allowed to approve deployments. Premium and Ultimate only.
- `analytics_access_level` (String) Set the analytics access level. Valid values are `disabled`, `private`, `enabled`.
- `archived` (Boolean) Whether the project is in read-only mode (archived).
- `auto_cancel_pending_pipelines` (String) Auto-cancel pending pipelines. This isn’t a boolean, but enabled/disabled.
Expand Down Expand Up @@ -73,6 +74,8 @@ data "gitlab_project" "example" {
- `merge_requests_access_level` (String) Set the merge requests access level. Valid values are `disabled`, `private`, `enabled`.
- `merge_requests_enabled` (Boolean) Enable merge requests for the project.
- `merge_trains_enabled` (Boolean) Enable or disable merge trains.
- `model_experiments_access_level` (String) The visibility of machine learning model experiments.
- `model_registry_access_level` (String) The visibility of machine learning model registry.
- `monitor_access_level` (String) Set the monitor access level. Valid values are `disabled`, `private`, `enabled`.
- `name` (String) The name of the project.
- `namespace_id` (Number) The namespace (group or user) of the project. Defaults to your user.
Expand Down
103 changes: 103 additions & 0 deletions docs/data-sources/project_merge_request.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,103 @@
---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "gitlab_project_merge_request Data Source - terraform-provider-gitlab"
subcategory: ""
description: |-
The gitlab_project_merge_request data source retrieves
information about a single merge request related to a specific project.
Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/merge_requests.html#get-single-mr
---

# gitlab_project_merge_request (Data Source)

The `gitlab_project_merge_request` data source retrieves
information about a single merge request related to a specific project.

**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/merge_requests.html#get-single-mr)

## Example Usage

```terraform
data "gitlab_project_merge_request" "by_project_id" {
project = "123"
iid = 456
}
data "gitlab_project_merge_request" "by_project_name" {
project = "company/group/project1"
iid = 3
}
```

<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `iid` (Number) The unique project level ID of the merge request.
- `project` (String) The ID or path of the project.

### Read-Only

- `assignee` (Attributes) First assignee of the merge request. (see [below for nested schema](#nestedatt--assignee))
- `assignees` (Attributes List) Assignees of the merge request. (see [below for nested schema](#nestedatt--assignees))
- `author` (Attributes) User who created this merge request. (see [below for nested schema](#nestedatt--author))
- `blocking_discussions_resolved` (Boolean) Indicates if all discussions are resolved only if all are
required before merge request can be merged.
- `changes_count` (String) Number of changes made on the merge request. Empty when the
merge request is created, and populates asynchronously.
- `closed_at` (String) Timestamp of when the merge request was closed.
- `closed_by` (Attributes) User who closed this merge request. (see [below for nested schema](#nestedatt--closed_by))
- `created_at` (String) Timestamp of when the merge request was created.
- `id` (Number) The unique instance level ID of the merge request.

<a id="nestedatt--assignee"></a>
### Nested Schema for `assignee`

Read-Only:

- `avatar_url` (String) A link to the user's avatar image.
- `id` (Number) The internal ID number of the user.
- `name` (String) The name of the user.
- `state` (String) The state of the user account.
- `username` (String) The username of the user.
- `web_url` (String) A link to the user's profile page.


<a id="nestedatt--assignees"></a>
### Nested Schema for `assignees`

Read-Only:

- `avatar_url` (String) A link to the user's avatar image.
- `id` (Number) The internal ID number of the user.
- `name` (String) The name of the user.
- `state` (String) The state of the user account.
- `username` (String) The username of the user.
- `web_url` (String) A link to the user's profile page.


<a id="nestedatt--author"></a>
### Nested Schema for `author`

Read-Only:

- `avatar_url` (String) A link to the user's avatar image.
- `id` (Number) The internal ID number of the user.
- `name` (String) The name of the user.
- `state` (String) The state of the user account.
- `username` (String) The username of the user.
- `web_url` (String) A link to the user's profile page.


<a id="nestedatt--closed_by"></a>
### Nested Schema for `closed_by`

Read-Only:

- `avatar_url` (String) A link to the user's avatar image.
- `id` (Number) The internal ID number of the user.
- `name` (String) The name of the user.
- `state` (String) The state of the user account.
- `username` (String) The username of the user.
- `web_url` (String) A link to the user's profile page.
3 changes: 3 additions & 0 deletions docs/data-sources/projects.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,7 @@ Read-Only:

- `_links` (Map of String)
- `allow_merge_on_skipped_pipeline` (Boolean)
- `allow_pipeline_trigger_approve_deployment` (Boolean)
- `analytics_access_level` (String)
- `approvals_before_merge` (Number)
- `archived` (Boolean)
Expand Down Expand Up @@ -136,6 +137,8 @@ Read-Only:
- `mirror_overwrites_diverged_branches` (Boolean)
- `mirror_trigger_builds` (Boolean)
- `mirror_user_id` (Number)
- `model_experiments_access_level` (String)
- `model_registry_access_level` (String)
- `monitor_access_level` (String)
- `name` (String)
- `name_with_namespace` (String)
Expand Down
1 change: 1 addition & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,7 @@ resource "gitlab_project" "sample_group_project" {
- `client_cert` (String) File path to client certificate when GitLab instance is behind company proxy. File must contain PEM encoded data.
- `client_key` (String) File path to client key when GitLab instance is behind company proxy. File must contain PEM encoded data. Required when `client_cert` is set.
- `early_auth_check` (Boolean) (Experimental) By default the provider does a dummy request to get the current user in order to verify that the provider configuration is correct and the GitLab API is reachable. Set this to `false` to skip this check. This may be useful if the GitLab instance does not yet exist and is created within the same terraform module. It may be sourced from the `GITLAB_EARLY_AUTH_CHECK`. This is an experimental feature and may change in the future. Please make sure to always keep backups of your state.
- `headers` (Map of String) A map of headers to append to all API request to the GitLab instance.
- `insecure` (Boolean) When set to true this disables SSL verification of the connection to the GitLab instance.
- `retries` (Number) The number of retries to execute when receiving a 429 Rate Limit error. Each retry will exponentially back off.
- `token` (String, Sensitive) The OAuth2 Token, Project, Group, Personal Access Token or CI Job Token used to connect to GitLab. The OAuth method is used in this provider for authentication (using Bearer authorization token). See https://docs.gitlab.com/ee/api/#authentication for details. It may be sourced from the `GITLAB_TOKEN` environment variable.
Loading

0 comments on commit 3a945b3

Please sign in to comment.