gitlab 安装、备份与还原及常见设置

gitlab 安装、备份与还原及常见设置

安装

docker run \
    --hostname gitlab.example.com \
    --restart always \
    --name 'gitlab' \
    -d \
    -p 443:443 \
    -p 80:80 \
    -p 22:22 \
    -v gitlab_config:/etc/gitlab \
    -v gitlab_log:/var/log/gitlab \
    -v gitlab_data:/var/opt/gitlab \
    gitlab/gitlab-ce:latest

配置文件

  • 所有设置 https://docs.gitlab.com/omnibus/settings/README.html
  • 配置位于文件/etc/gitlab/gitlab.rb
  • /var/opt/gitlab/gitlab-rails/etc文件夹的配置文件则是分开的,清晰明了,可用于查看。database.yml是数据库配置文件,gitlab.yml是应用配置
  • 注意gitlab.yml的开头提示此文件由gitlab-ctl管理。手动更改将删除!要更改以下内容,请编辑/etc/gitlab/gitlab.rb,运行“sudo gitlab-ctl reconfigure”。,所以最好不要直接编辑这个页面
  • 如何重启 gitlab,执行sudo gitlab-ctl restart重启。只有通过Omnibus packages安装的,使配置生效命令sudo gitlab-ctl reconfigure才有效。经过实践,发现修改gitlab.yml需要重启才能生效,而修改gitlab.rb则只需要重新配置,并且会覆盖gitlab.yml的设置
  • 更改 gitlab.yml 和 application.yml 设置,这里说明了gitlab.rbgitlab.yml等配置文件的关系,由gitlab.rb生成配置文件,执行命令sudo gitlab-ctl reconfigure使更改生效。
  • gitlab.rb 模板
  • gitlab.yml 模板

仓库主机地址、服务器地址、wiki 文件上传地址

访问内部 PostgreSQL

  • 参考教程 https://www.cnblogs.com/UniqueColor/p/7767012.html
  • 深入 PostgreSQL 身份验证 https://www.tuicool.com/articles/bQfmUr
  • 以下按默认情况处理,并做适当解释
  • 查看 gitlab 数据库配置文件 cat /var/opt/gitlab/gitlab-rails/etc/database.yml
  • 查看数据库验证方式配置文件 cat /var/opt/gitlab/postgresql/data/pg_hba.conf
  • 查看用户 cat /etc/passwd
  • 切换登录用户su - gitlab-psql,由于默认配置是使用 peer 方式认证,认证工作完全交给系统,所以系统用户名必须与登录数据库用户名一致。
  • 参数加横杠有两个作用,第一是切换用户后同时切换到工作目录,第二是添加该用户相关环境变量,否则 psql 无法使用
  • 根据数据库配置填写数据库登录主机以及登陆的数据库 psql -h /var/opt/gitlab/postgresql -d gitlabhq_production
  • 以下是数据库操作命令
  • 查看帮助 \h
  • 查看数据库列表 \l
  • 查看多表 \dt
  • 查看单表 \d users
  • 查看索引 \di
  • 执行查询 select id,encrypted_password,name,username from users;
  • 退出 \q
  • 退出当前登录用户 exit

备份与还原

备份

# 挂载gitlab容器的所有卷到alpine容器,将容器backup目录映射到当前目录,执行备份命令,依次备份所有数据即可
$ cd /var/opt/gitlab
$ docker run --rm --volumes-from gitlab -v $(pwd):/backup alpine tar cvf /backup/backup.tar .
  • 因为要备份多个文件夹,可进入交互命令环境进行操作

还原

  • 得到备份数据的压缩文件,创建卷之后还原即可。还原的时候多一步创建卷,类似创建 gitlab 容器时的操作,得到数据卷,再执行类似备份的操作,运行另外的容器挂载新创建容器的卷,只不过压缩变成解压
# 创建一个匿名卷,挂载到alpine容器的`/var/opt/gitlab`目录
$ docker run -v /var/opt/gitlab --name alpine_data alpine /bin/sh

# 挂载容器alpine_data的数据卷,进入命令交互环境
$ docker run -it --rm --volumes-from alpine_data -v $(pwd):/backup alpine sh

# 在容器内执行下面的还原命令
$ cd /var/opt/gitlab && tar xvf /backup/backup.tar"
  • 进入容器之后,还原多个压缩包即可,提前创建好对应数据卷

运行

  • 运行过程同安装过程,挂载上面的数据卷即可,也可以直接解压到主机目录,进行主机目录映射
  • 注意一定要确认解压的文件夹的相对路径是否正确,这是可能会犯的一个错。因为上面的打包过程,很可能把数据打包成带路径/var/opt/gitlab的格式,导致容器中的数据位于/var/opt/gitlab/var/opt/gitlab

svn 迁移到 git

svn log -q | awk -F '|' '/^r/ {sub("^ ", "", $2); sub(" $", "", $2); print $2" = "$2" <"$2">"}' | sort -u > users.txt
user1 = user1 <user1>
user2 = user2 <user2>
user3 = user3 <user3>
  • 从 svn clone 到本地git svn clone http://svn-server:port/project/trunk/path1/path2 --no-metadata --authors-file=users.txt projectname
  • --authors-file参数指定提交者信息映射文件,--no-metadata去掉多余元数据信息
  • 抓一份.gitignore模板下来,mkdir .gitignore && wget -O .gitignore/VisualStudio.gitignore https://raw.githubusercontent.com/github/gitignore/master/VisualStudio.gitignore
  • 添加忽略文件
$ cd projectname
$ cat ../.gitignore/VisualStudio.gitignore >> .gitignore && \
git svn show-ignore >> .gitignore
  • 添加文件 .gitignore到版本控制 git add .gitignore
  • 本地提交 git commit -a -m 'add .gitignore'
  • 添加远程仓库地址 git remote add origin http://git-server:port/project.git
  • 推送本地 master 分支到远程,-u参数会让 master 关联远程分支 git push -u origin master
  • 其他操作:从 svn 更新 git svn rebase、提交到 svn git svn dcommit

总结

  • gitlab 是个内存大户,因此主机内存最好大于 2G,并做资源限制,否则占用了过高内存,会导致 gitlab 服务 503,甚至整个主机都变卡
  • 此系统一开始装在内网的 win7 主机,使用docker for windows安装,后因需要迁移到服务器,只需要迁移数据卷中数据即可,十分方便
  • 由 svn 迁移到 git,使用 git 自带的git svn clone url即可方便分离 svn 中的大项目为一个个单独的项目。因为原来的存法是所有项目在某一类文件夹,各个项目的提交记录混在一起,不方便查看,而且项目多了不方便管理
posted @ 2019-09-19 11:45  笑笑🤞  阅读(...)  评论(...编辑  收藏