【Gitlab】CICD流水线自动化部署教程

分手后的思念是犯贱 2024-02-05 15:00 13阅读 0赞

#### 第一步，准备 GitLab 仓库 ####

> 这个不用多说，得先保证你的项目已经托管在一个 GitLab 仓库中。

--------------------

#### 第二步，定义 \`.gitlab-ci.yml\` 文件 ####

在你的项目根目录中创建一个 \`.gitlab-ci.yml\` 文件。这个文件将定义所有 CI/CD 的工作流程，包括构建、测试和部署等步骤

例：

![eca272a793754144afe84db0d16f52c8.png][]

--------------------

#### 第三步，编写构建脚本 ####

> 这一步的内容根据自己实际需求来写，可以参考以下配置

variables:
      NODE_OPTIONS: "--max-old-space-size=4096"  #这个地方为什么写这个，是因为我部署的服务器分配的内存太少了而报错，所以这里根据你们实际需要
    # 定义流水线阶段
    stages:
      - build
     
    
    # 配置缓存节点模块提升性能
    cache:
      paths:
        - node_modules/
    
    # 构建作业
    build_job:
      stage: build
      image: node:latest
      script:
        - echo "Starting build process" # 断点: 开始构建过程
        - npm install
        - npm run build-only # 请根据你的情况视情况更改为正确的构建命令，就是你本地里面的打包命令
        - echo "Starting deployment"
        - echo "Current working directory is:"
        - pwd
        - cp -r dist/* /var/www/chatcs/  # 根据你自己的目录，这是要存放到的目录
      
      artifacts: # 存档构建结果，用于后续步骤
        paths:
          - dist/
      only:
        - main # 只有 main分支的提交会触发构建-根据你的需要
      tags:
        - chatcs # 假设标签是 chatcs ，这个也要根据你的需要

--------------------

#### 第四步，在你要部署的服务器上，安装GitLab Runner ####

特别提醒一句,以下的配置均在服务器中，这个服务器一定先把该安装的依赖安装好，比如你是前端，先把node下载安装好。

4.1 安装地址： [GitLab Runner 官方文档][GitLab Runner]

>     安装 GitLab Runner 可以通过以下步骤进行:
>     
>     1. 首先你需要连接到你的 Linux 服务器，在服务器上打开终端。
>     
>     2. 在终端中，使用管理员权限（比如 sudo）执行以下命令来安装 GitLab Runner：
>        - Debian/Ubuntu 系统:
>         
>          // 安装依赖
>          sudo apt-get update
>          sudo apt-get install -y curl wget gnupg2
>     
>          // 安装 GitLab Runner
>          curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
>          sudo apt-get install gitlab-runner
>          
>        - CentOS/RHEL 系统:
>          
>          //安装依赖
>          sudo yum install curl policycoreutils-python openssh-server
>     
>          //安装 GitLab Runner
>          curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash
>          sudo yum install -y gitlab-runner

**4.2 注册 GitLab Runner**

注册命令： gitlab-runner register

> **这一步容易出问题，最容易出问题的是选择执行方式.****你可以在配置文件 \`config.toml\` 中设置 Runner 的执行方式，例如使用 Docker、Shell 、ssh等，以确保 Runner 能够正确地执行你的 CI/CD 任务。**
> 
> **简单快捷的方式是: shell**

在注册过程中，系统将提示你输入 GitLab 的 URL、项目的注册令牌等信息。你可以在项目的 \`Settings\` --> \`CI/CD\` --> \`Runner\` 部分找到所需的注册令牌。

![a2641d8393f8439a82fe89d6915bd602.png][]

#### 4.3 确保 Runner 处于活跃状态 ####

> 确保你注册的 Runner 是活跃的，并且配置正确。在 GitLab Runner 的配置文件（通常位于 \`/etc/gitlab-runner/config.toml\`）中，确认 Runner 的配置，比如它应该指向正确的 GitLab 实例，且 Runner 标签符合项目的 \`.gitlab-ci.yml\` 文件中定义的要求。

#### 4.4 **启动 Runner** ####

你可以使用以下命令启动它：

gitlab-runner start

确认 Runner 正在运行后，回到 GitLab 项目的 CI/CD 设置中的 Runners 部分。等待几秒钟，你应该能够看到 Runner 的状态变为绿色，这意味着它已准备好接收工作。

![37d1d22f24c14c37beb100dac5f0a148.png][]

--------------------

#### 5.验证可行性 ####

至此，配置完成，你可以在本地git push后查看部署的网址是不是最新的代码。

![a2c9354303994fe1869cfb25a4306054.png][]

[eca272a793754144afe84db0d16f52c8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/62414a998bc442aa8cedeefa362b6005.png
[GitLab Runner]: https://docs.gitlab.com/runner/install/
[a2641d8393f8439a82fe89d6915bd602.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/843d5e90bd0948498d69f99beb35c156.png
[37d1d22f24c14c37beb100dac5f0a148.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/50bd95c2e49d4db082e7367ec204c7d9.png
[a2c9354303994fe1869cfb25a4306054.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/02/05/1473aba649114cc7bae78c611935593f.png