terraform/website/source/docs/providers/github/r/issue_label.html.markdown

1.2 KiB

layout page_title sidebar_current description
github GitHub: github_issue_label docs-github-resource-issue-label Provides a GitHub issue label resource.

github_issue_label

Provides a GitHub issue label resource.

This resource allows you to create and manage issue labels within your Github organization.

Issue labels are keyed off of their "name", so pre-existing issue labels result in a 422 HTTP error if they exist outside of Terraform. Normally this would not be an issue, except new repositories are created with a "default" set of labels, and those labels easily conflict with custom ones.

This resource will first check if the label exists, and then issue an update, otherwise it will create.

Example Usage

# Create a new, red colored label
resource "github_issue_label" "test_repo" {
  repository = "test-repo"
  name       = "Urgent"
  color      = "FF0000"
}

Argument Reference

The following arguments are supported:

  • repository - (Required) The GitHub repository

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

  • color - (Required) A 6 character hex code, without the leading #, identifying the color of the label.