GitLab 详细安装及使用教程
GitLab安装和使用
GitLab基本介绍
GitLab是利用Ruby on Rails一个开源的版本管理系统,实现一个自托管的Git项目仓库,可通过Web界面进行访问公开的或者私人项目。
与Github类似,GitLab能够浏览源代码,管理缺陷和注释。可以管理团队对仓库的访问,它非常易于浏览提交过的版本并提供一个文件历史库。
团队成员可以利用内置的简单聊天程序(Wall)进行交流。
它还提供一个代码片段收集功能可以轻松实现代码复用,便于日后有需要的时候进行查找。
Git的家族成员
Git:是一种版本控制系统,是一个命令,是一种工具。
Gitlib:是用于实现Git功能的开发库。
Github:是一个基于Git实现的在线代码托管仓库,包含一个网站界面,向互联网开放。
GitLab:是一个基于Git实现的在线代码仓库托管软件,你可以用gitlab自己搭建一个类似于Github一样的系统,
一般用于在企业、学校等内部网络搭建git私服。
Gitlab的服务构成
Nginx:静态web服务器。
gitlab-shell:用于处理Git命令和修改authorized keys列表。
gitlab-workhorse: 轻量级的反向代理服务器。
logrotate:日志文件管理工具。
postgresql:数据库。
redis:缓存数据库。
sidekiq:用于在后台执行队列任务(异步执行)。
unicorn:An HTTP server for Rack applications,GitLab Rails应用是托管在这个服务器上面的。
GitLab工作流程
GitLab Shell
GitLab Shell有两个作用:为GitLab处理Git命令、修改authorized keys列表。
当通过SSH访问GitLab Server时,GitLab Shell会:
限制执行预定义好的Git命令(git push, git pull, git annex)
调用GitLab Rails API 检查权限
执行pre-receive钩子(在GitLab企业版中叫做Git钩子)
执行你请求的动作 处理GitLab的post-receive动作
处理自定义的post-receive动作
当通过http(s)访问GitLab Server时,工作流程取决于你是从Git仓库拉取(pull)代码还是向git仓库推送(push)代码。
如果你是从Git仓库拉取(pull)代码,GitLab Rails应用会全权负责处理用户鉴权和执行Git命令的工作;
如果你是向Git仓库推送(push)代码,GitLab Rails应用既不会进行用户鉴权也不会执行Git命令,它会把以下工作交由GitLab Shell进行处理:
调用GitLab Rails API 检查权限
执行pre-receive钩子(在GitLab企业版中叫做Git钩子)
执行你请求的动作
处理GitLab的post-receive动作
处理自定义的post-receive动作
GitLab Workhorse
GitLab Workhorse是一个敏捷的反向代理。它会处理一些大的HTTP请求,比如文件上传、文件下载、Git push/pull和Git包下载。
其它请求会反向代理到GitLab Rails应用,即反向代理给后端的unicorn。
Gitlab环境部署
环境要求:内存不低于2G
1.方法一:通过yum源安装:
1.1 配置yum源
vim /etc/yum.repos.d/gitlab-ce.repo
复制以下内容:
[gitlab-ce] name=gitlab-ce baseurl=http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el6 Repo_gpgcheck=0 Enabled=1 Gpgkey=https://packages.gitlab.com/gpg.key
1.2、更新本地yum缓存
sudo yum makecache
1.3、安装GitLab社区版
sudo yum install gitlab-ce #自动安装最新版 sudo yum install gitlab-ce-x.x.x #安装指定版本
2.方法二:通过rpm包进行安装
2.1 下载rpm包
gitlab通过下载rpm包集成了它所需要的软件,简化安装步骤,rpm包可以从官网上或清华镜像源获取
https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/.
下载最新的版本:https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-12.4.2-ce.0.el7.x86_64.rpm
[root@otrs004097 opt]``# wget [root@otrs004097 opt]``# rpm -ivh gitlab-ce-12.4.2-ce.0.el7.x86_64.rpm ``或者``[root@otrs004097 opt]``# yum localinstall -y gitlab-ce-12.4.2-ce.0.el7.x86_64.rpm
2.2 修改配置
[root@otrs004097 ~]# vim /etc/gitlab/gitlab.rb external_url 'http://192.168.4.97' [root@otrs004097 ~]# gitlab-ctl reconfigure #####重新加载配置
注意:要保留8080端口否则会报错的。
[root@otrs004097 ~]# vim /var/opt/gitlab/gitlab-rails/etc/unicorn.rb listen "127.0.0.1:8080", :tcp_nopush => true [root@otrs004097 ~]# gitlab-ctl reconfigure #####重新加载配置
备注:gitlab的守护进程是会默认开启nginx的,如果想要关闭,可以尝试一下操作
gitlab-ctl stop nginx
gitlab-ctl restart nginx
如果想要释放资源,关闭gitlab时,可以尝试一下操作
gitlab-ctl stop
GitLab常用命令
sudo gitlab-ctl start # 启动所有 gitlab 组件; sudo gitlab-ctl stop # 停止所有 gitlab 组件; sudo gitlab-ctl restart # 重启所有 gitlab 组件; sudo gitlab-ctl status # 查看服务状态; sudo gitlab-ctl reconfigure # 启动服务; sudo vim /etc/gitlab/gitlab.rb # 修改默认的配置文件; gitlab-rake gitlab:check SANITIZE=true --trace # 检查gitlab; sudo gitlab-ctl tail # 查看日志;
GitLab使用
登录GitLab
在浏览器的地址栏中输入ECS服务器的公网IP即可登录GitLab的界面,第一次登录使用的用户名和密码为 root 和 5iveL!fe。
2、首次登录会强制用户修改密码。密码修改成功后,输入新密码进行登录。
创建Project
1、安装Git工具
linux:安装Git,使用自带的源安装。
yum install git
2、生成密钥文件
使用ssh-keygen生成密钥文件**.ssh/id_rsa.pub**。
3.在GitLab的主页中新建一个Project
4.添加ssh key
导入步骤2中生成的密钥文件内容:
ssh key添加完成:
7、点击项目,查看ssh地址和http地址
项目地址,该地址在进行clone操作时需要用到:
简单配置
1、配置使用Git仓库的人员姓名
git config --global user.name "MyGit"
2、配置使用Git仓库的人员email
填写自己的公司邮箱
git config --global user.email "support@test.com"
3、克隆项目
在本地生成同名目录,并且目录中会有所有的项目文件
git clone git@iZbp1h7fx16gkr9u4gk8v3Z:root/test.git
上传文件
1、创建目录,并进入到项目目录
mkdir /root/test cd /root/test
2、创建需要上传到GitLab中的目标文件
echo “test” > /root/test.sh
3、将目标文件或者目录拷贝到项目目录下
cp /root/test.sh ./
4、将test.sh文件加入到索引中
git add test.sh
5、将test.sh提交到本地仓库
git commit -m “test.sh”
6、将文件同步到GitLab服务器上
git push -u origin master
7、查看代码
在网页中查看上传的test.sh文件已经同步到GitLab中
目录 返回
首页