gitlab介绍及使用

一、gitlab介绍

前边介绍过CentOS7下Gitlab的安装,下边就要说说Gitlab的使用

GitLab 是一个用于仓库管理系统的开源项目,使用Git作为代码管理工具,并在此基础上搭建起来的web服务。GitLab由乌克兰程序员DmitriyZaporozhets和ValerySizov开发,它由Ruby写成。后来,一些部分用Go语言重写,现今并在国内外大中型互联网公司广泛使用。

git、gitlab、GitHub的简单区别

git 是一种基于命令的版本控制系统,全命令操作,没有可视化界面

gitlab 是一个基于git实现的在线代码仓库软件,提供web可视化管理界面,通常用于企业团队内部协作开发

github 是一个基于git实现的在线代码托管仓库,亦提供可视化管理界面,同时免费账户和提供付费账户,提供开放和私有的仓库,大部分的开源项目都选择github作为代码托管仓库

二、gitlab相关命令

gitlab-ctl start #启动全部服务
gitlab-ctl restart#重启全部服务
gitlab-ctl stop #停止全部服务
gitlab-ctl restart nginx #重启单个服务,如重启nginx
gitlab-ctl status #查看服务状态
gitlab-ctl reconfigure #使配置文件生效
gitlab-ctl show-config #验证配置文件
gitlab-ctl uninstall #删除gitlab(保留数据)
gitlab-ctl cleanse #删除所有数据,从新开始
gitlab-ctl tail <service name>查看服务的日志
gitlab-ctl tail nginx  #如查看gitlab下nginx日志
gitlab-rails console  #进入控制台

三、gitlab常用组件

nginx:静态Web服务器

gitlab-shell:用于处理Git命令和修改authorized keys列表,gitlab是以Git为底层的,操作实际上最后就是调用gitlab-shell命令进行处理。

gitlab-workhorse:轻量级的反向代理服务器

logrotate:日志文件管理工具

postgresql:数据库

redis:缓存数据库

sidekiq:用于在后台执行队列任务(异步执行)

unicorn:GitLab Rails应用是托管在这个服务器上面的

查看服务状态:gitlab-ctl status,可以看到gitlab的依赖组件

四、gitlab安装目录

以下是gitlab常用的默认安装目录

gitlab组件日志路径:/var/log/gitlab

gitlab配置路径:/etc/gitlab/  路径下有gitlab.rb配置文件

应用代码和组件依赖程序:/opt/gitlab

各个组件存储路径: /var/opt/gitlab/

仓库默认存储路径   /var/opt/gitlab/git-data/repositories

版本文件备份路径:/var/opt/gitlab/backups/

nginx安装路径:/var/opt/gitlab/nginx/

redis安装路径:/var/opt/gitlab/redis

五、配置GitLab中的SSH key

1、查看是否已有SSH key

(1)桌面右键点击弹出,点击Git Bash进入命令行界面

(2)cat ~/.ssh/id_rsa.pub查看SSH秘钥是否存在,可以看到初次没有生成过


(3)生成过删除,重新生成,找到C:\Users\admin\.ssh,admin是当前用户名,删除以下文件

2、生成SSH 密钥 

ssh-keygen -t rsa -C "liyang@ultrapower.com.cn"

如下图,一路回车即可生成,会在C:\Users\admin\.ssh下生成基于rsa的公钥与私钥对

3、 添加SSH key到gitlab

1)查看公钥并复制

cat ~/.ssh/id_rsa.pub    #查看公钥,自己手动复制
cat ~/.ssh/id_rsa.pub | clip #或者直接复制到剪贴板

(2)登录gitlab,最右边下拉,点击“Settings”去User Setting页面

(3)点击左边的SSH Keys去添加

(4)把刚才复制的SSH Keys粘贴进去,点击Add key,添加即可

(5)添加成功如下,点击remove可以移除

(6)ssh -T git@"gitlab服务器地址",测试是否配置成功,成功如下

六、备份与恢复

可参看https://docs.gitlab.com/omnibus/settings/backups.html#creating-an-application-backup

1、备份应用

默认备份路径:/var/opt/gitlab/backups,备份格式:EPOCH_YYYY_MM_DD_GitLab_version_gitlab_backup.tar
如备份文件:1542603058_2018_11_19_11.4-ce_gitlab_backup.tar

需要git用户权限 

sudo chown git.git /var/opt/gitlab/backups/1542603058_2018_11_19_11.4-ce_gitlab_backup.tar

