Deploy yaml files to a large number of repositories in seconds.
Project description
github-deploy
Using polyrepo's to manage projects ?
This can introduce a number challenges one of which is maintaining consistency across multiple repositories, for files like shared configurations without introducing git submodules or mono repositories which requires a more complex deployment configuration.
For example adding a github action or maintaing a consistent pull request template accross your organization.
Solution
github-deploy
makes maintaining such configurations as easy as a single command.
Alias : gh-deploy
Installation
pip install github-deploy
Setup
A Personal Access Token which can be created using this guide
Required Scopes
The required scopes are repo
and workflow
Usage
Upload files to github
gh-deploy upload --org [org] --token [PAT_TOKEN] --dest [LOCATION TO UPLOAD FILE] --source [SOURCE FILE LOCATION]
Example:
gh-deploy upload --org tj-actions --token [PAT_TOKEN] --dest '.github/workflows/auto-approve.yml' --source auto-approve.yml
NOTE:
auto-approve.yml
is located on your local system.
Deleting files on github
gh-deploy delete --org [org] --token [PAT_TOKEN] --dest [LOCATION TO DELETE]
Example:
gh-deploy delete --org tj-actions --token [PAT_TOKEN] --dest '.github/auto-approve.yml'
COMMAND
gh-deploy --help
Usage: gh-deploy [OPTIONS] COMMAND [ARGS]...
Deploy changes to multiple github repositories using a single command.
Options:
--help Show this message and exit.
Commands:
delete Delete a file in all repositories owned by an organization/user.
upload Upload a file to all repositories owned by an organization/user.
gh-deploy upload --help
Usage: gh-deploy upload [OPTIONS]
Upload a file to all repositories owned by an organization/user.
Options:
--org TEXT The github organization.
--token TEXT Personal Access token with read and write
access to org.
--source PATH Source file.
--dest TEXT Destination path.
--overwrite / --no-overwrite Overwrite existing files.
--private / --no-private Upload files to private repositories.
--help Show this message and exit.
gh-deploy delete --help
Usage: gh-deploy delete [OPTIONS]
Delete a file in all repositories owned by an organization/user.
Options:
--org TEXT The github organization.
--token TEXT Personal Access token with read and write access to org.
--dest TEXT Destination path to delete.
--help Show this message and exit.
Resources
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for github_deploy-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 86eedb30286aa16828e86decc8316a3e66066ca1a904217325ea582646da133f |
|
MD5 | 86dab37560ec2a2ca80b5027eb4ff5ea |
|
BLAKE2b-256 | 5c15e26c28ffccead88d7f95fd820ec25d3cab4c4a0beecacf80a6204ccee11c |