opentf/website/source/docs/providers/gitlab/r/project.html.markdown

layout, page_title, sidebar_current, description

layout	page_title	sidebar_current	description
gitlab	GitLab: gitlab_project	docs-gitlab-resource-project-x	Creates and manages projects within GitLab groups or within your user

gitlab_project

This resource allows you to create and manage projects within your GitLab group or within your user.

Example Usage

resource "gitlab_project" "example" {
  name        = "example"
  description = "My awesome codebase"

  visibility_level = "public"
}

Argument Reference

The following arguments are supported:

• name - (Required) The name of the project.

• namespace_id - (Optional) The namespace (group or user) of the project. Defaults to your user. See gitlab_group for an example.

• description - (Optional) A description of the project.

• default_branch - (Optional) The default branch for the project.

• issues_enabled - (Optional) Enable issue tracking for the project.

• merge_requests_enabled - (Optional) Enable merge requests for the project.

• wiki_enabled - (Optional) Enable wiki for the project.

• snippets_enabled - (Optional) Enable snippets for the project.

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

Attributes Reference

The following additional attributes are exported:

• id - Integer that uniquely identifies the project within the gitlab install.

• ssh_url_to_repo - URL that can be provided to git clone to clone the repository via SSH.

• http_url_to_repo - URL that can be provided to git clone to clone the repository via HTTP.

• web_url - URL that can be used to find the project in a browser.