ghl

Tool to help sync repositories with organizational wide issue/pull request labels.

labels.json is a defined list of labels that sync across organization.

Getting started

Releases

docker run --rm -it \
    --env "GITHUB_ORGANIZATION=$GITHUB_ORGANIZATION" \
    --env "GITHUB_PAT=$GITHUB_PAT" \
    --env "GITHUB_REPOSITORIES=$GITHUB_REPOSITORIES" \
    "docker.pkg.github.com/jef/ghl/ghl:<tag>"

👉 View Available environment variables below if you'd like to customize input and output

Development

Requirements

• Node.js 14.0+ or Docker

Running

Runs via start task in npm. Please note of the required environment variables.

GITHUB_ORGANIZATION=jef
GITHUB_PAT=mysecrettoken
GITHUB_REPOSITORIES=ghl,userscript

# Node.js
npm run start $GITHUB_ORG $GITHUB_REPOS

# Docker
docker build -t ghl:localhost .

docker run --rm -it \
    --env "GITHUB_ORGANIZATION=$GITHUB_ORGANIZATION" \
    --env "GITHUB_PAT=$GITHUB_PAT" \
    --env "GITHUB_REPOSITORIES=$GITHUB_REPOSITORIES" \
    ghl:localhost

Available environment variables

• GITHUB_ORGANIZATION*: The organization in scope
• GITHUB_REPOSITORIES*: The repositories that need label syncing under organization
• GITHUB_PAT*: GitHub Personal Access Token
  • Create a PAT with read:org scope
  • Some organizations have SSO; if yours does, then you also need to enable it

👉 Required denoted by *