BitBucket Smart Mirroring syncronization process

Question

I'm trying to understand what the lag time is between servers/repositories with the Smart Mirroring feature.  We have a team that is remote from the main server and also has a CI infrastructure there.  We are trying to understand what is the lag time from a commit to the main server until the commit is seen at the mirrors.

After setting up the mirror, there are no knobs or status information apparent that control or provide insight into this.  Any help in understanding this aspect of the feature would be appreciated.

What is the synchronization process under the covers?  Is it pushing commits as they happen or is it more of a git fetch update type process occurring on a schedule?

Kanwar_xbqekf · Answer

Hi @KAYAK Team

If your question is still relevant and not answered, the regular sync job (not triggered from an upstream webhook) for smart mirrors runs every 15 minutes.

Hope that helps.

Kanwar

KAYAK Team · Answer

How often does that sync job run, and is there any way to change the frequency? How about running the sync job manually? We're seeing occasional failures to keep mirrors in sync, and there's currently no visible way to force things back into the correct state.

Felix_qq95eu · Answer

Hi @Daniel Holmes,

The idea behind Bitbucket Smart Mirroring is, that the mirrors are in-sync as quickly as possible.
When a user pushes code to the primary instance, an event will trigger, and update all mirrors.

In addition to this, a 'sync' job runs on each mirror on a schedule to update itself, in case an event was
missed (which could be caused by for example a network outage, restart of the mirror, etc.). This job will
check that every repository the mirror is set-up to host is up-to-date.

The lag time to update a mirror really depends on the size of the pushes going to your primary instance,
as well as the connection speed between your primary and your mirrors. A simple push to a primary with a 
mirror on the same network should see the mirror being updated in less than a second.

Note that the longest time a mirror will be out of sync will likely be shortly after the initial setup, as it needs to fetch all the pre-existing data it is configured to mirror from the primary. Once the initial sync is complete, a mirror should be up-to-date very quickly after changes arrive at the primary.

I hope that helps,

Felix