Update docs for v15.10.0 release

Author: gitlab-terraform-provider-bot

CHANGELOG.md

@@ -1,3 +1,42 @@
+## 15.10.0 (2023-03-22)
+
+This release was tested against GitLab 15.8, 15.9 and 15.10 for both CE and EE.
+
+FEATURES:
+
+- **New Resource:** `gitlab_application` ([#1436](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1436))
+- **New Resource:** `gitlab_service_custom_issue_tracker` ([#1459](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1459))
+
+IMPROVEMENTS:
+
+- resource/gitlab_personal_access_token: Support `admin_mode` as value in the `scopes` attribute ([#1456](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1456))
+- resource/gitlab_group: Remove explicit attribute defaults. This solves an issue where newly imported resources may have plan changes for default attributes. In some cases, the new API-based default values are more permissive than the old provider-based defaults. See The linked MR for details. ([#1479](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1479))
+- resource/gitlab_repository_file: Add validator to avoid leading `/` and `./` in path ([#1472](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1472))
+- resource/gitlab_project: Deprecate the `name_regex_delete` in favor of the `name_regex` attribute ([#1466](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1466))
+- resource/gitlab_project: Support `environments_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- resource/gitlab_project: Support `feature_flags_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- resource/gitlab_project: Support `infrastructure_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- resource/gitlab_project: Support `monitor_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- resource/gitlab_project: Support `release_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_project: Mark `runners_token` as sensitive ([#1461](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1461))
+- datasource/gitlab_project: Support `environments_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_project: Support `feature_flags_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_project: Support `infrastructure_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_project: Support `monitor_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_project: Support `release_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_projects: Support `environments_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_projects: Support `feature_flags_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_projects: Support `infrastructure_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_projects: Support `monitor_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+- datasource/gitlab_projects: Support `release_access_level` attribute ([#1469](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1469))
+
+BUG FIXES:
+
+- resource/gitlab_project: Add validator to the `id` attribute to prevent misuse ([#1476](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1476))
+- resource/gitlab_group: Wait for the group to be fully created and functional ([#1465](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1465))
+- resource/gitlab_service_slack: Fix perpetual diff in `webhook` attribute due to upstream API deprecation ([#1470](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1470))
+- resource/gitlab_service_microsoft_teams: Fix perpetual diff in `webhook` attribute due to upstream API deprecation ([#1470](https://gitlab.com/gitlab-org/terraform-provider-gitlab/-/merge_requests/1470))
+
 ## 15.9.0 (2023-02-22)
 
 This release was tested against GitLab 15.7, 15.8 and 15.9 for both CE and EE.

docs/data-sources/application.md

@@ -0,0 +1,38 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_application Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  The gitlab_application data source retrieves information about a gitlab application.
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/applications.html
+---
+
+# gitlab_application (Data Source)
+
+The `gitlab_application` data source retrieves information about a gitlab application.
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/applications.html)
+
+## Example Usage
+
+```terraform
+data "gitlab_application" "oidc" {
+  application_id = 1
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `id` (String) The ID of this Terraform resource. In the format of `<application_id>`.
+
+### Read-Only
+
+- `application_id` (String) Internal GitLab application id.
+- `confidential` (Boolean) Indicates if the application is kept confidential.
+- `name` (String) The name of the GitLab application.
+- `redirect_url` (String) The redirect url of the application.
+
+

docs/data-sources/project.md

@@ -16,12 +16,14 @@ The `gitlab_project` data source allows details of a project to be retrieved by
 ## Example Usage
 
 ```terraform
+# To search for a project by ID, pass in the ID value
 data "gitlab_project" "example" {
   id = 30
 }
 
+# To search for a project based on a path, use `path_with_namespace` instead
 data "gitlab_project" "example" {
-  id = "foo/bar/baz"
+  path_with_namespace = "foo/bar/baz"
 }
 ```
 
@@ -31,7 +33,7 @@ data "gitlab_project" "example" {
 ### Optional
 
 - `ci_default_git_depth` (Number) Default number of revisions for shallow cloning.
-- `id` (String) The integer or path with namespace that uniquely identifies the project within the gitlab install.
+- `id` (String) The integer that uniquely identifies the project within the gitlab install.
 - `path_with_namespace` (String) The path of the repository with namespace.
 - `public_builds` (Boolean) If true, jobs can be viewed by non-project members.
 
@@ -53,10 +55,13 @@ data "gitlab_project" "example" {
 - `default_branch` (String) The default branch for the project.
 - `description` (String) A description of the project.
 - `emails_disabled` (Boolean) Disable email notifications.
+- `environments_access_level` (String) Set the environments access level. Valid values are `disabled`, `private`, `enabled`.
 - `external_authorization_classification_label` (String) The classification label for the project.
+- `feature_flags_access_level` (String) Set the feature flags access level. Valid values are `disabled`, `private`, `enabled`.
 - `forking_access_level` (String) Set the forking access level. Valid values are `disabled`, `private`, `enabled`.
 - `http_url_to_repo` (String) URL that can be provided to `git clone` to clone the
 - `import_url` (String) URL the project was imported from.
+- `infrastructure_access_level` (String) Set the infrastructure access level. Valid values are `disabled`, `private`, `enabled`.
 - `issues_access_level` (String) Set the issues access level. Valid values are `disabled`, `private`, `enabled`.
 - `issues_enabled` (Boolean) Enable issue tracking for the project.
 - `lfs_enabled` (Boolean) Enable LFS for the project.
@@ -65,21 +70,23 @@ 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.
+- `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.
 - `operations_access_level` (String) Set the operations access level. Valid values are `disabled`, `private`, `enabled`.
 - `path` (String) The path of the repository.
 - `pipelines_enabled` (Boolean) Enable pipelines for the project.
 - `printing_merge_request_link_enabled` (Boolean) Show link to create/view merge request when pushing from the command line
 - `push_rules` (List of Object) Push rules for the project. Push rules are only available on Enterprise plans and if the authenticated has permissions to read them. (see [below for nested schema](#nestedatt--push_rules))
+- `releases_access_level` (String) Set the releases access level. Valid values are `disabled`, `private`, `enabled`.
 - `remove_source_branch_after_merge` (Boolean) Enable `Delete source branch` option by default for all new merge requests
 - `repository_access_level` (String) Set the repository access level. Valid values are `disabled`, `private`, `enabled`.
 - `repository_storage` (String) Which storage shard the repository is on. (administrator only)
 - `request_access_enabled` (Boolean) Allow users to request member access.
 - `requirements_access_level` (String) Set the requirements access level. Valid values are `disabled`, `private`, `enabled`.
 - `resolve_outdated_diff_discussions` (Boolean) Automatically resolve merge request diffs discussions on lines changed with a push.
 - `restrict_user_defined_variables` (Boolean) Allow only users with the Maintainer role to pass user-defined variables when triggering a pipeline.
-- `runners_token` (String) Registration token to use during runner setup.
+- `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`.
 - `snippets_access_level` (String) Set the snippets access level. Valid values are `disabled`, `private`, `enabled`.
 - `snippets_enabled` (Boolean) Enable snippets for the project.
@@ -100,6 +107,7 @@ Read-Only:
 - `cadence` (String)
 - `enabled` (Boolean)
 - `keep_n` (Number)
+- `name_regex` (String)
 - `name_regex_delete` (String)
 - `name_regex_keep` (String)
 - `next_run_at` (String)

docs/data-sources/projects.md

@@ -104,7 +104,9 @@ Read-Only:
 - `default_branch` (String)
 - `description` (String)
 - `emails_disabled` (Boolean)
+- `environments_access_level` (String)
 - `external_authorization_classification_label` (String)
+- `feature_flags_access_level` (String)
 - `forked_from_project` (List of Object) (see [below for nested schema](#nestedobjatt--projects--forked_from_project))
 - `forking_access_level` (String)
 - `forks_count` (Number)
@@ -113,6 +115,7 @@ Read-Only:
 - `import_error` (String)
 - `import_status` (String)
 - `import_url` (String)
+- `infrastructure_access_level` (String)
 - `issues_access_level` (String)
 - `issues_enabled` (Boolean)
 - `jobs_enabled` (Boolean)
@@ -128,6 +131,7 @@ Read-Only:
 - `mirror_overwrites_diverged_branches` (Boolean)
 - `mirror_trigger_builds` (Boolean)
 - `mirror_user_id` (Number)
+- `monitor_access_level` (String)
 - `name` (String)
 - `name_with_namespace` (String)
 - `namespace` (List of Object) (see [below for nested schema](#nestedobjatt--projects--namespace))
@@ -144,6 +148,7 @@ Read-Only:
 - `public` (Boolean)
 - `public_builds` (Boolean)
 - `readme_url` (String)
+- `releases_access_level` (String)
 - `repository_access_level` (String)
 - `repository_storage` (String)
 - `request_access_enabled` (Boolean)
@@ -176,6 +181,7 @@ Read-Only:
 - `cadence` (String)
 - `enabled` (Boolean)
 - `keep_n` (Number)
+- `name_regex` (String)
 - `name_regex_delete` (String)
 - `name_regex_keep` (String)
 - `next_run_at` (String)

docs/data-sources/repository_file.md

@@ -28,7 +28,7 @@ data "gitlab_repository_file" "example" {
 
 ### Required
 
-- `file_path` (String) The full path of the file. It must be relative to the root of the project without a leading slash `/`.
+- `file_path` (String) The full path of the file. It must be relative to the root of the project without a leading slash `/` or `./`.
 - `project` (String) The name or ID of the project.
 - `ref` (String) The name of branch, tag or commit.
 

docs/resources/application.md

@@ -0,0 +1,61 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_application Resource - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  The gitlab_application resource allows to manage the lifecycle of applications in gitlab.
+  ~> In order to use a user for a user to create an application, they must have admin priviledges at the instance level.
+  To create an OIDC application, a scope of "openid".
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/applications.html
+---
+
+# gitlab_application (Resource)
+
+The `gitlab_application` resource allows to manage the lifecycle of applications in gitlab.
+
+~> In order to use a user for a user to create an application, they must have admin priviledges at the instance level.
+To create an OIDC application, a scope of "openid".
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/applications.html)
+
+## Example Usage
+
+```terraform
+resource "gitlab_application" "oidc" {
+  confidential = true
+  scopes       = ["openid"]
+  name         = "company_oidc"
+  redirect_url = "https://mycompany.com"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) Name of the application.
+- `redirect_url` (String) The URL gitlab should send the user to after authentication.
+- `scopes` (Set of String) Scopes of the application. Use "openid" if you plan to use this as an oidc authentication application. Valid options are: `api`, `read_api`, `read_user`, `read_repository`, `write_repository`, `read_registry`, `write_registry`, `sudo`, `admin_mode`, `openid`, `profile`, `email`.
+This is only populated when creating a new application. This attribute is not available for imported resources
+
+### Optional
+
+- `confidential` (Boolean) The application is used where the client secret can be kept confidential. Native mobile apps and Single Page Apps are considered non-confidential. Defaults to true if not supplied
+
+### Read-Only
+
+- `application_id` (String) Internal name of the application.
+- `id` (String) The ID of this Terraform resource. In the format of `<application_id>`.
+- `secret` (String, Sensitive) Application secret. Sensative and must be kept secret. This is only populated when creating a new application. This attribute is not available for imported resources.
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+# Gitlab applications can be imported with their id, e.g.
+terraform import gitlab_application.example "1"
+
+# NOTE: the secret and scopes cannot be imported
+```

docs/resources/branch.md

@@ -73,6 +73,6 @@ Read-Only:
 Import is supported using the following syntax:
 
 ```shell
-# Gitlab protected branches can be imported with a key composed of `<project_id>:<branch_name>`, e.g.
+# Gitlab branches can be imported with a key composed of `<project_id>:<branch_name>`, e.g.
 terraform import gitlab_branch.example "12345:develop"
 ```

docs/resources/personal_access_token.md

@@ -40,7 +40,7 @@ resource "gitlab_project_variable" "example" {
 ### Required
 
 - `name` (String) The name of the personal access token.
-- `scopes` (Set of String) The scope for the personal access token. It determines the actions which can be performed when authenticating with this token. Valid values are: `api`, `read_user`, `read_api`, `read_repository`, `write_repository`, `read_registry`, `write_registry`, `sudo`.
+- `scopes` (Set of String) The scope for the personal access token. It determines the actions which can be performed when authenticating with this token. Valid values are: `api`, `read_user`, `read_api`, `read_repository`, `write_repository`, `read_registry`, `write_registry`, `sudo`, `admin_mode`.
 - `user_id` (Number) The id of the user.
 
 ### Optional