Files
opentf/website/source/docs/providers/gitlab/r/group.html.markdown
Richard Clamp 9e90e77be4 provider/gitlab: Add gitlab_group resource (#14490)
* vendor: Update go-gitlab to master@e6c11e

Update go-gitlab to master@e6c11e.  This brings in UpdateGroup in
addition to fuller management of other attributes.

* provider/gitlab:  Add `gitlab_group` resource

This adds a gitlab_group resource.

This combined with #14483 will allow you to create projects in a
group.
2017-05-24 13:01:24 +01:00

1.5 KiB

layout: "gitlab" page_title: "GitLab: gitlab_group" sidebar_current: "docs-gitlab-resource-group" description: |- Creates and manages GitLab groups

gitlab_group

This resource allows you to create and manage GitLab groups. Note your provider will need to be configured with admin-level access for this resource to work.

Example Usage

resource "gitlab_group" "example" {
  name        = "example"
  path        = "example"
  description = "An example group"
}

// Create a project in the example group
resource "gitlab_project" "example" {
  name         = "example"
  description  = "An example project"
  namespace_id = "${gitlab_group.example.id}"
}

Argument Reference

The following arguments are supported:

  • name - (Required) The name of this group.

  • path - (Required) The url of the hook to invoke.

  • description - (Optional) The description of the group.

  • lfs_enabled - (Optional) Boolean, defaults to true. Whether to enable LFS support for projects in this group.

  • request_access_enabled - (Optional) Boolean, defaults to false. Whether to enable users to request access to the group.

  • visibility_level - (Optional) Set to public to create a public group. Valid values are private, internal, public. Groups are created as private by default.

Attributes Reference

The resource exports the following attributes:

  • id - The unique id assigned to the group by the GitLab server. Serves as a namespace id where one is needed.