如果自定义备份路径,编辑/etc/gitlab/gitlab.rb,指定备份路径,完后执行gitlab-ctl reconfigure重新加载配置

gitlab_rails['backup_path'] = '/mnt/backups' 备份路径,自己指定
gitlab_rails['backup_keep_time'] = 604800  #每次备份保留时间,默认7天,可以省略

手动备份,生成 一次备份

sudo gitlab-rake gitlab:backup:create

 定时备份:cron -e添加定时,保存,重启定时服务/etc/init.d/crond restart

#周二到周六每天凌晨2点备份
0 0 2 ? * 2-6 gitlab-rake gitlab:backup:create

 

2、备份配置

gitlab配置默认在etc/gitlab,需要备份gitlab.rb和gitlab-secrets.json,为了方便,备份etc/gitlab文件夹即可

sudo crontab -e -u root  添加定时,保存,重启定时服务/etc/init.d/crond restart

#周二到周六每天凌晨2点备份,设置权限0077,压缩/etc/gitlab到/secret/gitlab/backups下,备份路径自定义
0 0 2 ? * 2-6  umask 0077; tar cfz /secret/gitlab/backups/$(date "+etc-gitlab-\%s.tgz") -C / etc/gitlab

3、恢复

可参看https://docs.gitlab.com/ce/raketasks/backup_restore.html#restore-for-omnibus-installations

 停止与连接 数据库有关的进程

sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq
# Verify是否停止
sudo gitlab-ctl status

  backup后边指定恢复的时间戳、版本

# This command will overwrite the contents of your GitLab database!
sudo gitlab-rake gitlab:backup:restore BACKUP=1542603058_2018_11_19_11.4-ce

 如果有必要恢复配置,gitlab.rb和gitlab-secrets.json,把备份的tar包恢复到/etc/gitlab路径下即可

 重启并检查服务

sudo gitlab-ctl restart  #重启服务
sudo gitlab-rake gitlab:check SANITIZE=true #检查恢复情况

七、gitlab-ci可持续集成

1、gitlab-ci简述

gitlab-ci全称gitlab continuous integration,就是可持续集成的意思。从gitlab8.0版本开始,GitLab-ci完全集成到GitLab本身中,并且默认情况下在所有项目上都启用,不用可以禁用掉(禁用见2共享runner中)。

若将gitlab-ci.yml文件添加到仓库的根目录,并将项目配置gitlab Runner使用,则每次commit或push都会触发CI pipeline。gitlab-ci.yml文件告诉GitLab runner怎么做。默认情况下,它运行一个pipeline ,有三个stage:buildtest,  deploy。没必要三stage都使用,没有用到的stage可以被忽略。

2、GitLab-Runner类型介绍

详情可参考https://docs.gitlab.com.cn/ee/ci/runners/README.html

runner有三种类型:Shared, specific and group Runners

 (1)共享runner:Shared runner适用于多个相似项目,其思想是:与其为每个项目分配一个特定runner,大部分时候这些runner事空闲的,即每个项目的runner一般不会同同时工作,不如让单个或少数Shared runner处理多个项目。shared runner使用公平队列处理作业,与使用FIFO的特定runner相比,可以防止项目创建数百个作业,占用所有可用shared runner的资源。

从GitLab 8.2开始,默认启用shared runners,无需手动开启,但是也可以在每个gitlab项目下的Settings ➔ CI/CD页面,通过“Disable shared Runners”按钮禁用。拥有管理员权限的用户可以注册且只能注册一个shared runner实例。

(2)特定runner:specific runner适用于特定要求的作业或者有特殊需求的项目。如果一个作业具有某些特定要求,您可以在中心设置特定的Runner,而不是所有Runner都如此。例如,如果你要部署某个特定项目,可以去Settings ➔ CI/CD页面获得令牌(上图中画红线处)为该项目设置一个specific runner。specific runner使用FIFO队列处理作业。

(3)组runner:group Runners适用于一组中有多个项目并且希望组内所有项目都访问一组Runner的情况。group Runners使用FIFO队列处理作业。可以去Settings ➔ CI/CD页面,点击Group CI/CD setting(即上图中右下角蓝字),进入下页,获取token

3、安装GitLab-Runner

详情可参考https://docs.gitlab.com/runner/install/

方式一

1、添加GitLab官方yum源

