В данной статье подробно разберем пример переезда GitLab с omnibus-установки в docker-установку с сохранением всех данных — репозиториев, мерджей, комментариев, артефактов и билдов (если такие есть). Давайте разберемся!
Итак, имеем неактуальную omnibus-установку GitLab из пакета gitlab-ce_10.6.4-ce.0_amd64.deb. Хотим получить актуальную версию (10.8.4-ce.0), установленную в docker-контейнере, для простоты обновления в будущем.
Сначала делаем резервную копию omnibus-установки GitLab:
sudo gitlab-rake gitlab:backup:create
По умолчанию резервная копия будет создана в каталоге /var/opt/gitlab/backups.
При создании резервных копий Gitlab бекапятся все git-репозитории, загруженные файлы и база данных. SSH-ключи не бекапятся, следует помнить об этом!
Из docker-образа устанавливаем GitLab той же версии, что и в omnibus-установке. Сделаем все красиво через docker-compose. Допустим у нас была версия 10.6.4 и не может она больше обновляться по разным причинам — например из-за РКН, или у вас старая дебиан на которую нельзя накатить обновления.
Создадим необходимые директории.
1 2 3 | mkdir -p /docker-compose/SWARM/gitlab cd /docker-compose/SWARM/gitlab mkdir -p {data/gitlab/configs,data/gitlab/logs,data/gitlab/data} |
1 | nano docker-compose.yml |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | #docker stack deploy --compose-file=docker-compose.yml gitlab version: '3.4' services: gitlab: image: gitlab/gitlab-ce:10.6.4-ce.0 ports: - "10080:80" - "2224:22" - "4567:4567" volumes: - "./data/gitlab/config:/etc/gitlab" - "./data/gitlab/logs:/var/log/gitlab" - "./data/gitlab/data:/var/opt/gitlab" environment: GITLAB_OMNIBUS_CONFIG: | external_url 'http://git.itс-life.ru' gitlab_rails['gitlab_shell_ssh_port'] = 2224 networks: gitlab-net: aliases: - gitlab.itc-life.ru deploy: #mode: replicated replicas: 1 # service resource management resources: # Hard limit - Docker does not allow to allocate more limits: cpus: '2' memory: 3096M # Soft limit - Docker makes best effort to return to it reservations: memory: 16M # service restart policy restart_policy: condition: on-failure delay: 5s max_attempts: 3 window: 20s # service update configuration update_config: parallelism: 1 delay: 10s failure_action: continue monitor: 5s max_failure_ratio: 0.3 # placement constraint - in this case on 'worker' nodes only placement: constraints: [node.role == manager] ##NETWORKS networks: gitlab-net: driver: overlay |
Запускаем gitlab
1 | docker-compose up -d |
Теперь копируем созданный ранее бэкап из /var/opt/gitlab/backups/ в докер контейнер gitlab по такому же пути /var/log/gitlab.
В данном случаем
1 2 | cd /var/opt/gitlab/backups/ docker cp 1528576316_2018_06_10_10.6.4_gitlab_backup.tar gitlab_gitlab_1:/var/opt/gitlab/backups/ |
Опционально: изменим права доступа и владельца файла с бекапом внутри контейнера, на случай если он скопировался неправильно:
1 | docker exec -ti -u 0 gitlab_gitlab_1 bash |
1 2 3 | cd /var/opt/gitlab/backups/ chmod 600 * chown git:git * |
Находясь в контейнере запускаем процедуру восстановление данных из бекапа:
1 2 3 4 5 | gitlab-ctl stop unicorn gitlab-ctl stop sidekiq gitlab-rake gitlab:backup:restore BACKUP=1528576316_2018_06_10_10.6.4 gitlab-ctl start gitlab-rake gitlab:check SANITIZE=true |
После восстановления проверим возможность логина в браузере, если все работает, то идем дальше.
Останавливаем и удаляем docker-контейнер с GitLab:
1 | cd /docker-compose/SWARM/gitlab |
1 | docker-compose down |
Правим docker-compose. Изменим версию gitlab на последнюю.
1 | nano docker-compose.yml |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | #docker stack deploy --compose-file=docker-compose.yml gitlab version: '3.4' services: gitlab: image: gitlab/gitlab-ce:latest ports: - "10080:80" - "2224:22" - "4567:4567" volumes: - "./data/gitlab/config:/etc/gitlab" - "./data/gitlab/logs:/var/log/gitlab" - "./data/gitlab/data:/var/opt/gitlab" environment: GITLAB_OMNIBUS_CONFIG: | external_url 'http://git.itс-life.ru' gitlab_rails['gitlab_shell_ssh_port'] = 2224 networks: gitlab-net: aliases: - gitlab.itc-life.ru deploy: #mode: replicated replicas: 1 # service resource management resources: # Hard limit - Docker does not allow to allocate more limits: cpus: '2' memory: 3096M # Soft limit - Docker makes best effort to return to it reservations: memory: 16M # service restart policy restart_policy: condition: on-failure delay: 5s max_attempts: 3 window: 20s # service update configuration update_config: parallelism: 1 delay: 10s failure_action: continue monitor: 5s max_failure_ratio: 0.3 # placement constraint - in this case on 'worker' nodes only placement: constraints: [node.role == manager] ##NETWORKS networks: gitlab-net: driver: overlay |
Ну а теперь запускаемся, только в режиме swarm.
1 | docker stack deploy -c docker-compose.yml gitlab |