mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-02-03 03:00:16 -05:00
4fde3b2be9
GitHub really doesn't like when you make the H lowercase, it violates their brand guidelines and they won't help promote anything that doesn't use the capital H.
43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
---
|
|
layout: "github"
|
|
page_title: "Provider: GitHub"
|
|
sidebar_current: "docs-github-index"
|
|
description: |-
|
|
The GitHub provider is used to interact with GitHub organization resources.
|
|
---
|
|
|
|
# GitHub Provider
|
|
|
|
The GitHub provider is used to interact with GitHub organization resources.
|
|
|
|
The provider allows you to manage your GitHub organization's members and teams easily.
|
|
It needs to be configured with the proper credentials before it can be used.
|
|
|
|
Use the navigation to the left to read about the available resources.
|
|
|
|
## Example Usage
|
|
|
|
```
|
|
# Configure the GitHub Provider
|
|
provider "github" {
|
|
token = "${var.github_token}"
|
|
organization = "${var.github_organization}"
|
|
}
|
|
|
|
# Add a user to the organization
|
|
resource "github_membership" "membership_for_user_x" {
|
|
...
|
|
}
|
|
```
|
|
|
|
## Argument Reference
|
|
|
|
The following arguments are supported in the `provider` block:
|
|
|
|
* `token` - (Optional) This is the GitHub personal access token. It must be provided, but
|
|
it can also be sourced from the `GITHUB_TOKEN` environment variable.
|
|
|
|
* `organization` - (Optional) This is the target GitHub organization to manage. The account
|
|
corresponding to the token will need "owner" privileges for this organization. It must be provided, but
|
|
it can also be sourced from the `GITHUB_ORGANIZATION` environment variable.
|