upgrade_0.2.x-0.3.x.md

Upgrade Notes

This documentation outlines steps for you to upgrade from gitlab-mirrors 0.2.x to gitlab-mirrors 0.3.x. It is assumed you'll be working on a test instance of gitlab in a production environment. If you only have a single gitlab instance then follow these steps with care and at your own risk.

gitlab-mirrors has been certified to use a new prerequisite library called pyapi-gitlab (formerly called python-gitlab). Therefore you must install pyapi-gitlab before upgrading gitlab-mirrors to the latest edition.

1. Disable any cron jobs

If you have cron jobs set up then you'll need to disable them to avoid them launching gitlab-mirrors during your upgrade.

2. Update python-gitlab to pyapi-gitlab

I'll ouline the steps here real quick.

cd /usr/local/src
git checkout https://github.com/Itxaka/pyapi-gitlab.git
git checkout 4d778d780161869550d8e514cdc50df2398f844e
python setup.py install

You must remove the previous conflicting library from /usr/local/lib/python2.7/dist-packages/python_gitlab-0.1-py2.7.egg by default on my system. Your system may vary the location. If you're not sure where it's at then you can locate it using mlocate package in RHEL.

yum install mlocate
updatedb
locate *.egg
rm -rf /usr/local/lib/python2.7/dist-packages/python_gitlab-0.1-py2.7.egg

3. Update your gitlab-mirrors

su - gitmirror
cd gitlab-mirrors
git checkout master
git fetch
git pull origin master
git checkout v0.3.0

Test on a dummy project to ensure your new setup works. Once you have verified everything works then you can re-enable the cron jobs.