Bitbucket

---

To integrate your Bitbucket repositories with Komment, you will need to mirror them on GitHub.

Steps

1. First, go to GitHub and create a destination repository.

2. Your destination repository can be empty, but be sure to give it a name and set its visibility (public or private) according to your needs. Once you've filled in the details, click Create repository to proceed.

3. Navigate to the Bitbucket repository you want to import into Komment. Using the left-hand side menu, go to Repository settings > Pipelines > Settings.

4. Next, navigate to Repository settings > Pipelines > SSH keys.

4. Click on Generate keys.

5. Copy the public key.

6. Back in your destination repository on GitHub, head to the Settings menu.

7. Navigate from Settings > Security > Deploy keys.

8. Click on Add deploy key.

9. Paste the public key into the Key box. You will also need to tick the checkbox to Allow write access. Once done, click on Add key.

10. Back on Bitbucket, head to Repository settings > Security > Access keys in the repository you want to mirror.

11. Click on Add key.

12. Give your new key a name, and paste in the public key you copied in Step 5. Once done, click on Add SSH key.

13. Create a bitbucket-pipelines.yml file in your BitBucket repository or add this to your existing file:

pipelines:
  default:
    - step:
        name: Sync GitHub Mirror
        image: alpine/git:latest
        clone:
          enabled: false
        script:
          - git clone --bare git@bitbucket.org:RepoOrg/RepoName.git
          - cd RepoName.git
          - git push --mirror git@github.com:RepoOrg/RepoName.git

Once this is pushed, any further pushes to BibBucket will be automatically synced to the GitHub destination repository.

Do note you need to substitute 'RepoName' and 'RepoOrg' with the names of your own repositories. In our worked example, this is the resulting yaml file:

14. You can check if your pipeline ran successfully by navigating to the Pipelines section of your Bitbucket repository. A successful pipeline status will indicate content has been pushed to GitHub.

You can now import the project as normal on Komment.