common_repository

Common repository configuration

Create a repository with managed labels, permissions, and branch protection rules.

Examples

A very typical repository

module "repo_docs" {
  source      = "./modules/common_repository"
  name        = "docs"
  description = "General documentation for the AI in a Box project"
}

A repository with a team collaborator

module "repo_docs" {
  source      = "./modules/common_repository"
  name        = "docs"
  description = "General documentation for the AI in a Box project"
  teams = [
    {
      team_id = "docs-workers"
      permission = "push"
    }
  ]
}

Requirements

Name	Version
terraform	>= 1.9.0
github	~> 6.0

Providers

Name	Version
github	~> 6.0

Resources

Name	Type
github_branch_protection.repo_protection	resource
github_issue_label.repo_labels	resource
github_repository.repo	resource
github_repository_collaborators.repo_collaborators	resource

Inputs

Name	Description	Type	Default	Required
all_members_permission	Permission for all organization members	string	"triage"	no
branch_protection	Configure branch protection if true	bool	true	no
description	Repository description	string	""	no
is_template	Set this to true if this is a template repository	bool	false	no
labels	List of labels to configure on the repository	list(object({ name = string color = string description = string }))	null	no
name	The name of the repository	string	n/a	yes
pages	Configuration for github pages	object({ source = optional(object({ branch = string path = string })) build_type = optional(string, "legacy") cname = optional(string) })	null	no
required_approvals	Number of approvals required before merging a pull request	number	1	no
required_status_checks	A list of status checks that must pass before a PR can merge	list(string)	[]	no
teams	Teams with access to this repository	list(object({ team_id = string permission = string }))	[]	no
use_public_template	Use the public_template repository as the template for a new repository	bool	true	no
users	Users with access to this repository	list(object({ username = string permission = string }))	[]	no
visibility	Repository visibility (public or private)	string	"public"	no
vulnerability_alerts	Enable or disable dependabot vulnerability alerts	bool	false	no