Skip to content

A Github Action to mirror one branch to another within the same repository

License

Notifications You must be signed in to change notification settings

google/mirror-branch-action

mirror-branch action

A Github Action to mirror one branch to another within the same repository

For example, if you've renamed your master branch to main, but a lot of links out on the web hard-code the old name, you could mirror the main branch back to master so those links keep working.

To use this Action, create a file called .github/workflows/mirror.yml with the following contents:

on:
  push:
    branches:
      - 'SOURCE_BRANCH_NAME'

jobs:
  mirror_job:
    runs-on: ubuntu-latest
    name: Mirror SOURCE_BRANCH_NAME branch to DESTINATION_BRANCH_NAME branch
    steps:
    - name: Mirror action step
      id: mirror
      uses: google/mirror-branch-action@v1.0
      with:
        github-token: ${{ secrets.GITHUB_TOKEN }}
        source: 'SOURCE_BRANCH_NAME'
        dest: 'DESTINATION_BRANCH_NAME'

With SOURCE_BRANCH_NAME and DESTINATION_BRANCH_NAME replaced as appropriate.


This is not an officially supported Google product.