8e25c23c84
* provider/gitlab: Fix documentation copypasta The original provider and docs were copied from the github provider, one bit of copy paste slipped unmissed. * provider/gitlab: Document `gitlab_project#id` * provider/gitlab: Document `gitlab_project#namespace_id` * provider/gitlab: Add fuller demonstration to the provider page Following in the style of other provider pages, add a worked example showing off all of the available resources offered by the gitlab provider. * provider/gitlab: Correct sample for gitlab_project
1.7 KiB
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 |
gitlab_project
This resource allows you to create and manage projects within your GitLab organization.
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. -
description- (Optional) A description of the project. -
namespace_id- (Optional) The namespace to create this project in. Seegitlab_groupfor an example. -
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 topublicto create a public project. Valid values areprivate,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 togit cloneto clone the repository via SSH. -
http_url_to_repo- URL that can be provided togit cloneto clone the repository via HTTP. -
web_url- URL that can be used to find the project in a browser.