Update docs for v16.8.0 release

Author: gitlab-terraform-provider-bot

CHANGELOG.md

@@ -1,4 +1,27 @@
-## 16.7.0 (2023-12-21)
+## 16.8.0 (2024-01-18)
+
+This release was tested against GitLab 16.6, 16.7, and 16.8 for both CE and EE
+
+BREAKING CHANGE:
+
+- gitlab_application_settings: Removed support for `delayed_group_deletion` and `delayed_project_deletion`, which haven't been supported since GitLab 16.0 ([!1799](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1799))
+
+IMPROVEMENTS:
+
+- **New Resource** `gitlab_global_level_notifications` allows managing global notifications for the user ([!1801](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1801))
+- resource/gitlab_project: Added support for the `timeouts` block, to allow configurable timeouts for creating projects ([]())
+- resource/gitlab_application_settings: Added support for `housekeeping_optimize_repository_period`, and updated the description of `housekeeping_enabled` to be more descriptive of what fields were required for a successful apply ([!1777](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1777))
+- datasource/gitlab_project: Added support for `shared_with_groups` which includes groups that are shared with the project ([!1795](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1795))
+- datasource/gitlab_group: Added support for `shared_with_groups` which includes groups that are shared with the group ([!1769](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1769))
+- datasource/gitlab_user: Added support for the `is_bot` attribute ([!1798](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1798))
+- datasource/gitlab_users: Added support for the `is_bot` attribute ([!1798](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1798))
+
+BUG FIXES:
+
+- resource/gitlab_pipeline_schedule_variable: Fixed an issue where deleting the pipeline associated to the variable outside of terraform would cause the resource to be stuck in an error state ([!1796](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1796))
+- resource/gitlab_project_hook: Fixed an issue where changing the URL of a webhook would delete the associated `token`. Changing the URL will now force a new webhook to be created ([!1794](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1794))
+
+## 16.7.0 (2024-01-08)
 
 This release was tested against GitLab 16.5, 16.6, and 16.7 for both CE and EE
 

docs/data-sources/group.md