# For RHEL/CentOS/Fedora
 curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash

 2、安装最新版本runner

 # For RHEL/CentOS/Fedora,yum默认安装最新版本
 sudo yum install gitlab-runner
或者
# for RPM based systems #RPM安装指定版本,列出所有包含重复的版本,降序显示
 yum list gitlab-runner --showduplicates | sort -r
#如安装10.0.0-1
sudo yum install gitlab-runner-10.0.0-1

方式二

(1)下载

sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64

(2)添加可执行权限

 sudo chmod +x /usr/local/bin/gitlab-runner

(3)创建GitLab CI 用户

 sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

 (4)安装gitlab-runner服务

 #安装到/home/gitlab-runner下
 sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner

4、runner注册到CI

详情可参考https://docs.gitlab.com/runner/register/index.html

  1. runner注册命令:

     sudo gitlab-runner register
    
  2. 键入GitLab的URL:

     Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com )
     https://192.168.1.74:8080 #gitlab地址
    
  3. 键入Runner注册的token:

     Please enter the gitlab-ci token for this runner
     xxx    #进入runner的token凭证
    
  4. 键入Runner的描述, 之后也可以GitLab’s 可视化界面中更改

     Please enter the gitlab-ci description for this runner
     [hostame] my-runner   #runner的描述
    
  5. 键入Runner的标签, 之后也可以GitLab’s 可视化界面中更改

     Please enter the gitlab-ci tags for this runner (comma separated):
     my-tag    #runner标签,相当于名字,用于指定哪个runner运行作业
    
  6. 键入执行Runner executor的方式

     Please enter the executor: ssh, docker+machine, docker-ssh+machine, kubernetes, docker, parallels, virtualbox, docker-ssh, shell:
     shell   #选择执行runner的executor方式,这里没有使用docker等其他的,选shell
    

5、配置gitlab-ci.yml

详情可以参考https://docs.gitlab.com.cn/ee/ci/yaml/README.html

从从GitLab7.12版本,GitLab CI使用YAML文件(.gitlab-ci.yml项目配置),它放在仓库的根目录,定义如何构建项目

Pipeline:一次 Pipeline 其实相当于一次构建任务,里面可以包含多个流程,如安装依赖、运行测试、编译、部署测试服务器、部署生产服务器等流程

jobs:Jobs 表示构建工作,表示某个 Stage 里面执行的工作。我们可以在 Stages 里面定义多个 Jobs,这些 Jobs 会有以下特点:相同 Stage 中的 Jobs 会并行执行,相同 Stage 中的 Jobs 都执行成功时,该 Stage 才会成功;如果任何一个 Job 失败,那么该 Stage 失败,即该构建任务 (Pipeline) 失败

Stages:Stages表示构建阶段,说白了就是上面提到的流程。我们可以在一次 Pipeline 中定义多个 Stages,这些 Stages 会有以下特点:所有 Stages 会按照顺序运行,即当一个 Stage 完成后,下一个 Stage 才会开始;只有当所有 Stages 完成后,该构建任务 (Pipeline) 才会成功;如果任何一个 Stage 失败,那么后面的 Stages 不会执行,该构建任务 (Pipeline) 失败

# 定义 stages, stages 关键字来定义 Pipeline 中的各个构建阶段
stages:
  - build
  - test
  - deploy
# 定义 job,可多个
job 1:
  stage: build  #stage指定构建阶段
  script: make build dependencies #script是每个job执行的任务

job 2:
  stage: build
  script: make build artifacts

job 3:
  stage: test
  script: make test

job 4:
  stage: deploy
  script: make deploy

添加gitlab-ci.yml

去项目根目录下,点击 "Set up CI/CD"去配置gitlab-ci.yml

如下就可以配置了,配置完提交

6、启动gitlab-runner

sudo gitlab-runner start  #启动gitlab-runner

7、查看pipeline工作状态

去项目根路径下,点击“CI/CD》Pipelines”查看状态

如下可以看到pipeline工作状态

 失败后,找到问题后,也可以点击右边的“Run Pipeline” 重新运行

参考:https://docs.gitlab.com.cn/ee/ssh/README.html

参考:https://docs.gitlab.com.cn/ee/ci/quick_start/README.html

参考:https://docs.gitlab.com.cn/ee/ci/README.html

参考:https://docs.gitlab.com.cn/runner/

参考:http://www.cnblogs.com/zdqc/p/9666994.html

©️2020 CSDN 皮肤主题: 大白 设计师: CSDN官方博客 返回首页
实付0元
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值