» 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.

• path - (Optional) The path of the repository.

• 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.

• tags - (Optional) Tags (topics) 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.

• approvals_before_merge - (Optional) Number of merge request approvals required for merging. Default is 0.

• 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.

• merge_method - (Optional) Set to ff to create fast-forward merges Valid values are merge, rebase_merge, ff Repositories are created with merge by default

• only_allow_merge_if_pipeline_succeeds - (Optional) Set to true if you want allow merges only if a pipeline succeeds.

• only_allow_merge_if_all_discussions_are_resolved - (Optional) Set to true if you want allow merges only if all discussions are resolved.

• shared_with_groups - (Optional) Enable sharing the project with a list of groups (maps).

  • group_id - (Required) Group id of the group you want to share the project with.
  • group_access_level - (Optional) Group's sharing permissions. See group members permission for more info. Valid values are guest, reporter, developer, master.

» 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.

• runners_token - Registration token to use during runner setup.

• shared_with_groups - List of the groups the project is shared with.

  • group_name - Group's name.

» Importing projects

You can import a project state using terraform import <resource> <id>. The id can be whatever the get single project api takes for its :id value, so for example:

terraform import gitlab_project.example richardc/example