Skip to content

project.html.markdown

Latest commit

 

History

History
95 lines (66 loc) · 3.13 KB

project.html.markdown

File metadata and controls

95 lines (66 loc) · 3.13 KB
layout page_title description
azuredevops
AzureDevops: azuredevops_project
Manages a project within Azure DevOps organization.

azuredevops_project

Manages a project within Azure DevOps.

Example Usage

resource "azuredevops_project" "example" {
  name               = "Example Project"
  visibility         = "private"
  version_control    = "Git"
  work_item_template = "Agile"
  description        = "Managed by Terraform"
  features = {
    testplans = "disabled"
    artifacts = "disabled"
  }
}

Argument Reference

The following arguments are supported:

  • name - (Required) The Project Name.

  • description - (Optional) The Description of the Project.

  • visibility - (Optional) Specifies the visibility of the Project. Possible values are: private or public. Defaults to private.

  • version_control - (Optional) Specifies the version control system. Possbile values are: Git or Tfvc. Defaults to Git.

  • work_item_template - (Optional) Specifies the work item template. Possible values are: Agile, Basic, CMMI, Scrum or a custom, pre-existing one. Defaults to Agile. An empty string will use the parent organization default.

  • features - (Optional) Defines the status (enabled, disabled) of the project features. Valid features are boards, repositories, pipelines, testplans, artifacts

    Features Possible Values
    boards enabled, disabled
    repositories enabled, disabled
    pipelines enabled, disabled
    testplans enabled, disabled
    artifacts enabled, disabled

    ~> NOTE: It's possible to define project features both within the azuredevops_project_features resource and via the features block by using the azuredevops_project resource. However it's not possible to use both methods to manage features, since there'll be conflicts.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

  • id - The Project ID of the Project.
  • process_template_id - The Process Template ID used by the Project.

Relevant Links

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

  • create - (Defaults to 10 minutes) Used when creating the Project.
  • read - (Defaults to 5 minute) Used when retrieving the Project.
  • update - (Defaults to 10 minutes) Used when updating the Project.
  • delete - (Defaults to 10 minutes) Used when deleting the Project.

Import

Azure DevOps Projects can be imported using the project name or by the project Guid, e.g.

terraform import azuredevops_project.example "Example Project"

or

terraform import azuredevops_project.example 00000000-0000-0000-0000-000000000000

PAT Permissions Required

  • Project & Team: Read, Write, & Manage
  • Work Items: Read