@@ -52,6 +52,18 @@ data "gitlab_group" "foo" {
 - `runners_token` (String, Sensitive) The group level registration token to use during runner setup.
 - `shared_runners_minutes_limit` (Number) Can be set by administrators only. Maximum number of monthly CI/CD minutes for this group. Can be nil (default; inherit system default), 0 (unlimited), or > 0.
 - `shared_runners_setting` (String) Enable or disable shared runners for a group’s subgroups and projects. Valid values are: `enabled`, `disabled_and_overridable`, `disabled_and_unoverridable`, `disabled_with_override`.
+- `shared_with_groups` (List of Object) Describes groups which have access shared to this group. (see [below for nested schema](#nestedatt--shared_with_groups))
 - `visibility_level` (String) Visibility level of the group. Possible values are `private`, `internal`, `public`.
 - `web_url` (String) Web URL of the group.
 - `wiki_access_level` (String) The group's wiki access level. Only available on Premium and Ultimate plans. Valid values are `disabled`, `private`, `enabled`.
+
+<a id="nestedatt--shared_with_groups"></a>
+### Nested Schema for `shared_with_groups`
+
+Read-Only:
+
+- `expires_at` (String)
+- `group_access_level` (Number)
+- `group_full_path` (String)
+- `group_id` (Number)
+- `group_name` (String)

docs/data-sources/project.md

@@ -89,6 +89,7 @@ data "gitlab_project" "example" {
 - `restrict_user_defined_variables` (Boolean) Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
 - `runners_token` (String, Sensitive) Registration token to use during runner setup.
 - `security_and_compliance_access_level` (String) Set the security and compliance access level. Valid values are `disabled`, `private`, `enabled`.
+- `shared_with_groups` (List of Object) Describes groups which have access shared to this project. (see [below for nested schema](#nestedatt--shared_with_groups))
 - `snippets_access_level` (String) Set the snippets access level. Valid values are `disabled`, `private`, `enabled`.
 - `snippets_enabled` (Boolean) Enable snippets for the project.
 - `squash_commit_template` (String) Template used to create squash commit message in merge requests. (Introduced in GitLab 14.6.)
@@ -131,3 +132,14 @@ Read-Only:
 - `member_check` (Boolean)
 - `prevent_secrets` (Boolean)
 - `reject_unsigned_commits` (Boolean)
+
+
+<a id="nestedatt--shared_with_groups"></a>
+### Nested Schema for `shared_with_groups`
+
+Read-Only:
+
+- `group_access_level` (Number)
+- `group_full_path` (String)
+- `group_id` (Number)
+- `group_name` (String)

docs/data-sources/user.md

@@ -59,6 +59,7 @@ data "gitlab_user" "example-two" {
 - `external` (Boolean) Whether the user is external.
 - `id` (String) The ID of this resource.
 - `is_admin` (Boolean) Whether the user is an admin.
+- `is_bot` (Boolean) Whether the user is a bot.
 - `last_sign_in_at` (String) Last user's sign-in date.
 - `linkedin` (String) LinkedIn profile of the user.
 - `location` (String) The location of the user.

docs/data-sources/users.md

@@ -70,6 +70,7 @@ Read-Only:
 - `external` (Boolean)
 - `id` (Number)
 - `is_admin` (Boolean)
+- `is_bot` (Boolean)
 - `last_sign_in_at` (String)
 - `linkedin` (String)
 - `location` (String)

docs/resources/application_settings.md

@@ -88,10 +88,8 @@ resource "gitlab_application_settings" "this" {
 - `default_project_visibility` (String) What visibility level new projects receive. Can take private, internal and public as a parameter.
 - `default_projects_limit` (Number) Project limit per user.
 - `default_snippet_visibility` (String) What visibility level new snippets receive. Can take private, internal and public as a parameter.
-- `delayed_group_deletion` (Boolean) Enable delayed group deletion. Introduced in GitLab 15.0. From GitLab 15.1, disables and locks the group-level setting for delayed protect deletion when set to false.
-- `delayed_project_deletion` (Boolean) Enable delayed project deletion by default in new groups. From GitLab 15.1, can only be enabled when delayed_group_deletion is true.
 - `delete_inactive_projects` (Boolean) Enable inactive project deletion feature. Introduced in GitLab 14.10. Became operational in GitLab 15.0 (with feature flag inactive_projects_deletion).
-- `deletion_adjourned_period` (Number) The number of days to wait before deleting a project or group that is marked for deletion. Value must be between 1 and 90. From GitLab 15.1, a hook on deletion_adjourned_period sets the period to 1 on every update, and sets both delayed_project_deletion and delayed_group_deletion to false if the period is 0.
+- `deletion_adjourned_period` (Number) The number of days to wait before deleting a project or group that is marked for deletion. Value must be between 1 and 90.
 - `diff_max_files` (Number) Maximum files in a diff.
 - `diff_max_lines` (Number) Maximum lines in a diff.
 - `diff_max_patch_bytes` (Number) Maximum diff patch size, in bytes.
@@ -161,10 +159,13 @@ resource "gitlab_application_settings" "this" {
 - `help_text` (String) GitLab server administrator information.
 - `hide_third_party_offers` (Boolean) Do not display offers from third parties in GitLab.
 - `home_page_url` (String) Redirect to this URL when not logged in.
-- `housekeeping_enabled` (Boolean) (If enabled, requires: housekeeping_bitmaps_enabled, housekeeping_full_repack_period, housekeeping_gc_period, and housekeeping_incremental_repack_period) Enable or disable Git housekeeping.
-- `housekeeping_full_repack_period` (Number) Number of Git pushes after which an incremental git repack is run.
-- `housekeeping_gc_period` (Number) Number of Git pushes after which git gc is run.
-- `housekeeping_incremental_repack_period` (Number) Number of Git pushes after which an incremental git repack is run.
+- `housekeeping_enabled` (Boolean) Enable or disable Git housekeeping.
+				If enabled, requires either housekeeping_optimize_repository_period OR housekeeping_bitmaps_enabled, housekeeping_full_repack_period, housekeeping_gc_period, and housekeeping_incremental_repack_period.
+				Options housekeeping_bitmaps_enabled, housekeeping_full_repack_period, housekeeping_gc_period, and housekeeping_incremental_repack_period are deprecated. Use housekeeping_optimize_repository_period instead.
+- `housekeeping_full_repack_period` (Number, Deprecated) Number of Git pushes after which an incremental git repack is run.
+- `housekeeping_gc_period` (Number, Deprecated) Number of Git pushes after which git gc is run.
+- `housekeeping_incremental_repack_period` (Number, Deprecated) Number of Git pushes after which an incremental git repack is run.
+- `housekeeping_optimize_repository_period` (Number) Number of Git pushes after which an incremental git repack is run.
 - `html_emails_enabled` (Boolean) Enable HTML emails.
 - `import_sources` (List of String) Sources to allow project import from. Valid values are: `github`, `bitbucket`, `bitbucket_server`, `fogbugz`, `git`, `gitlab_project`, `gitea`, `manifest`
 - `in_product_marketing_emails_enabled` (Boolean) Enable in-product marketing emails.

docs/resources/global_level_notifications.md

@@ -0,0 +1,68 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_global_level_notifications Resource - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  The gitlab_global_level_notifications resource allows to manage global notifications.
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/notification_settings.html#group--project-level-notification-settings
+---
+
+# gitlab_global_level_notifications (Resource)
+
+The `gitlab_global_level_notifications` resource allows to manage global notifications.
+		
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/notification_settings.html#group--project-level-notification-settings)
+
+## Example Usage
+
+```terraform
+resource "gitlab_global_level_notifications" "foo" {
+  level = "watch"
+}
+
+# Create Custom global level notification
+resource "gitlab_global_level_notifications" "foo" {
+  level             = "custom"
+  new_merge_request = true
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `close_issue` (Boolean) Enable notifications for closed issues. Can only be used when `level` is `custom`.
+- `close_merge_request` (Boolean) Enable notifications for closed merge requests. Can only be used when `level` is `custom`.
+- `failed_pipeline` (Boolean) Enable notifications for failed pipelines. Can only be used when `level` is `custom`.
+- `fixed_pipeline` (Boolean) Enable notifications for fixed pipelines. Can only be used when `level` is `custom`.
+- `issue_due` (Boolean) Enable notifications for due issues. Can only be used when `level` is `custom`.
+- `level` (String) The level of the notification. Valid values are: `disabled`, `participating`, `watch`, `global`, `mention`, `custom`.
+- `merge_merge_request` (Boolean) Enable notifications for merged merge requests. Can only be used when `level` is `custom`.
+- `merge_when_pipeline_succeeds` (Boolean) Enable notifications for merged merge requests when the pipeline succeeds. Can only be used when `level` is `custom`.
+- `moved_project` (Boolean) Enable notifications for moved projects. Can only be used when `level` is `custom`.
+- `new_issue` (Boolean) Enable notifications for new issues. Can only be used when `level` is `custom`.
+- `new_merge_request` (Boolean) Enable notifications for new merge requests. Can only be used when `level` is `custom`.
+- `new_note` (Boolean) Enable notifications for new notes on merge requests. Can only be used when `level` is `custom`.
+- `push_to_merge_request` (Boolean) Enable notifications for push to merge request branches. Can only be used when `level` is `custom`.
+- `reassign_issue` (Boolean) Enable notifications for issue reassignments. Can only be used when `level` is `custom`.
+- `reassign_merge_request` (Boolean) Enable notifications for merge request reassignments. Can only be used when `level` is `custom`.
+- `reopen_issue` (Boolean) Enable notifications for reopened issues. Can only be used when `level` is `custom`.
+- `reopen_merge_request` (Boolean) Enable notifications for reopened merge requests. Can only be used when `level` is `custom`.
+- `success_pipeline` (Boolean) Enable notifications for successful pipelines. Can only be used when `level` is `custom`.
+
+### Read-Only
+
+- `id` (String) The ID of the resource.This is a static value named gitlab
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+# Note: You can import a global notification state using "gitlab" as the ID.
+# The ID will always be gitlab, because the global notificatio only exists
+# once per user
+
+terraform import gitlab_global_level_notifications.example gitlab
+```

docs/resources/project.md

@@ -223,6 +223,7 @@ This attribute is only used during resource creation, thus changes are suppresse
 - `tags` (Set of String) The list of tags for a project; put array of tags, that should be finally assigned to a project. Use topics instead.
 - `template_name` (String) When used without use_custom_template, name of a built-in project template. When used with use_custom_template, name of a custom project template. This option is mutually exclusive with `template_project_id`.
 - `template_project_id` (Number) When used with use_custom_template, project ID of a custom project template. This is preferable to using template_name since template_name may be ambiguous (enterprise edition). This option is mutually exclusive with `template_name`. See `gitlab_group_project_file_template` to set a project as a template project. If a project has not been set as a template, using it here will result in an error.
+- `timeouts` (Block, Optional) (see [below for nested schema](#nestedblock--timeouts))
 - `topics` (Set of String) The list of topics for the project.
 - `use_custom_template` (Boolean) Use either custom instance or group (with group_with_project_templates_id) project template (enterprise edition).
 		~> When using a custom template, [Group Tokens won't work](https://docs.gitlab.com/15.7/ee/user/project/settings/import_export_troubleshooting.html#import-using-the-rest-api-fails-when-using-a-group-access-token). You must use a real user's Personal Access Token.
@@ -276,6 +277,15 @@ Optional:
 - `prevent_secrets` (Boolean) GitLab will reject any files that are likely to contain secrets.
 - `reject_unsigned_commits` (Boolean) Reject commit when it’s not signed through GPG.
 
+
+<a id="nestedblock--timeouts"></a>
+### Nested Schema for `timeouts`
+
+Optional:
+
+- `create` (String)
+- `delete` (String)
+
 ## Import
 
 Import is supported using the following syntax:

docs/resources/project_hook.md

@@ -29,7 +29,7 @@ resource "gitlab_project_hook" "example" {
 ### Required
 
 - `project` (String) The name or id of the project to add the hook to.
-- `url` (String) The url of the hook to invoke.
+- `url` (String) The url of the hook to invoke. Forces re-creation to preserve `token`.
 
 ### Optional