写在之前
前文已经搭建了基于gitlab的cicd环境，现在我们来更近一步，结合官网给出的案例来详细介绍如何一步一步实现CI的过程。
基于gitlab搭建一个前端静态页面
环境依赖： gitlab+gitlab runner（docker版本） 环境达吉安完毕
本地已经有nodejs和npm的基础环境（建议安装最新的nodejs版本）
步骤一：在UI界面上创建一个基础的项目
步骤二:在本地clone项目地址
git clone http://xxxx:8000/cicddemo/cicd.git
步骤三：利用npm生成前端项目
在本地的项目目录下执行以下命令，命令会需要显示填写的具体配置信息，我们全部选择默认选项即可。
npm init docusaurus
步骤三:将上一步生成的静态页面文件放到根目录下
步骤四：修改配置文件
修改文件docusaurus.config.js，将url配置成自己的gitlab地址，将baseUrl配置成项目路径。
步骤五：推送本地文件到远程git仓库
git add .
git commit -m "Add simple generated Docusaurus site"
git push origin
步骤六：创建CICD配置文件
cicd文件的语法
stages: # List of stages for jobs and their order of execution
- build
- deploy
build-job:
stage: build # Set this job to run in the `build` stage
image: node:21
script:
- npm install
- npm run build
artifacts:
paths:
- "build/"
pages:
stage: deploy # Set this new job to run in the `deploy` stage
script:
- mv build/ public/
artifacts:
paths:
- "public/"
还记得我们之前是怎么查看cicd的每个阶段的日志记录的吗？我们观察到每一个第一个stage正在运行。趁着docker在构建容器，我们首先读懂这个cicd的yaml的具体语义是什么：
- stages：最常见的配置文件将作业分为多个阶段。同一阶段的作业可以并行运行，而后面阶段的作业则等待前面阶段的作业完成。如果作业失败，则认为整个阶段失败，后面阶段的作业不会开始运行。这里共分两个执行阶段：build和deploy
- build：build阶段是在node容器内运行了一段脚本。并将生成的文件放到目录build/下
- deploy：是将上一步骤生成的文件切换了路径
npm install
npm run build
我们观察一下runner所在的机器上发生了什么变化，我们来回顾一下如何使用docker容器的方式安装gitlab-runner，这里将docker.sock挂载进入了runner所在的容器。
docker run -d --name gitlab-runner --restart always \
-v /var/run/docker.sock:/var/run/docker.sock \
-v gitlab-runner-config:/etc/gitlab-runner \
gitlab/gitlab-runner:latest
/var/run/docker.sock是 Docker 的 Unix 套接字文件，用于与 Docker
守护进程进行通信。Docker 守护进程负责管理和运行容器化应用程序。
Unix 套接字文件是一种特殊类型的文件，用于进程间的通信。在 Docker 中，/var/run/docker.sock文件用于Docker 客户端（如 Docker CLI）与 Docker 守护进程之间的通信。当您在命令行中运行 Docker 命令时，Docker 客户端会与 Docker 守护进程进行通信来执行相应的操作。通常情况下，Docker
客户端通过网络接口与 Docker 守护进程通信，但是当 Docker 客户端连接到/var/run/docker.sock文件时，通信会通过 Unix 套接字进行。通过 Docker 命令行界面或使用 Docker API，您可以使用/var/run/docker.sock文件与 Docker守护进程进行交互，例如创建、启动、停止和删除容器，构建和推送镜像，查看日志等等。这种本地通信的方式对于管理和监控 Docker容器非常有用。
gitlab-runner应在是在这一步通过与docker的守护进程通信，从而调用容器创建接口，使得每一个阶段都可以在不同的容器中执行。
我们进到容器内，发现这个额外的容器内运行的是scripts的指令
容器内已经clone了git仓库的文件
注意：这里有npm install卡住报错的解决方案
npm WARN tarball tarball data for xxxx@^0.25… npm项目依赖安装卡住
当两个阶段执行完毕后，可以下载打包完毕完成的静态web界面
写在之后
本文仅介绍了gitlab的CI过程，至于如何基于上述生成的静态页面在不同节点上部署，答主给出一种最简单的实现步骤：利用ssh登录到一个发布节点，将上文中的public共享静态页面拷贝过去。由于答主不是前端出身，所以不太清楚这个静态页面如何暴露给用户查看，所以暂时没有实现cd的步骤，留一个坑在这里，后续有空补充上吧。
