| Name | pulumi-github JSON |
| Version |
2.5.0
JSON |
| download |
| home_page | https://pulumi.io |
| Summary | A Pulumi package for creating and managing github cloud resources. |
| upload_time | 2021-01-19 18:38:44 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | |
| license | Apache-2.0 |
| keywords |
pulumi
github
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://travis-ci.com/pulumi/pulumi-github)
# GitHub provider
The GitHub resource provider for Pulumi lets you use GitHub resources in your infrastructure
programs. To use this package, please [install the Pulumi CLI first](https://pulumi.io/).
## Installing
This package is available in many languages in the standard packaging formats.
### Node.js (Java/TypeScript)
To use from JavaScript or TypeScript in Node.js, install using either `npm`:
$ npm install @pulumi/github
or `yarn`:
$ yarn add @pulumi/github
### Python
To use from Python, install using `pip`:
$ pip install pulumi-github
### Go
To use from Go, use `go get` to grab the latest version of the library
$ go get github.com/pulumi/pulumi-github/sdk/go/...
### .NET
To use from .NET, install using `dotnet add package`:
$ dotnet add package Pulumi.Github
## Configuration
The following configuration points are available:
- `github:token` - (Optional) This is the GitHub personal access token. It can also be sourced from the `GITHUB_TOKEN`
environment variable. If anonymous is false, token is required.
- `github:organization` - (Optional) This is the target GitHub organization to manage. The account corresponding to the
token will need "owner" privileges for this organization. It can also be sourced from the `GITHUB_ORGANIZATION` environment
variable. If individual is set to false, organization is required.
- `github:baseUrl` - (Optional) This is the target GitHub base API endpoint. Providing a value is a requirement when
working with GitHub Enterprise. It is optional to provide this value and it can also be sourced from the `GITHUB_BASE_URL`
environment variable. The value must end with a slash, and generally includes the API version, for instance
`https://github.someorg.example/api/v3/`.
- `github:insecure` - (Optional) Whether server should be accessed without verifying the TLS certificate. As the name
suggests this is insecure and should not be used beyond experiments, accessing local (non-production) GHE instance etc.
There is a number of ways to obtain trusted certificate for free, e.g. from Let's Encrypt. Such trusted certificate does
not require this option to be enabled. Defaults to `false`.
- `github:individual` - (Optional) Run outside an organization. When individual is true, the provider will run outside
the scope of an organization. Defaults to `false`.
- `github:anonymous` - (Optional) Authenticate without a token. When anonymous is true, the provider will not be able to
access resources that require authentication. Setting to true will lead the GitHub provider to work in an anonymous mode
with the corresponding API rate limits. Defaults to `false`.
## Reference
For further information, please visit [the GitHub provider docs](https://www.pulumi.com/docs/intro/cloud-providers/github) or for detailed reference documentation, please visit [the API docs](https://www.pulumi.com/docs/reference/pkg/github).
Raw data
{
"_id": null,
"home_page": "https://pulumi.io",
"name": "pulumi-github",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "pulumi github",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/12/6f/96c0372cf5300ad450cfd762a171f91db694ac89dc0c11967c2c0b1f67a0/pulumi_github-2.5.0.tar.gz",
"platform": "",
"description": "[](https://travis-ci.com/pulumi/pulumi-github)\n\n# GitHub provider\n\nThe GitHub resource provider for Pulumi lets you use GitHub resources in your infrastructure \nprograms. To use this package, please [install the Pulumi CLI first](https://pulumi.io/).\n\n## Installing\n\nThis package is available in many languages in the standard packaging formats.\n\n### Node.js (Java/TypeScript)\n\nTo use from JavaScript or TypeScript in Node.js, install using either `npm`:\n\n $ npm install @pulumi/github\n\nor `yarn`:\n\n $ yarn add @pulumi/github\n\n### Python\n\nTo use from Python, install using `pip`:\n\n $ pip install pulumi-github\n\n### Go\n\nTo use from Go, use `go get` to grab the latest version of the library\n\n $ go get github.com/pulumi/pulumi-github/sdk/go/...\n\n### .NET\n\nTo use from .NET, install using `dotnet add package`:\n\n $ dotnet add package Pulumi.Github\n\n## Configuration\n\nThe following configuration points are available:\n\n- `github:token` - (Optional) This is the GitHub personal access token. It can also be sourced from the `GITHUB_TOKEN`\nenvironment variable. If anonymous is false, token is required.\n- `github:organization` - (Optional) This is the target GitHub organization to manage. The account corresponding to the\ntoken will need \"owner\" privileges for this organization. It can also be sourced from the `GITHUB_ORGANIZATION` environment \nvariable. If individual is set to false, organization is required.\n- `github:baseUrl` - (Optional) This is the target GitHub base API endpoint. Providing a value is a requirement when\nworking with GitHub Enterprise. It is optional to provide this value and it can also be sourced from the `GITHUB_BASE_URL`\nenvironment variable. The value must end with a slash, and generally includes the API version, for instance \n`https://github.someorg.example/api/v3/`.\n- `github:insecure` - (Optional) Whether server should be accessed without verifying the TLS certificate. As the name\nsuggests this is insecure and should not be used beyond experiments, accessing local (non-production) GHE instance etc.\nThere is a number of ways to obtain trusted certificate for free, e.g. from Let's Encrypt. Such trusted certificate does\nnot require this option to be enabled. Defaults to `false`.\n- `github:individual` - (Optional) Run outside an organization. When individual is true, the provider will run outside\nthe scope of an organization. Defaults to `false`.\n- `github:anonymous` - (Optional) Authenticate without a token. When anonymous is true, the provider will not be able to\naccess resources that require authentication. Setting to true will lead the GitHub provider to work in an anonymous mode\nwith the corresponding API rate limits. Defaults to `false`.\n\n## Reference\n\nFor further information, please visit [the GitHub provider docs](https://www.pulumi.com/docs/intro/cloud-providers/github) or for detailed reference documentation, please visit [the API docs](https://www.pulumi.com/docs/reference/pkg/github).",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "A Pulumi package for creating and managing github cloud resources.",
"version": "2.5.0",
"split_keywords": [
"pulumi",
"github"
],
"urls": [
{
"comment_text": "",
"digests": {
"md5": "4bf17758d015a4202da923b5d7301b47",
"sha256": "eb13b6eb0d155c9a39058c1cad8c83d42bbd09d49d1e461479bc11a9369910ff"
},
"downloads": -1,
"filename": "pulumi_github-2.5.0.tar.gz",
"has_sig": false,
"md5_digest": "4bf17758d015a4202da923b5d7301b47",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 43792,
"upload_time": "2021-01-19T18:38:44",
"upload_time_iso_8601": "2021-01-19T18:38:44.163888Z",
"url": "https://files.pythonhosted.org/packages/12/6f/96c0372cf5300ad450cfd762a171f91db694ac89dc0c11967c2c0b1f67a0/pulumi_github-2.5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2021-01-19 18:38:44",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "pulumi-github"
}
