记一次在 Ubuntu 18.04 下安装 gitlab 和 gitlab-runner 并配置 vue 项目简单地自动打包

建议安装机器的硬件条件：

• 4G RAM 以上
• 30GB 磁盘容量以上

1.安装 gitlab

1) Install and configure the necessary dependencies

在 shell 中执行如下命令

sudo apt-get update
sudo apt-get install -y curl openssh-server ca-certificates

Next, install Postfix to send notification emails（暂时先不用管，直接安装就好了，安装过程中会有个弹窗，选择框选 'Internet Site'，输入框随便）

sudo apt-get install -y postfix

2）Add the GitLab package repository and install the package

curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash

这个镜像源很慢，安装过程中很容易连接就会断掉，所以一般网上找的教程都是改用清华大学的镜像源，具体操作如下

vim /etc/apt/sources.list.d/gitlab_gitlab-ce.list

把原来的两行删除或者注释（# 是行注释），然后增加

deb https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/ubuntu bionic main
deb-src https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/ubuntu bionic main

其中 bionic 是 Ubuntu 18 的发行代号，若是 Ubuntu 的其他发型版本，把 bionic 替换成对应的代号即可，如图

image.png

再次执行

sudo apt-get update

安装

sudo EXTERNAL_URL="http://ip 或域名" apt-get install gitlab-ce

这个 EXTERNAL_URL 就是你希望通过浏览器地址栏可以访问到这个 gitlab 的地址

3)Browse to the hostname and login

打开后会提示你修改密码，这个密码是 root 账户的密码，修改成功后就可以登陆了，当然，还可以再新建账户，然后创建一个项目比如叫 first-project

另外 gitlab 安装后默认是开机就服务自启的，可以通过某个配置文件关闭自启

2.安装 gitlab-runner

建议 gitlab 和 gitlab-runner 不要在同一机器上

1)Simply download one of the binaries for your system

sudo curl -L --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64

2)Give it permissions to execute

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

3)Create a GitLab CI user

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

4)Install and run as service

sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

5) register the runner

image.png

其中，第一项输入命令开始 register runner，第二项和第三项可以在创建的 gitlab 项目的 setting -> CI/CD -> runners 下面找到；第二项其实就是上面的 EXTERNAL_URL，第三项是 runner 拿来访问该项目的 token；第四项输入 runner 的名字；第五项为 runner 打上某些 tag，这些 tag 会在 .gitlab-ci.yml 配置中用到，比如为了标记这个 runner 是在 shell 中执行，于是给他加个 shell 的 tag；第六项是指 runner 的 executor，比如 shell、docker 或是别的什么，先用 shell。

配置完之后就会在对应于项目的 setting -> CI/CD -> runners 下面看到这个 runner，执行

gitlab-runner run

之后就可以看到

image.png

绿色的那个 runner 出于正常运行状态

3.配置 .gitlab-ci.yml

随便推个可以正常运行的 vue 代码，到 first-project 项目，然后在项目目录下新建一个 .gitlab-ci.yml 文件，写入以下代码

stages:
  - build

job_build:
  stage: build
  only:
    - master
  script:
    - npm i
    - npm run build
  tags:
    - shell

提交之后去项目的 CI/CD -> pipeline 下面就可以看到 runner 就在自行打包了。当然，这里还需要保证执行 gitlab-runner run 命令的那个名为 gitlab-runner 用户环境下提前安装好了 node 和 npm，这样上面的 job 才有可能成功。linux 安装 node 的话，建议用 nvm。

参考链接：

• https://about.gitlab.com/install/#ubuntu
• https://docs.gitlab.com/runner/install/linux-manually.html
• https://docs.gitlab.com/runner/register/index.html
• https://ywnz.com/linuxjc/1622.html

感想：

最早诞生想要了解 gitlab CI/CD 的念头，是在第一次体验只要（甚至不用）手动点点点就能做到打包、发布时，顿时觉得这个东西好神奇，想要了解其原理但是又不知道从何下手，然后作罢。后面每次开新项目都需要 leader 来弄帮忙弄这些东西，而且是粗暴的粘贴复制 A 项目的 .gitlab-ci.yml 到 B 项目，然后就凭感觉全局搜索改一些配置的东西，因为有三个环境，开发和测试是用的 k8s、docker 那些。最终每次改都花了不少时间才能让它正常运行不说，还不知道留下了什么样的坑：由于 C 项目配置文件是从 B 项目 copy 过来的，然后 C 项目的测试环境 docker 镜像就把 B 项目的测试环境给覆盖掉了，导致访问 B 项目时看到的是 C 项目。出于此终于开始着手了解着相关的东西，所以经历从虚拟机装 Ubuntu 系统，系统装 gitlab，虚拟机又装一个 Ubuntu 系统，系统装 gitlab-runner 这些步骤后终于跑成功了自动打包的第一步。

说历经波折也不过分，虚拟机就装了好多回，最早装了桌面版的 Ubuntu 同时跑 gitlab 和 gitlab-runner 卡的一批，然后卸掉重装；装 ubuntu-server 的过程中因为忘了中间改了 VMware 网络连接方式导致连不上网又折腾好几次；然后跑 gitlab-runner 时候因为用的 sudo gitlab-runner run 然后莫名其妙的出现 npm 权限问题也折腾了够久……所以最后终于跑通的时候那种愉悦感不言自明。此外，中间还简单了解了 ssh 免秘钥登录的机制、学会了一些简单的 linux 命令、感受到了 linux 的强大以及其对程序员的友好（想要安装什么东西，输命令，写脚本就搞定）。嗯，学 linux 真是太好了。