Skip to content
Snippets Groups Projects
Commit acb630b0 authored by Sam Gleske's avatar Sam Gleske
Browse files

Adding upgrade docs

parent 9a9e0d4e
No related branches found
No related tags found
No related merge requests found
# 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](https://github.com/Itxaka/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.
# 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](https://github.com/Itxaka/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.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment