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.