DEV Community πŸ‘©β€πŸ’»πŸ‘¨β€πŸ’»

DEV Community πŸ‘©β€πŸ’»πŸ‘¨β€πŸ’» is a community of 964,423 amazing developers

We're a place where coders share, stay up-to-date and grow their careers.

Create account Log in
Cover image for Repository Mirror with OneDev
Robin Shen
Robin Shen

Posted on • Updated on

Repository Mirror with OneDev

Introduction

It is often desirable to mirror repositories between OneDev and other hosting services. For instance you may want to push changes to a copy at GitHub for public access, or want to pull back any changes contributed by others at GitHub.

OneDev 7.1 made this task trivial with the new repository sync steps. Let’s see how to achieve this.

Preparation

First of all, start OneDev by running below command:

$ docker run -t --rm -v /var/run/docker.sock:/var/run/docker.sock -v $(pwd)/onedev:/opt/onedev -p 6610:6610 -p 6611:6611 1dev/server
Enter fullscreen mode Exit fullscreen mode

Point your browser to localhost:6610 to setup OneDev, and create a test project.

Then create an empty repository at GitHub side to be used as mirror of our test repository, assume the url is: https://github.com/youraccount/test

Push Changes to Mirror

Now we configure OneDev to push changes to GitHub mirror as long as there is a change in branch or tag:

  1. Login to your GitHub account and generate a personal access token able to push to the mirror repository

  2. At OneDev side, create a job secret in the test project and use access token above as its value:

    Image description

  3. Define build spec to add a job say Push to GitHub, and add a step of type Repository Sync / Push to Remote. For password / access token field, choose the job token defined above:

    Image description

  4. Add triggers to run job automatically when branch is updated or tag is created:

    Image description

Now save the build spec and the job will run automatically to push changes to GitHub mirror. Check at GitHub side, and you will see it contains newly created file .onedev-buildspec.yml. Experiment with other changes such as creating new branch/tag to see the result.

Pull Changes from Mirror

Our GitHub mirror may accept pull requests from contributors, so let’s set up OneDev to pull changes from it:

  1. Continue to edit build spec above, add a job say Pull from GitHub, and add a step of type Repository Sync / Pull from Remote like below:

    Image description

Here we use the same job token defined above to access GitHub mirror (access token can be left empty if the mirror is publicly accessible).

  1. Add a job trigger of cron type to run job on scheduled time, for instance, on 1:00AM every night:

    Image description

  2. If your OneDev instance can be accessed publicly, you can configure GitHub to trigger this pull job upon mirror changes. This can be done by creating a webhook at GitHub side like below:

    Image description

The payload url is defined as:

http://onedev.example.com/api/trigger-job?project=test&job=Pull%20from%20GitHub&branch=master&access-token=<OneDev access token>
Enter fullscreen mode Exit fullscreen mode

Here onedev.example.com is dns name accessing your OneDev instance. Job name is url encoded as it contains space. should be replaced by access token of a OneDev user with permission to run the job like below::

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/rkjcdnaopfq3oych4xea.png)
Enter fullscreen mode Exit fullscreen mode

For production use, it is important to enable https protocol for payload url to avoid leaking of access token.

Save the webhook and OneDev should be pulling from GitHub mirror whenever it is changed.

Conclusion

We’ve completed setup of a two-way sync of OneDev repository and its GitHub mirror. Since it is just an ordinary CI job, we can subscribe certain build query to be notified of sync failures, check build log to investigate sync failures, or even configure job resource setting to control resource usage of multiple sync jobs, etc.

Thanks for reading!

Top comments (0)

Take a look at this:

Settings

Go to your customization settings to nudge your home feed to show content more relevant to your developer experience level. πŸ›