Update docs for v17.6.0 release

Author: gitlab-terraform-provider-bot

CHANGELOG.md

@@ -0,0 +1,57 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_group_billable_member_memberships Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  The gitlab_group_billable_member_memberships data source allows (sub)group- and project-memberships of a billable member of a group to be retrieved by either the user ID, username or email address.
+  -> You must be an administrator!
+  ~> When using the email attribute, an exact match is not guaranteed. The most related match will be returned. Starting with GitLab 16.6,
+  the most related match will prioritize an exact match if one is available.
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/members.html#list-memberships-for-a-billable-member-of-a-group
+---
+
+# gitlab_group_billable_member_memberships (Data Source)
+
+The `gitlab_group_billable_member_memberships` data source allows (sub)group- and project-memberships of a billable member of a group to be retrieved by either the user ID, username or email address.
+
+-> You must be an administrator!
+
+~> When using the `email` attribute, an exact match is not guaranteed. The most related match will be returned. Starting with GitLab 16.6,
+the most related match will prioritize an exact match if one is available.
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/members.html#list-memberships-for-a-billable-member-of-a-group)
+
+## Example Usage
+
+```terraform
+data "gitlab_group_billable_member_memberships" "test_user_membership" {
+  user_id  = 21
+  group_id = 42
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `group_id` (String) The ID of the group.
+- `user_id` (Number) The ID of the user.
+
+### Read-Only
+
+- `id` (String) The id of the data source. It will always be equal to the user_id
+- `memberships` (Attributes List) group- and/or project-memberships of the user. (see [below for nested schema](#nestedatt--memberships))
+
+<a id="nestedatt--memberships"></a>
+### Nested Schema for `memberships`
+
+Read-Only:
+
+- `access_level` (String) Access-level of the member. For details see: https://docs.gitlab.com/ee/api/access_requests.html#valid-access-levels
+- `created_at` (String) Datetime when the membership was first added.
+- `expires_at` (String) Date when the membership will end.
+- `id` (Number) The id of the membership.
+- `source_full_name` (String) Breadcrumb-style, full display-name of the group or project.
+- `source_id` (Number) The id of the group or project, the user is a (direct) member of.
+- `source_members_url` (String) URL to the members-page of the group or project.

docs/data-sources/group_billable_member_memberships.md

@@ -54,6 +54,7 @@ output "subgroups" {
 
 Read-Only:
 
+- `allowed_email_domains_list` (String)
 - `auto_devops_enabled` (Boolean)
 - `avatar_url` (String)
 - `created_at` (String)

docs/data-sources/group_subgroups.md

@@ -36,5 +36,6 @@ data "gitlab_metadata" "this" {}
 Read-Only:
 
 - `enabled` (Boolean) Indicates whether KAS is enabled.
+- `external_k8s_proxy_url` (String) URL used by the Kubernetes tooling to communicate with the KAS Kubernetes API proxy. It’s null if kas.enabled is false.
 - `external_url` (String) URL used by the agents to communicate with KAS. It’s null if kas.enabled is false.
 - `version` (String) Version of KAS. It’s null if kas.enabled is false.

docs/data-sources/metadata.md

@@ -50,6 +50,7 @@ data "gitlab_project" "example" {
 - `build_timeout` (Number) The maximum amount of time, in seconds, that a job can run.
 - `builds_access_level` (String) Set the builds access level. Valid values are `disabled`, `private`, `enabled`.
 - `ci_config_path` (String) CI config file path for the project.
+- `ci_pipeline_variables_minimum_override_role` (String) The minimum role required to set variables when running pipelines and jobs. Introduced in GitLab 17.1. Valid values are `developer`, `maintainer`, `owner`, `no_one_allowed`
 - `ci_restrict_pipeline_cancellation_role` (String) The role required to cancel a pipeline or job. Introduced in GitLab 16.8. Premium and Ultimate only. Valid values are `developer`, `maintainer`, `no one`
 - `ci_separated_caches` (Boolean) Use separate caches for protected branches.
 - `container_expiration_policy` (List of Object) Set the image cleanup policy for this project. **Note**: this field is sometimes named `container_expiration_policy_attributes` in the GitLab Upstream API. (see [below for nested schema](#nestedatt--container_expiration_policy))

docs/data-sources/project.md

@@ -0,0 +1,63 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_project_environments Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  The gitlab_project_environments data source retrieves information about all environments of the given project.
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/environments.html#list-environments
+---
+
+# gitlab_project_environments (Data Source)
+
+The `gitlab_project_environments` data source retrieves information about all environments of the given project.
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/environments.html#list-environments)
+
+## Example Usage
+
+```terraform
+resource "gitlab_project" "this" {
+  name                   = "example"
+  initialize_with_readme = true
+}
+
+data "gitlab_project_environments" "this" {
+  project = gitlab_project.this.path_with_namespace # Can also use project id
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `project` (String) The ID or full path of the project.
+
+### Optional
+
+- `name` (String) Return the environment with this name. Mutually exclusive with search.
+- `search` (String) Return list of environments matching the search criteria. Mutually exclusive with name. Must be at least 3 characters long.
+- `states` (String) List all environments that match the specified state. Valid values are `available`, `stopping`, `stopped`. Returns all environments if not set.
+
+### Read-Only
+
+- `environments` (Attributes List) The list of environments. (see [below for nested schema](#nestedatt--environments))
+- `id` (String) The ID of this Terraform resource.
+
+<a id="nestedatt--environments"></a>
+### Nested Schema for `environments`
+
+Read-Only:
+
+- `cluster_agent_id` (Number) The ID of the environments cluster agent or `null` if none is assigned.
+- `created_at` (String) Timestamp of the environment creation, RFC3339 format.
+- `description` (String) The description of the environment.
+- `external_url` (String) Place to link to for this environment.
+- `flux_resource_path` (String) The Flux resource path to associate with this environment.
+- `id` (Number) The ID of the environment.
+- `kubernetes_namespace` (String) The Kubernetes namespace to associate with this environment.
+- `name` (String) The name of the environment.
+- `slug` (String) The simplified version of the environment name, suitable for inclusion in DNS, URLs, Kubernetes labels, and so on. The slug is truncated to 24 characters. A random suffix is automatically added to uppercase environment names.
+- `state` (String) The state of the environment. Value can be one of `available`, `stopping`, `stopped`. Returns all environments if not set.
+- `tier` (String) The tier of the environment. Value can be one of `production`, `staging`, `testing`, `development`, `other`. Returns all environments if not set.
+- `updated_at` (String) Timestamp of the last environment update, RFC3339 format.

docs/data-sources/project_environments.md

@@ -65,8 +65,9 @@ Read-Only:
 
 Optional:
 
-- `group_id` (Number) The ID of a GitLab group allowed to perform the relevant action. Mutually exclusive with `user_id`.
-- `user_id` (Number) The ID of a GitLab user allowed to perform the relevant action. Mutually exclusive with `group_id`.
+- `deploy_key_id` (Number) The ID of a GitLab deploy key allowed to perform the relevant action. Mutually exclusive with `group_id` and `user_id`. This field is read-only until Gitlab 17.5.
+- `group_id` (Number) The ID of a GitLab group allowed to perform the relevant action. Mutually exclusive with `deploy_key_id` and `user_id`.
+- `user_id` (Number) The ID of a GitLab user allowed to perform the relevant action. Mutually exclusive with `deploy_key_id` and `group_id`.
 
 Read-Only:
 

docs/data-sources/project_protected_branch.md

@@ -74,8 +74,9 @@ Read-Only:
 
 Optional:
 
-- `group_id` (Number) The ID of a GitLab group allowed to perform the relevant action. Mutually exclusive with `user_id`.
-- `user_id` (Number) The ID of a GitLab user allowed to perform the relevant action. Mutually exclusive with `group_id`.
+- `deploy_key_id` (Number) The ID of a GitLab deploy key allowed to perform the relevant action. Mutually exclusive with `group_id` and `user_id`. This field is read-only until Gitlab 17.5.
+- `group_id` (Number) The ID of a GitLab group allowed to perform the relevant action. Mutually exclusive with `deploy_key_id` and `user_id`.
+- `user_id` (Number) The ID of a GitLab user allowed to perform the relevant action. Mutually exclusive with `deploy_key_id` and `group_id`.
 
 Read-Only:
 

docs/data-sources/project_protected_branches.md

@@ -97,6 +97,7 @@ Read-Only:
 - `ci_config_path` (String)
 - `ci_default_git_depth` (Number)
 - `ci_forward_deployment_enabled` (Boolean)
+- `ci_pipeline_variables_minimum_override_role` (String)
 - `ci_restrict_pipeline_cancellation_role` (String)
 - `container_expiration_policy` (List of Object) (see [below for nested schema](#nestedobjatt--projects--container_expiration_policy))
 - `container_registry_access_level` (String)

docs/data-sources/projects.md

@@ -0,0 +1,58 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitlab_runners Data Source - terraform-provider-gitlab"
+subcategory: ""
+description: |-
+  The gitlab_runners data source retrieves information about all gitlab runners.
+  Upstream API: GitLab REST API docs https://docs.gitlab.com/ee/api/runners.html#list-all-runners
+---
+
+# gitlab_runners (Data Source)
+
+The `gitlab_runners` data source retrieves information about all gitlab runners.
+
+**Upstream API**: [GitLab REST API docs](https://docs.gitlab.com/ee/api/runners.html#list-all-runners)
+
+## Example Usage
+
+```terraform
+resource "gitlab_user_runner" "this" {
+  runner_type = "instance_type"
+  tag_list    = ["tag1", "tag2"]
+}
+
+data "gitlab_runners" "this" {
+  paused   = false
+  status   = "online"
+  tag_list = ["tag1", "tag2"]
+  type     = "instance_type"
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Optional
+
+- `paused` (Boolean) Filters for runners with the given paused value
+- `status` (String) Filters for runners with the given status. Valid Values are `online`, `offline`, `stale`, and `never_contacted`.
+- `tag_list` (Set of String) Filters for runners with all of the given tags
+- `type` (String) The type of runner to return. Valid values are `instance_type`, `group_type` and `project_type`
+
+### Read-Only
+
+- `id` (String) The ID of this Terraform resource.
+- `runners` (Attributes List) The list of runners. (see [below for nested schema](#nestedatt--runners))
+
+<a id="nestedatt--runners"></a>
+### Nested Schema for `runners`
+
+Read-Only:
+
+- `description` (String) The description of the runner.
+- `id` (Number) The runner id.
+- `is_shared` (Boolean) Indicates if this is a shared runner
+- `online` (Boolean) The connectivity status of the runner.
+- `paused` (Boolean) Indicates if the runner is accepting or ignoring new jobs.
+- `runner_type` (String) The runner type. Values are `instance_type`, `group_type` and `project_type`.
+- `status` (String) The status of the runner. Values can be `online`, `offline`, `stale`, and `never_contacted`.