Terraform Module Registry

Terraform module to manage GitHub teams

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

  export GITHUB_TOKEN='TOKEN'

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

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 =
}

No modules.

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")
    })))
  }))