github.com/bradfeehan/terraform@v0.7.0-rc3.0.20170529055808-34b45c5ad841/website/source/docs/providers/gitlab/r/group.html.markdown (about) 1 --- 2 layout: "gitlab" 3 page_title: "GitLab: gitlab_group" 4 sidebar_current: "docs-gitlab-resource-group" 5 description: |- 6 Creates and manages GitLab groups 7 --- 8 9 # gitlab\_group 10 11 This resource allows you to create and manage GitLab groups. 12 Note your provider will need to be configured with admin-level access for this resource to work. 13 14 ## Example Usage 15 16 ```hcl 17 resource "gitlab_group" "example" { 18 name = "example" 19 path = "example" 20 description = "An example group" 21 } 22 23 // Create a project in the example group 24 resource "gitlab_project" "example" { 25 name = "example" 26 description = "An example project" 27 namespace_id = "${gitlab_group.example.id}" 28 } 29 ``` 30 31 ## Argument Reference 32 33 The following arguments are supported: 34 35 * `name` - (Required) The name of this group. 36 37 * `path` - (Required) The url of the hook to invoke. 38 39 * `description` - (Optional) The description of the group. 40 41 * `lfs_enabled` - (Optional) Boolean, defaults to true. Whether to enable LFS 42 support for projects in this group. 43 44 * `request_access_enabled` - (Optional) Boolean, defaults to false. Whether to 45 enable users to request access to the group. 46 47 * `visibility_level` - (Optional) Set to `public` to create a public group. 48 Valid values are `private`, `internal`, `public`. 49 Groups are created as private by default. 50 51 ## Attributes Reference 52 53 The resource exports the following attributes: 54 55 * `id` - The unique id assigned to the group by the GitLab server. Serves as a 56 namespace id where one is needed.