CICD环境搭建7(2)-gitlab操作手册

安装环境

系统环境：centos7.5
前置条件：gitlab-ce
软件下载目录：/software
软件安装目录：/opt
软件版本：

一、安装gitlab汉化包

1.安装git

yum install -y git

2.克隆获取汉化版本库

git clone https://gitlab.com/xhang/gitlab.git

3.查看该汉化补丁的版本

cat gitlab/VERSION

4.切换到gitlab汉化包所在的目录（即第二步克隆的汉化包）

#先停止gitlab服务
gitlab-ctl stop
cd /root/gitlab

5.比较汉化标签和原标签，导出 patch 用的 diff 文件到/root下

git diff v11.7.5 v11.7.5-zh > ../11.7.5-zh.diff

6.回到/root目录，可以看到生成的11.7.5-zh.diff

cd /root 或者 cd ../

7.将11.7.5-zh.diff作为补丁更新到gitlab中

yum install patch -y
#gitlab的安装路径/opt/gitlab
patch -d /opt/gitlab/embedded/service/gitlab-rails -p1 < 11.7.5-zh.diff

在运行的过程中可能会出现以下提示信息：

这是因为汉化包和gitlab版本的区别，也就是汉化包没有覆盖的地方，一直点回车就可以。

8.启动gitlab

gitlab-ctl start

9.重新配置gitlab

vim /etc/gitlab/gitlab.rb
#需要重新加载配置内容，使修改生效
gitlab-ctl reconfigure
gitlab-ctl restart

至此，gitlab的汉化工作完成。

二、gitlab基础操作

1.登陆gitlab

在浏览器的地址栏中http://localhost:端口号，即可登录GitLab的界面，第一次登录使用的用户名和密码为 root 和 5iveL!fe。

2.修改密码

首次登录会强制用户修改密码。密码修改成功后，输入新密码进行登录。

三、项目管理

1.创建项目

第一次登录gitlab，会显示如下界面，点击创建项目，跳转至新建项目界面

2.上传本地项目到gitlab仓库

第一步：在本地创建密钥
桌面右键，如果本地已经安装了git.exe,则选择“Git Bash Here”，如果没有显示，去安装就行啦


提示 “ No such file or directory”，可以手动的创建一个 .ssh文件夹即可

mkdir ~/.ssh

然后，参照刚才创建项目的Git global setup，配置全局的name和email

git config --global user.name "姓名"
git config --global user.email "邮箱"

随后，生成Gitlab的公钥

 ssh-keygen -t rsa -C "XXXXXXXXX@qq.com"

最后，生成两个文件：id_rsa和id_rsa.pub ，把id_rsa.pub里的内容粘贴到gitlab密钥中，标题会默认捕获邮箱账号。

密钥创建成功

第二步：上传本地项目到gitlab

右键要上传的项目，选择Git Bash Here

首先，检查该项目是否已经与其他仓库建立连接
然后，输入以下命令

#初始化git    
git init                      
#建立远程仓库连接
git remote add origin git@10.20.126.100:lijingyue/maventest.git    
#添加文件
git add .   
#提交               
git commit  -m "mavenTest" 
#push到远程仓库        
git push -u origin master 

项目上传成功

3.编辑或删除项目

进入需要编辑或删除的项目，选择设置->Advanced->展开

四、用户管理（管理员使用，非管理员跳过此步骤）

1.新建用户

点击顶端的Admin Area按钮，选择Users->新建用户



点击“创建用户”，操作完成。

2.编辑或删除用户

五、组管理（管理员使用，非管理员跳过此步骤）

1.新建组

点击顶端的Admin Area按钮，选择Groups->New group

2.编辑或删除组

3.添加组成员

显示该用户组的成员

4.修改成员的权限（owner用户操作）

5.给项目分配成员或组权限

选择Members之后，在最下方可以看到已经添加的成员列表，如果还需要添加新的成员，在“选择要邀请的成员 ”的位置输入搜索的用户名即可，这里支持模糊匹配，“选择角色权限”，如果是开发人员选择Developer即可，只是查看权限，选择Guest即可

以上介绍的是项目添加成员的方法，还可以以组的方式来添加，比直接分配要好些，特别是对多用户和多项目的情况下，使用组可以节省很多时间。

六、配置过程中的坑

1.登陆报502的错

第一种可能，也是最坑的，那就是虚拟机内存不足，或者硬盘的空间不足以支撑gitlab运行；

第二种可能，端口号被占用

用命令 netstat -tunlp |grep 端口号，查看端口号是否被占用，若果被占用，修改配置文件修改端口号

  vim /etc/gitlab/gitlab.rb