github.com/lymingtonprecision/terraform@v0.9.9-0.20170613092852-62acef9611a9/website/source/docs/providers/gitlab/r/project.html.markdown (about)

     1  ---
     2  layout: "gitlab"
     3  page_title: "GitLab: gitlab_project"
     4  sidebar_current: "docs-gitlab-resource-project-x"
     5  description: |-
     6    Creates and manages projects within GitLab groups or within your user
     7  ---
     8  
     9  # gitlab\_project
    10  
    11  This resource allows you to create and manage projects within your
    12  GitLab group or within your user.
    13  
    14  
    15  ## Example Usage
    16  
    17  ```hcl
    18  resource "gitlab_project" "example" {
    19    name        = "example"
    20    description = "My awesome codebase"
    21  
    22    visibility_level = "public"
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `name` - (Required) The name of the project.
    31  
    32  * `namespace_id` - (Optional) The namespace (group or user) of the project. Defaults to your user.
    33    See [`gitlab_group`](group.html) for an example.
    34  
    35  * `description` - (Optional) A description of the project.
    36  
    37  * `default_branch` - (Optional) The default branch for the project.
    38  
    39  * `issues_enabled` - (Optional) Enable issue tracking for the project.
    40  
    41  * `merge_requests_enabled` - (Optional) Enable merge requests for the project.
    42  
    43  * `wiki_enabled` - (Optional) Enable wiki for the project.
    44  
    45  * `snippets_enabled` - (Optional) Enable snippets for the project.
    46  
    47  * `visibility_level` - (Optional) Set to `public` to create a public project.
    48    Valid values are `private`, `internal`, `public`.
    49    Repositories are created as private by default.
    50  
    51  ## Attributes Reference
    52  
    53  The following additional attributes are exported:
    54  
    55  * `id` - Integer that uniquely identifies the project within the gitlab install.
    56  
    57  * `ssh_url_to_repo` - URL that can be provided to `git clone` to clone the
    58    repository via SSH.
    59  
    60  * `http_url_to_repo` - URL that can be provided to `git clone` to clone the
    61    repository via HTTP.
    62  
    63  * `web_url` - URL that can be used to find the project in a browser.