GitLab的安装及使用教程

GitLab的安装及使用教程

GitLab简介

GitLab，是一个利用 Ruby on Rails 开发的开源应用程序，实现一个自托管的Git项目仓库，可通过Web界面进行访问公开的或者私人项目安装。 
它拥有与GitHub类似的功能，能够浏览源代码，管理缺陷和注释。可以管理团队对仓库的访问，它非常易于浏览提交过的版本并提供一个文件历史库。 
团队成员可以利用内置的简单聊天程序（Wall）进行交流。它还提供一个代码片段收集功能可以轻松实现代码复用，便于日后有需要的时候进行查找。

• 安装

1.配置yum源

vim /etc/yum.repos.d/gitlab-ce.repo

复制以下内容：

1.  [gitlab-ce]
2.  name=Gitlab CE Repository
3.  baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/
4.  gpgcheck=0
5.  enabled=1

2.更新本地yum缓存

yum makecache

3.安装GitLab社区版

yum install gitlab-ce #自动安装最新版本

注：若需安装指定版本，则添加版本号即可，即yum install gitlab-ce-x.x.x

4.开启GitLab

gitlab-ctl start

GitLab常用命令

gitlab-ctl start # 启动所有 gitlab 组件；

gitlab-ctl stop # 停止所有 gitlab 组件；

gitlab-ctl restart # 重启所有 gitlab 组件；

gitlab-ctl status # 查看服务状态；

gitlab-ctl reconfigure # 启动服务；（重新加载配置文件，在GitLab初次安装后可以使用，但是在业务环境中不可随意使用，reconfigure会把一些过去的config还原，导致修改的端口以及域名等都没有了。）

vim /etc/gitlab/gitlab.rb # 修改默认的配置文件；

gitlab-rake gitlab:check SANITIZE=true --trace # 检查gitlab；

sudo gitlab-ctl tail # 查看日志；

• GitLab使用

1.登录GitLab

在浏览器的地址栏中输入服务器的公网IP即可显示GitLab的界面。首次登录会强制用户修改密码。密码修改成功后，输入用户名和密码进行登录。

注：若无法访问，则可以使用ps -ef命令查看服务是否正常启动，若未启动， 则重新开启，若仍然启动不了，则可使用gitlab-ctl reconfigure（仅限初始环境下使用）命令启动服务， 然后再访问GitLab。

2.创建Project

登录成功后会出现如下页面：

3.修改域名

由于没有DNS服务器，无法进行域名解析，所以需要将域名修改为主机名，进入终端修改一下文件即可。

vim /opt/gitlab/embedded/service/gitlab-rails/config/gitlab.yml

1.   ## GitLab settings 
2. gitlab:
3.   ## Web server settings (note: host is the FQDN, do not include http://)
4.    host: 10.0.0.210
5.  port: 8888
6.  https: false

重启GitLab

gitlab-ctl restart

刷新GitLab页面查看是否修改成功

• GitLab的备份与恢复

1. GitLab创建备份

gitlab-rake gitlab:backup:create

使用以上命令会默认在/var/opt/gitlab/backups目录下创建一个名称类似为1520580592_2018_03_09_10.5.3_gitlab_backup.tar的压缩包, 这个压缩包就是Gitlab整个的完整部分, 其中开头的1520580592_2018_03_09_10.5.3是备份创建的日期。

2.删除project

点击创建的project页面下方的“Remove project”按钮，删除project。

此时已无project

3.GitLab恢复

停止相关数据连接服务

gitlab-ctl stop unicorn

gitlab-ctl stop sidekiq

从1520580592_2018_03_09_10.5.3编号备份中恢复

gitlab-rake gitlab:backup:restore BACKUP=1520580592_2018_03_09_10.5.3

启动Gitlab

gitlab-ctl start

4.查看GitLab页面中是否恢复project。

• Gitlab 修改备份文件默认目录

可以通过修改/etc/gitlab/gitlab.rb来修改默认存放备份文件的目录。

 vim /etc/gitlab/gitlab.rb

gitlab_rails['backup_path'] = "/mnt/gitlab/backup" >>修改文件路径即可

修改完成之后使用gitlab-ctl reconfigure命令重载配置文件即可。

注意：因为涉及到重新加载配置，reconfigure会把一些过去的config还原，导致修改的端口以及域名等都没有了。建议在服务安装之后即修改仓库默认路径，若后期业务中修改此项，会对业务造成一定的影响。若后期业务需修改此项，请提前做好准备，然后再修改配置文件中的相应参数。

重载配置文件之后会发现/mnt/gitlab/backup的权限发生变化

• 修改仓库的默认路径

修改配置文件,找到git_data_dirs

vim /etc/gitlab/gitlab.rb

1.  # git_data_dirs({
2.  # "default" => {
3.  # "path" => "/mnt/nfs-01/git-data"
4.  # }
5.  # })
6.  git_data_dir "/data/gitlab" >>此处添加自定义的仓库路径，目录需提前创建

在git_data_dir下面添加一句git_data_dir "/data/gitlab"

2.停止当前gitlab，重新加载配置

注意：仓库路径的修改会导致已有project的丢失，请提前进行备份，具体备份操作请参考上文“GitLab的备份与恢复”，然后再修改配置文件中的相应参数。

gitlab-ctl stop

gitlab-ctl reconfigure

3.重新加载后，会发现在/data/gitlab目录下多出一个repositories目录

4.最后启动gitlab即可

gitlab-ctl start

• GitLab服务端口修改

yum方式安装的GitLab的配置文件路径为/var/opt/gitlab/nginx/conf（其他安装方式的配置文件路径不一定相同，请自行查找）。

1、修改配置文件

vim /var/opt/gitlab/nginx/conf/gitlab-http.conf

1.  ###################################
2.  ## configuration ##
3.  ################################### 
4.  upstream gitlab-workhorse {
5.  server unix:/var/opt/gitlab/gitlab-workhorse/socket;
6.  }
7.  server {
8.  listen *:8888; >> 此处修改端口即可

2、重启服务

gitlab-ctl restart

3.访问ip:port，查看页面是否正常

注意1：端口修改之后，project中的IP也需要相应的修改，请参考上文“修改域名”，修改port参数即可。

注意2：执行gitlab-ctl reconfigure命令后，配置文件会重新加载，服务端口会重新恢复为默认端口80，所以，如需修改端口，请在上述两个步骤之后进行操作。

Gitlab部署中注意端口不要冲突。

文章转载：https://blog.csdn.net/qq_29281307/article/details/86503880

当然，我觉得这篇博客写的也特别好：

https://blog.csdn.net/duyusean/article/details/80011540

配置ssh的步骤：

https://blog.csdn.net/xyzchenxiaolin/article/details/51852333

以上是我的安装步骤，后期的配置和一些问题可以参照下面步骤：

        1.安装，看我自己的博客

         2.修改端口，不要冲突
        有时不仅需要修改external_url的端口，还要修改unicorn
        https://blog.csdn.net/fengchao2016/article/details/77851234
        3.修改git文件存放路径
        https://www.cnblogs.com/dieyaxianju/p/7586203.html
        4.设置发送邮件的功能
        参考链接：http://www.fayfox.com/post/39.html
        邮箱配置官方文档：https://docs.gitlab.com/omnibus/settings/smtp.html#mandrill
        安装后的测试：https://blog.csdn.net/yelllowcong/article/details/79939589
        如果测试不成功，请参照这篇文章：https://ruby-china.org/topics/20450（要将身份验证帐号和发件人保持一致。）