Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
G
gitlab-ce
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
iv
gitlab-ce
Commits
12969a14
Commit
12969a14
authored
Sep 21, 2015
by
Kamil Trzcinski
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Add commands for Omnibus installation
parent
157ee662
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
62 additions
and
11 deletions
+62
-11
doc/migrate_ci_to_ce/README.md
doc/migrate_ci_to_ce/README.md
+62
-11
No files found.
doc/migrate_ci_to_ce/README.md
View file @
12969a14
...
@@ -19,7 +19,7 @@ time. Make sure to plan ahead.
...
@@ -19,7 +19,7 @@ time. Make sure to plan ahead.
If you are running a version of GitLab CI prior to 8.0 please follow the
If you are running a version of GitLab CI prior to 8.0 please follow the
appropriate
[
update guide
](
https://gitlab.com/gitlab-org/gitlab-ci/tree/master/doc/update/
)
.
appropriate
[
update guide
](
https://gitlab.com/gitlab-org/gitlab-ci/tree/master/doc/update/
)
.
The migration is divided into three parts:
The migration is divided into three parts
and covers manual and omnibus installations
:
1.
[
GitLab CI
](
#part-i-gitlab-ci
)
1.
[
GitLab CI
](
#part-i-gitlab-ci
)
1.
[
Gitlab CE (or EE)
](
#part-ii-gitlab-ce-or-ee
)
1.
[
Gitlab CE (or EE)
](
#part-ii-gitlab-ce-or-ee
)
...
@@ -29,7 +29,11 @@ The migration is divided into three parts:
...
@@ -29,7 +29,11 @@ The migration is divided into three parts:
#### 1. Stop GitLab CI
#### 1. Stop GitLab CI
# Manual installation
sudo service gitlab_ci stop
sudo service gitlab_ci stop
# Omnibus installation
sudo gitlab-ctl stop ci-unicorn ci-sidekiq
#### 2. Create a backup
#### 2. Create a backup
...
@@ -41,6 +45,8 @@ If your GitLab CI installation uses **MySQL** and your GitLab CE (or EE)
...
@@ -41,6 +45,8 @@ If your GitLab CI installation uses **MySQL** and your GitLab CE (or EE)
installation uses
**PostgreSQL**
you'll need to convert the CI database by
installation uses
**PostgreSQL**
you'll need to convert the CI database by
setting a
`MYSQL_TO_POSTGRESQL`
flag.
setting a
`MYSQL_TO_POSTGRESQL`
flag.
If you use Omnibus package you most likely use the
**PostgreSQL**
on GitLab CE (or EE) and CI.
You can check which database each install is using by viewing their
You can check which database each install is using by viewing their
database configuration files:
database configuration files:
...
@@ -50,21 +56,26 @@ database configuration files:
...
@@ -50,21 +56,26 @@ database configuration files:
-
If both applications use the same database
`adapter`
, create the backup with
-
If both applications use the same database
`adapter`
, create the backup with
this command:
this command:
```bash
# Manual installation
cd /home/gitlab_ci/gitlab-ci
cd /home/gitlab_ci/gitlab-ci
sudo -u gitlab_ci -H bundle exec backup:create RAILS_ENV=production
sudo -u gitlab_ci -H bundle exec backup:create RAILS_ENV=production
```
# Omnibus installation
sudo gitlab-ci-rake backup:create
-
If CI uses MySQL, and CE (or EE) uses PostgreSQL, create the backup with this
-
If CI uses MySQL, and CE (or EE) uses PostgreSQL, create the backup with this
command (note the
`MYSQL_TO_POSTGRESQL`
flag):
command (note the
`MYSQL_TO_POSTGRESQL`
flag):
```bash
# Manual installation
cd /home/gitlab_ci/gitlab-ci
cd /home/gitlab_ci/gitlab-ci
sudo -u gitlab_ci -H bundle exec backup:create RAILS_ENV=production MYSQL_TO_POSTGRESQL=1
sudo -u gitlab_ci -H bundle exec backup:create RAILS_ENV=production MYSQL_TO_POSTGRESQL=1
```
# Omnibus installation
sudo gitlab-ci-rake backup:create MYSQL_TO_POSTGRESQL=1
#### 3. Remove cronjob
#### 3. Remove cronjob
(manual installation)
# Manual installation
cd /home/gitlab_ci/gitlab-ci
cd /home/gitlab_ci/gitlab-ci
sudo -u gitlab_ci -H bundle exec whenever --clear-crontab
sudo -u gitlab_ci -H bundle exec whenever --clear-crontab
...
@@ -75,6 +86,8 @@ database configuration files:
...
@@ -75,6 +86,8 @@ database configuration files:
Your GitLab CE or EE installation
**must be version 8.0**
. If it's not, follow
Your GitLab CE or EE installation
**must be version 8.0**
. If it's not, follow
the
[
update guide
](
https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/7.14-to-8.0.md
)
.
the
[
update guide
](
https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/update/7.14-to-8.0.md
)
.
If you use Omnibus package simply do
`apt-get upgrade`
to install a new version.
#### 2. Prevent CI usage for time of migration
#### 2. Prevent CI usage for time of migration
As Admin go to Admin Area -> Settings -> and uncheck
As Admin go to Admin Area -> Settings -> and uncheck
...
@@ -86,20 +99,32 @@ This will prevent from creating the CI projects till you finish migration.
...
@@ -86,20 +99,32 @@ This will prevent from creating the CI projects till you finish migration.
Before you can migrate data you need to stop the GitLab service first:
Before you can migrate data you need to stop the GitLab service first:
# Manual installation
sudo service gitlab stop
sudo service gitlab stop
# Omnibus installation
sudo gitlab-ctl stop unicorn sidekiq
#### 4. Create a backup
#### 4. Create a backup
This migration poses a
**significant risk**
of breaking your GitLab
This migration poses a
**significant risk**
of breaking your GitLab
installation. Create a backup before proceeding:
installation. Create a backup before proceeding:
# Manual installation
cd /home/git/gitlab
cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
# Omnibus installation
sudo gitlab-rake gitlab:backup:create
It's possible to speedup backup creation. To do that you can skip repositories and uploads.
It's possible to speedup backup creation. To do that you can skip repositories and uploads.
# Manual installation
cd /home/git/gitlab
cd /home/git/gitlab
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production SKIP=repositories,uploads
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production SKIP=repositories,uploads
# Omnibus installation
sudo gitlab-rake gitlab:backup:create SKIP=repositories,uploads
#### 5. Copy secret tokens from CI
#### 5. Copy secret tokens from CI
...
@@ -108,11 +133,18 @@ The `secrets.yml` file stores encryption keys for secure variables.
...
@@ -108,11 +133,18 @@ The `secrets.yml` file stores encryption keys for secure variables.
You need to copy the contents of GitLab CI's
`config/secrets.yml`
file to the
You need to copy the contents of GitLab CI's
`config/secrets.yml`
file to the
same file in GitLab CE:
same file in GitLab CE:
# Manual installation
sudo cp /home/gitlab_ci/gitlab-ci/config/secrets.yml /home/git/gitlab/config/secrets.yml
sudo cp /home/gitlab_ci/gitlab-ci/config/secrets.yml /home/git/gitlab/config/secrets.yml
sudo chown git:git /home/git/gitlab/config/secrets.yml
sudo chown git:git /home/git/gitlab/config/secrets.yml
sudo chown 0600 /home/git/gitlab/config/secrets.yml
sudo chown 0600 /home/git/gitlab/config/secrets.yml
#### 6. New configuration options for `gitlab.yml`
If you use Omnibus installation and your CI server is on the same server as GitLab CE (or EE) you don't need to do anything,
because the secrets are stored in
**/etc/gitlab/gitlab-secrets.json**
.
If you migrate your Omnibus CI server to other server you need to copy
**gitlab_ci**
section of
**/etc/gitlab/gitlab-secrets.json**
to the other server.
#### 6. New configuration options for `gitlab.yml` (manual installation only)
There are new configuration options available for
`gitlab.yml`
. View them with
There are new configuration options available for
`gitlab.yml`
. View them with
the command below and apply them manually to your current
`gitlab.yml`
:
the command below and apply them manually to your current
`gitlab.yml`
:
...
@@ -123,21 +155,34 @@ The new options include configuration settings for GitLab CI.
...
@@ -123,21 +155,34 @@ The new options include configuration settings for GitLab CI.
#### 7. Copy backup from GitLab CI
#### 7. Copy backup from GitLab CI
# Manual installation
sudo cp -v /home/gitlab_ci/gitlab-ci/tmp/backups/*_gitlab_ci_backup.tar /home/git/gitlab/tmp/backups
sudo cp -v /home/gitlab_ci/gitlab-ci/tmp/backups/*_gitlab_ci_backup.tar /home/git/gitlab/tmp/backups
sudo chown git:git /home/git/gitlab/tmp/backups/*_gitlab_ci_backup.tar
sudo chown git:git /home/git/gitlab/tmp/backups/*_gitlab_ci_backup.tar
# Omnibus installation
sudo cp -v /var/opt/gitlab/ci-backups/*_gitlab_ci_backup.tar /var/opt/gitlab/backups/
sudo chown git:git /var/opt/gitlab/backups/*_gitlab_ci_backup.tar
If moving across the servers you can use
**scp**
.
If moving across the servers you can use
**scp**
.
However, this requires you to provide authorized key or password to login to GitLab CE servers from CI server.
However, this requires you to provide authorized key or password to login to GitLab CE servers from CI server.
You can try to use ssh-agent from your local machine to have that: login to your GitLab CI server using
`ssh -A`
.
You can try to use ssh-agent from your local machine to have that: login to your GitLab CI server using
`ssh -A`
.
# Manual installation
scp /home/gitlab_ci/gitlab-ci/tmp/backups/*_gitlab_ci_backup.tar root@gitlab.example.com:/home/git/gitlab/tmp/backup
scp /home/gitlab_ci/gitlab-ci/tmp/backups/*_gitlab_ci_backup.tar root@gitlab.example.com:/home/git/gitlab/tmp/backup
# Omnibus installation
scp /var/opt/gitlab/ci-backups/*_gitlab_ci_backup.tar root@gitlab.example.com:/var/opt/gitlab/backups/
#### 8. Import GitLab CI backup
#### 8. Import GitLab CI backup
Now you'll import the GitLab CI database dump that you created earlier into the
Now you'll import the GitLab CI database dump that you created earlier into the
GitLab CE or EE database:
GitLab CE or EE database:
# Manual installation
sudo -u git -H bundle exec rake ci:migrate RAILS_ENV=production
sudo -u git -H bundle exec rake ci:migrate RAILS_ENV=production
# Omnibus installation
sudo gitlab-rake ci:migrate
This task will take some time.
This task will take some time.
...
@@ -145,10 +190,16 @@ This task will take some time.
...
@@ -145,10 +190,16 @@ This task will take some time.
You can start GitLab CE (or EE) now and see if everything is working:
You can start GitLab CE (or EE) now and see if everything is working:
# Manual installation
sudo service gitlab start
sudo service gitlab start
# Omnibus installation
sudo gitlab-ctl restart unicorn sidekiq
### Part III: Finishing Up
### Part III: Finishing Up
This part is only for
**Manual installations**
.
#### 1. Update Nginx configuration
#### 1. Update Nginx configuration
To ensure that your existing CI runners are able to communicate with the
To ensure that your existing CI runners are able to communicate with the
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment