CentOS 7 下 Gitlab 汉化安装部署

hti

        GitLab简介
GitLab是利用Ruby On Rails开发的一个开源版本管理系统，实现了一个自托管的Git项目仓库，是集代码托管，测试，部署于一体的开源git仓库管理软件，可通过web界面来进行访问公开的或私人项目。与Github类似，GitLab能够浏览代码，管理缺陷和注释。可以管理团队对仓库的访问，它非常易于浏览提交过的版本，并提供一个文件历史库。它还提供一个代码片段收集功能可以轻松实现代码复用，便于日后需要的时候查找。
Git的家族成员：
                         Git：是一种版本控制系统，是一个命令，是一种工具。
                         Gitlib：是用于实现Git功能的开发库。
                         Github：是一个基于Git实现的在线代码托管仓库，公开项目是免费的，也可以付费创建私人项目。
                         GitLab：是一个基于Git实现的在线代码仓库托管软件，可以用GitLab搭建一套类似Github的系统。
GitLab对硬件还是有一定要求的，1核心的CPU基本上可以满足需求，大概支撑100个左右的用户，不过在运行GitLab网站的同时还需要运行多个后台job，就会显得有点捉襟见肘了。需要至少4GB的可寻址内存（RAM交换）来安装和使用GitLab，操作系统和任何其他正在运行的应用程序也将使用内存，因此请记住，在运行GitLab之前，您至少需要4GB的可用空间，如果使用更少的内存，GitLab将在重新配置运行期间给出奇怪的错误。
一、环境准备
  操作系统：CentOS 7
CPU：2核
内存：4G
　　 说明：硬件根据我查到的资料( https://docs.gitlab.com/ce/install/requirements.html )，结合使用人数的考虑，故选择了2核4G的配置，实际配置时需要根据gitlab使用人数的负载来决定硬件配置。
1.1更新yum源

yum install wget                                #下载wget
mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.bak     #备份yum源
wget -O /etc/yum.repo.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo    #下载yum源
yum clean all &&  yum makecache                #更新yum源

二、获取gitlab汉化包
说明：gitlab中文社区版的项目，v7-v8.8是由Larry Li发起的“GitLab 中文社区版项目”（https://gitlab.com/larryli/gitlab），从 v8.9 之后，@xhang 开始继续该汉化项目（https://gitlab.com/xhang/gitlab）。
yum install -y git2.1 克隆获取汉化版本库
下载最新的汉化包（汉化包需与安装的Gitlab版本一致）
git clone https://gitlab.com/xhang/gitlab.git

如果是要下载指定版本的汉化包，需要加上指定版本的分支，比如我想下载11.5.6，可以运行下面的语句
git clone https://gitlab.com/xhang/gitlab.git -b v11.5.3版本的-zh本次下载使用的是11.5.3



2.2 查看该汉化补丁的版本
cat gitlab/VERSION
可以看到现在的版本是11.5.3


三、部署社区版Gitlab
3.1安装前准备选项
   安装gitlab的依赖项

yum install -y curl openssh-server openssh-clients postfix cronie policycoreutils-python   #10.x以后开始依赖policycoreutils-python，我之前在使用9.x时还没有依赖该项。

  启动postfix，并设置为开机启动

systemctl start postfix
systemctl enable postfix

设置防火墙   ,也可以直接关闭
firewall-cmd --add-service=http --permanent firewall-cmd --reload

3.2获取Gitlab的rpm包


查看清华开源镜像站，查找11.5.3的rpm包。
https://mirrors .tuna.tsinghua.edu.cn /gitlab-ce/yum/el7/

获取rpm包
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-11.5.3-ce.0.el7.x86_64.rpm

当然也可以使用官方的网址进行下载，速度可能会很慢
官方下载：https://packages.gitlab.com/gitlab/gitlab-ce/
　　3.3安装RPM包

rpm -ivh gitlab-ce-11.5.3-ce.0.el7.x86_64.rpm

根据提示，继续执行指令配置gitlab。
gitlab-ctl reconfigure
3.5修改配置文件gitlab.rb
vim /etc/gitlab/gitlab.rb
将external_url变量的地址修改为gitlab所在CentOS的ip地址。（有域名的话可以配成域名）。




3.6 配置邮箱

vim /etc/gitlab/gitlab.rb
邮箱配置：
gitlab_rails[ 'smtp_enable' ] =   true
gitlab_rails[' smtp_address '] =   " smtp.mxhichina.com "
gitlab_rails[' smtp_port '] = 465
gitlab_rails[' smtp_user_name '] =   " xxxxxxxxx"
gitlab_rails[' smtp_password '] =   " xxxxxxxx "
gitlab_rails[' smtp_authentication '] =   " login "
gitlab_rails[' smtp_enable_starttls_auto '] =   true
gitlab_rails[' smtp_tls '] =   true
gitlab_rails[' gitlab_email_from '] =   ' xxxxxxxxx '
因为修改了配置文件，故需要重新加载配置内容。

gitlab-ctl reconfigure
gitlab-ctl restart
3.7 查看Gitlab版本
head -1 /opt/gitlab/version-manifest.txt

四、覆盖汉化包
注：汉化后使用root用户登录可能会出现汉化不完全现象，创建其他用户后使用非root用户登录即可正常显示
停止Gitlab服务
gitlab-ctl stop

切换到Gitlab汉化包所在的目录（即步骤二获取的汉化版Gitlab）
cd /root/gitlab

　　比较汉化标签和原标签，导出 patch 用的 diff 文件到/root下
git diff v11.5.3 v11.5.3-zh > ../11.5.3-zh.diff
　　回到/root目录
cd　　将11.5.3-zh.diff作为补丁更新到Gitlab中

yum install patch -y
patch -d /opt/gitlab/embedded/service/gitlab-rails -p1 < 11.5.3-zh.diff　　启动Gitlab

gitlab-ctl start 重新配置并重启Gitlab

gitlab-ctl reconfigure
gitlab-ctl restart　　还有一种简单的运用中文补丁的方式，首先关闭服务

gitlab-ctl stop　　复制汉化包内容至Gitlab目录内覆盖
cp -rf gitlab /*  /opt/gitlab/embedded/service/gitlab-rails/复制可能出现如下提示，可以不用理会。

　　 重新配置并重启Gitlab

gitlab-ctl reconfigure
gitlab-ctl restart
五、设置管理员密码
　　管理员账号登录的用户名：root
　　（虽然登录后管理员的用户名为Administrator，但是实际登录的用户名是root）
浏览器访问gitlab所在的ip，输入密码后点击 “Change your password”（如果进行汉化，点击“修改密码”）。






六、修改默认端口
　　有时，需要修改默认端口，保证不与服务器其他端口相冲突
6.1 修改 nginx 端口 (默认80，与其他端口冲突时修改)
vim /etc/gitlab/gitlab.rb

按照如下修改

nginx['listen_port'] = 8081
vim /var/opt/gitlab/nginx/conf/gitlab-http.conf
server {
  listen *:8081;
.
.
.
  if ($http_host = &quot;&quot;) {
    set $http_host_with_default &quot;192.168.99.65:8081&quot;;
  }



6.2 修改 unicorn 端口 (默认8080，可能会与Tomcat端口冲突，冲突时修改)
　　注：访问出现 502 错误时大多数原因是该端口未被监听导致

vim /etc/gitlab/gitlab.rb
unicorn['port'] = 8089
vim /var/opt/gitlab/gitlab-rails/etc/unicorn.rb
listen &quot;127.0.0.1:8089&quot;, :tcp_nopush => true

6.3 重新配置并重启Gitlab

gitlab-ctl reconfigure
gitlab-ctl restart
　　注：重启服务有延时，unicorn 端口需要耐心等待一会才能被监听
netstat -tunlp








七、GitLab的命令
语法:
gitlab-ctl command (subcommand)

Service Management Commands
start	启动所有服务
stop	关闭所有服务
restart	重启所有服务
status	查看所有服务状态
tail	查看日志信息
service-list	列举所有启动服务
graceful-kill	平稳停止一个服务

例子：

1 2 3 4 5 6 7 8 9 10 11	#启动所有服务 [root@gitlab ~] # gitlab-ctl start #启动单独一个服务 [root@gitlab ~] # gitlab-ctl start nginx #查看日志，查看所有日志 [root@gitlab ~] # gitlab-ctl tail #查看具体一个日志,类似tail -f [root@gitlab ~] # gitlab-ctl tail nginx
General Commands
help		帮助
reconfigure		修改配置文件之后，需要重新加载下
show-config		查看所有服务配置文件信息
uninstall		卸载这个软件
cleanse		删除gitlab数据，重新白手起家

例子：

gitlab-ctl show-config     #显示所有服务配置文件
gitlab-ctl uninstall    #卸载gitlab