terraform-github-teams

Terraform Module Registry

Terraform module to manage GitHub teams

Requirements

• GitHub personal access token with admin rights to an organization
  • Provide token via environment variable

  export GITHUB_TOKEN='TOKEN'

Features

• Manage GitHub teams
  • Manage nested teams (currently 4 levels)
• Manage team members

Terraform doesn't handle dynamic recursion or resource dependencies. To do
nested teams, the code would either need to be run multiple times or manage
a fixed maximum number of levels. This module manages up to 4 levels of nesting.
But could easily be expanded to more.

Usage

Basic usage of this module is as follows:

module "example" {
    source = "notablehealth/<module-name>/github"
    # Recommend pinning every module to a specific version
    # version = "x.x.x"

    # Required variables
    github_owner =
}

Requirements

Providers

Modules

No modules.

Resources

Inputs

map(object({
    name        = string
    description = string
    privacy     = optional(string, "closed")
    parent_team = optional(string)
    members = optional(list(object({
      full_name = optional(string)
      username  = string
      role      = optional(string, "member")
    })))
    repository = optional(object({
      name       = string
      permission = optional(string, "pull")
    }))
    review_request_delegation = optional(object({
      algorithm    = optional(string, "ROUND_ROBIN")
      member_count = optional(number)
      notify       = optional(bool)
    }))
  }))

Outputs