github_repository
This resource allows you to create and manage repositories within your Github organization.
This resource cannot currently be used to manage personal repositories, outside of organizations.
Example Usage
resource "github_repository" "example" {
name = "example"
description = "My awesome codebase"
private = true
}
Argument Reference
The following arguments are supported:
-
name- (Required) The name of the repository. -
description- (Optional) A description of the repository. -
homepage_url- (Optional) URL of a page describing the project. -
private- (Optional) Set totrueto create a private repository. Repositories are created as public (e.g. open source) by default. -
has_issues- (Optional) Set totrueto enable the Github Issues features on the repository. -
has_wiki- (Optional) Set totrueto enable the Github Wiki features on the repository. -
has_downloads- (Optional) Set totrueto enable the (deprecated) downloads features on the repository. -
auto_init- (Optional) Meaningful only during create; set totrueto produce an initial commit in the repository.
Attributes Reference
The following additional attributes are exported:
-
full_name- A string of the form “orgname/reponame”. -
default_branch- The name of the repository’s default branch. -
ssh_clone_url- URL that can be provided togit cloneto clone the repository via SSH. -
http_clone_url- URL that can be provided togit cloneto clone the repository via HTTPS. -
git_clone_url- URL that can be provided togit cloneto clone the repository anonymously via the git protocol. -
svn_url- URL that can be provided tosvn checkoutto check out the repository via Github’s Subversion protocol emulation.
See the source of this document at Terraform.io