gitlab 搭建 备份 升级 迁移恢复

gitlab搭建

1.安装依赖项

suo apt update
sudo apt upgrade -y
sudo apt install ca-certificates curl openssh-server postfix

2.添加gitlab-ce存储库

curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

3.安装gitlab-ce

sudo apt update

sudo EXTERNAL_URL="http://gitlab.example.com" apt -y install gitlab-ce

 在执行命令之前,将gitlab.example.com替换为你的实际域名。完成后,通过运行以下命令启动GitLab实例:


sudo gitlab-ctl reconfigure

配置后应启动所有的GitLab服务:

gitlab 备份

停止用户连接

gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq
gitlab-ctl stop nginx

创建备份

gitlab-rake gitlab:backup:create

如果出错请检查权限问题 我的是默认root
可以加sudo重新试一下

gitlab升级

gitlab普通升级就正常升级就可以了
 升级不能跨越大版本号,因此只能升级到当前大版本号到最高版本,
方可升级到下一个大版本号

如果是跨大版本升级要严格按照官方指导的升级顺序进行
参考:
https://docs.gitlab.com/ce/policy/maintenance.html

先停止用户连接
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq
gitlab-ctl stop nginx

创建备份:
gitlab-rake gitlab:backup:create

然后安装升级
例如我从清华软件源下载好的deb安装包
直接dpkg -i 安装就行了
rpm包也是
也可以直接在线升级
完事重启
sudo gitlab-ctl restart

gitlab迁移恢复

1.执行备份数据
2.在目标机器中搭建与执行备份相同版本的gitlab
版本一定要相同
3.将备份的tar包复制到目标机器备份目录
 默认路径为:/var/opt/gitlab/backups/
4.恢复数据

依然要把这些服务停掉
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq
gitlab-ctl stop nginx

然后执行
gitlab-rake gitlab:backup:restore BACKUP=备份文件gitlab_backup.tar前面的数字

正常情况下就是以上这些步骤了
如果你整个过程顺顺利利的那么到这里就结束了

但是我的过程中充满了曲折
以下是我遇到的一些错误
仅以记录供参考


处理gitlab升级时的错误

错误信息
错误原因:端口占用
修改默认端口
找到gitlab.rb这个配置文件
external_url 'http://你的域名:8082'
把最后的端口修改成别空的端口
使配置生效

gitlab-ctl reconfigure

重新启动GitLab

gitlab-ctl restart
即可生效

备份时遇到的错误

Dumping database ... 
Dumping PostgreSQL database gitlabhq_production ... pg_dump: [archiver (db)] connection to database "gitlabhq_production" failed: could not connect to server: No such file or directory
    Is the server running locally and accepting
    connections on Unix domain socket "/var/opt/gitlab/postgresql/.s.PGSQL.5432"?
[FAILED]
Backup failed
原因:

postgresql 没有启动
参考https://www.tlanyan.me/deal-gitlab-upgrade-error/

解决办法
sudo gitlab-ctl start postgresql

reconfigure过程中的一个错误

  * execute[/opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8] action run
    [execute] The files belonging to this database system will be owned by user "gitlab-psql".
              This user must also own the server process.
              
              initdb: invalid locale settings; check LANG and LC_* environment variables
    
    ================================================================================
    Error executing action `run` on resource 'execute[/opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8]'
    ================================================================================
    
    Mixlib::ShellOut::ShellCommandFailed
    ------------------------------------
    Expected process to exit with [0], but received '1'
    ---- Begin output of /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 ----
    STDOUT: The files belonging to this database system will be owned by user "gitlab-psql".
    This user must also own the server process.
    STDERR: initdb: invalid locale settings; check LANG and LC_* environment variables
    ---- End output of /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 ----
    Ran /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 returned 1
    
    Resource Declaration:
    ---------------------
    # In /opt/gitlab/embedded/cookbooks/cache/cookbooks/postgresql/recipes/enable.rb
    
     80: execute "/opt/gitlab/embedded/bin/initdb -D #{node['postgresql']['data_dir']} -E UTF8" do
     81:   user postgresql_username
     82:   not_if { pg_helper.bootstrapped? }
     83: end
     84: 
    
    Compiled Resource:
    ------------------
    # Declared in /opt/gitlab/embedded/cookbooks/cache/cookbooks/postgresql/recipes/enable.rb:80:in `from_file'
    
    execute("/opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8") do
      action [:run]
      default_guard_interpreter :execute
      command "/opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8"
      backup 5
      declared_type :execute
      cookbook_name "postgresql"
      recipe_name "enable"
      user "gitlab-psql"
      domain nil
      not_if { #code block }
    end
    
    System Info:
    ------------
    chef_version=14.13.11
    platform=debian
    platform_version=9.9
    ruby=ruby 2.6.3p62 (2019-04-16 revision 67580) [x86_64-linux]
    program_name=/opt/gitlab/embedded/bin/chef-client
    executable=/opt/gitlab/embedded/bin/chef-client
    

Running handlers:
There was an error running gitlab-ctl reconfigure:

execute[/opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8] (postgresql::enable line 80) had an error: Mixlib::ShellOut::ShellCommandFailed: Expected process to exit with [0], but received '1'
---- Begin output of /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 ----
STDOUT: The files belonging to this database system will be owned by user "gitlab-psql".
This user must also own the server process.
STDERR: initdb: invalid locale settings; check LANG and LC_* environment variables
---- End output of /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 ----
Ran /opt/gitlab/embedded/bin/initdb -D /var/opt/gitlab/postgresql/data -E UTF8 returned 1

Running handlers complete
Chef Client failed. 6 resources updated in 07 seconds
解决办法
export LC_CTYPE=en_US.UTF-8
export LC_ALL=en_US.UTF-8
sudo dpkg-reconfigure locales
reconfigure过程中的另一个错误

在升级完成 执行gitlab-ctl reconfigure的时候出现

Error executing action `run` on resource 'execute[initctl status gitlab-runs
解决办法

参照的这个
http://www.doc88.com/p-2542809540436.html
我也没看太懂原理
反正好使 回头再研究

截图

至此 gitlab总算启动起来了
感谢google&baidu各路大神
以上

推荐阅读更多精彩内容