GitLab项目CI/CD步骤配置教程：从零开始构建自动化流程

乔或婵

于 2025-06-04 09:01:43 发布

阅读量345

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00245/article/details/148415425

GitLab项目CI/CD步骤配置教程：从零开始构建自动化流程

gitlabhq GitLab CE Mirror | Please open new issues in our issue tracker on GitLab.com 项目地址: https://gitcode.com/gh_mirrors/gi/gitlabhq

前言

在现代软件开发中，持续集成和持续交付(CI/CD)已成为不可或缺的环节。本教程将详细介绍如何在GitLab项目中配置和使用CI/CD步骤(Steps)，帮助开发者构建高效、可复用的自动化流程。

准备工作

在开始之前，请确保已经完成以下准备工作：

已安装GitLab命令行工具(glab)
已登录GitLab账号并具备创建项目的权限

创建基础步骤

步骤定义与结构

一个基本的CI/CD步骤由两部分组成：规范(spec)和执行(exec)。规范定义了步骤的输入输出接口，而执行部分则包含具体的操作指令。

创建步骤文件step.yml：

spec:
  inputs:
    who:
      type: string
      default: world
---
exec:
  command:
    - bash
    - -c
    - echo 'hello ${{inputs.who}}'

这个步骤有以下特点：

接受一个名为who的字符串输入参数，默认值为"world"
使用Bash执行简单的echo命令
使用${{}}语法引用输入参数

步骤执行原理

当步骤运行时：

系统会解析spec部分，验证输入参数
执行部分(exec)中的命令会被运行
表达式${{inputs.who}}会在运行时被替换为实际值

配置CI/CD流水线

创建基础流水线

在项目根目录创建.gitlab-ci.yml文件：

hello-world:
  run:
    - name: hello_world
      step: .

这个配置：

定义了一个名为hello-world的作业
使用run关键字指定要运行的步骤
通过.引用当前目录下的步骤定义

提交并运行流水线

使用以下命令提交更改并触发流水线：

git add .
git commit -m '初始步骤配置'
git push --set-upstream origin main
glab ci status

成功运行后，将在日志中看到输出："hello world"

进阶步骤配置

多步骤作业配置

可以在一个作业中配置多个步骤：

hello-world:
  run:
    - name: hello_world
      step: .
    - name: hello_steps
      step: .
      inputs:
        who: "GitLab步骤"

这种配置方式允许：

复用相同的步骤定义
为不同步骤提供不同的输入参数
保持步骤间的独立性

步骤重构与模块化

随着步骤复杂度增加，建议将步骤定义拆分到独立目录：

spec:
---
run:
  - name: hello_world
    step: ./hello
  - name: hello_steps
    step: ./hello
    inputs:
      who: "GitLab步骤"

这种结构提高了：

代码的可维护性
步骤的复用性
配置的清晰度

步骤输入输出管理

定义步骤输出

步骤可以定义输出值供后续步骤使用：

spec:
  inputs:
    who:
      type: string
      default: world
  outputs:
    greeting:
      type: string
---
exec:
  command:
    - bash
    - -c
    - echo '{"name":"greeting","value":"hello ${{inputs.who}}"}' | tee ${{output_file}}

输出特点：

必须指定名称和类型
通过JSON格式写入${{output_file}}
可以被后续步骤引用

使用远程步骤

GitLab支持引用远程步骤仓库：

hello-world:
  run:
    - name: hello_everybody
      step: .
    - name: all_my_greetings
      step: gitlab.com/gitlab-org/ci-cd/runner-tools/echo-step@main
      inputs:
        echo: "所有问候语：${{steps.hello_everybody.outputs.all_greetings}}"

远程步骤的优势：