website: docs for github_repository resource

This commit is contained in:
Martin Atkins 2016-10-11 10:16:09 -07:00
parent f4ecf72125
commit 78c39c7c62
2 changed files with 74 additions and 0 deletions

View File

@ -0,0 +1,71 @@
---
layout: "github"
page_title: "GitHub: github_repository"
sidebar_current: "docs-github-resource-repository"
description: |-
Creates and manages repositories within Github organizations
---
# 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 to `true` to create a private repository.
Repositories are created as public (e.g. open source) by default.
* `has_issues` - (Optional) Set to `true` to enable the Github Issues features
on the repository.
* `has_wiki` - (Optional) Set to `true` to enable the Github Wiki features on
the repository.
* `has_downloads` - (Optional) Set to `true` to enable the (deprecated)
downloads features on the repository.
* `auto_init` - (Optional) Meaningful only during create; set to `true` to
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 to `git clone` to clone the
repository via SSH.
* `http_clone_url` - URL that can be provided to `git clone` to clone the
repository via HTTPS.
* `git_clone_url` - URL that can be provided to `git clone` to clone the
repository anonymously via the git protocol.
* `svn_url` - URL that can be provided to `svn checkout` to check out
the repository via Github's Subversion protocol emulation.

View File

@ -16,6 +16,9 @@
<li<%= sidebar_current("docs-github-resource-membership") %>>
<a href="/docs/providers/github/r/membership.html">github_membership</a>
</li>
<li<%= sidebar_current("docs-github-resource-repository") %>>
<a href="/docs/providers/github/r/repository.html">github_repository</a>
</li>
<li<%= sidebar_current("docs-github-resource-repository-collaborator") %>>
<a href="/docs/providers/github/r/repository_collaborator.html">github_repository_collaborator</a>
</li>