Skip to content

nhsx-mirror/mirror-github-org

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 

Repository files navigation

Github Organisation Mirror

This is a small tool for continually mirroring all the public repositories from one Github organisation to another, designed for backing up organisations who may take down repositories without notice (such as governments).

It also ships with a CircleCI configuration that will run the job hourly.

Usage

  • Create a new organisation that will hold all of the repositories you're mirroring
  • Create a Github personal access token that has access to the destination organisation
  • Clone this repository to an organisation/user you control
  • Login to CircleCI and enable it for this new cloned repository
  • Configure three environment variables in CircleCI for this repository
    • GITHUB_TOKEN - The personal access token you created above
    • SRC_ORG - The name of the organisation you want to mirror
    • DST_ORG - The name of the new organisation you just created
  • Run the job and sit back, you now have a daily-updated mirror of a Github org!

Todo

  • Deal with a few weird Github API error cases
  • Trial Github Actions instead of CircleCI
  • Automate more of the configuration (can we make it possible to just fork it to an ORGNAME-mirror account and just work?
  • Generate a changelog
  • Generate events if repositories are removed

About

A simple way to mirror Github organisations that occasionally take down repositories

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%