离线搭建gitlab & gitlab-runner

前言

离线搭建gitlab及gitlab-runner实现局域网的代码管理及版本控制、简单的CI测试。

运行环境及所需软件包

事先在物理机上准备好所需安装包，博主使用的是：

• 物理机：Windows10
• 虚拟机软件：VMware Workstation Pro 17.6.2(个人使用免费)
  官网：https://www.vmware.com (注册账号后可以下载最新版)
• 虚拟机：Centos7
  阿里云开源镜像站：https://mirrors.aliyun.com/centos/7/isos/x86_64/
• gitlab：15.9.1
  官网镜像网站：https://packages.gitlab.com/gitlab/gitlab-ce
  清华镜像网站：https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/
  官方文档网站：https://packagecloud.io/docs
• gitlab-runner：14.7.0
  清华镜像网站：https://mirrors.tuna.tsinghua.edu.cn/gitlab-runner/yum/el7/

  注：gitlab-runner版本不能高于gitlab版本

• 文件传输软件：WinSCP、FileZilla、FinalShell
  注：用于物理机向虚拟机传输文件，上面是博主常用的。原生命令或其他软件，只要是能达到物理机向虚拟机传输的目的 均可

  安装过程见下面步骤，仅供参考，过程图片较多，建议按需浏览

安装VMware

1. 安装步骤
2. 

安装CentOS7虚拟机

1. 安装步骤
2. 安装ssh服务

搭建gitlab服务

1. 把gitlab-ce的rpm包传至该虚拟机中
   1. 安装步骤
2. 使用rpm命令安装gitlab-ce：rpm -ivh /.../gitlab-ce-15.9.1-ce.0.el7.x86_64.rpm(在root下操作，”…”为rpm包所在路径)
3. 修改gitlab配置文件中external_url的值为当前虚拟机ip

   vim /etc/gitlab/gitlab.rb

4. 初始化并启动

   gitlab-ctl reconfigure # 初始化gitlab服务
   gitlab-ctl start # 启动gitlab服务

   其他命令：

   gitlab-ctl status # 查看gitlab服务状态
   gitlab-ctl stop # 停止gitlab服务
   gitlab-ctl restart # 重启gitlab服务

5. 在浏览器中输入虚拟机IP地址即可访问GitLab服务
   如想把80换成其他端口，需要修改步骤3文件的port值并重新加载配置文件&重启gitlab(步骤4)
6. 查看gitlab初始的root用户的密码

   cat /etc/gitlab/initial_root_password # 查看gitlab初始的root用户的密码

7. root管理员账号登录后需要修改密码，要求8位以上、包含大小写字母和特殊符号，修改后需重新登录

win10部署gitlab-runner

注：gitlab-runner搭建在win上还是linux上 取决于在gitlab托管的项目的运行环境是win还是linux

1. 打开浏览器中的gitlab中的管理中心下的CI/CD中的Runner
2. 将下载的gitlab-runner-windows-amd64.zip拷贝至本地并解压
3. 以管理员身份运行Windows PowerShell并进入解压之后的目录
4. 输入命令.\gitlab-runner-windows-arm64.exe register
5. 依次按提示输入gitlab的url地址、步骤一中的token、runner的描述、tag标签、方式(博主填的shell)
6. 因为是在windows测试gilab仓库中代码，所以要修改当前目录下的config.toml中的shell值，把pwsh改为powershell
7. 输入命令 .\gitlab-runner-windows-arm64.exe install
8. 输入命令 .\gitlab-runner-windows-arm64.exe start
9. 刷新gitlab的CI/CD页面，可以看到注册的runner
10. 在想要进行自动化测试的仓库中创建并编写.gitlab-ci.yml脚本文件，上传后会自动触发一次CI测试
    (官方yml脚本语法文档：https://docs.gitlab.com/ee/ci/yaml/index.html)

Ubuntu24.04部署gitlab-runner

1. 下载gitlab-runnner的rpm包，传至linux系统
2. 安装、初始化与启动

   rpm -ivh xxxx.rpm # 进行rpm安装
   systemctl start gitlab-runner # 启动gitlab-runner
   gitlab-runner -h # 检查gitlab-runner是否启动成功
   su gitlab-runner register --url http://IP:PORT/ --registration-token XXXXXXXXXXXXX # 注册runner

---

总结

以上就是今天要讲的内容，本文简单介绍了在离线环境下如何安装gitlab和gitlab-runner，而其具体使用还需自行探索。