Linux 开发：如何搭建 CI 流水线 (GitHub Actions / GitLab CI)-linux运维-PHP中文网

Linux 开发：如何搭建 CI 流水线 (GitHub Actions / GitLab CI)

舞姬之光

发布： 2025-11-18 23:09:06

原创

931人浏览过

答案：GitHub Actions和GitLab CI可通过YAML配置实现Linux项目的自动化构建与测试。首先在.github/workflows/ci.yml中定义触发条件、运行环境及步骤，包括代码检出、环境搭建、编译和测试；随后在.gitlab-ci.yml中设置阶段、变量和脚本，利用Runner执行构建与测试任务，并通过artifacts传递产物；最后遵循固定版本、缓存依赖、分阶段运行等最佳实践提升流水线稳定性，确保每次提交快速反馈问题，保障代码质量。

linux 开发：如何搭建 ci 流水线 (github actions / gitlab ci)

在 Linux 开发中，搭建 CI（持续集成）流水线能自动执行代码检查、测试和构建，提升开发效率与代码质量。GitHub Actions 和 GitLab CI 是目前主流的 CI 工具，两者都基于 YAML 配置文件定义任务流程。下面分别介绍如何为 Linux 项目配置这两种 CI 方式。

GitHub Actions：使用 actions 配置 CI

GitHub Actions 的配置文件位于项目根目录下的 .github/workflows/ci.yml。以下是一个适用于 Linux C/C++ 或脚本项目的典型配置示例：

name: CI
<p>on:
push:
branches: [ main ]
pull_request:
branches: [ main ]</p><p>jobs:
build:
runs-on: ubuntu-latest
steps:</p><ul><li><p>name: Checkout code
uses: actions/checkout@v4</p></li><li><p>name: Setup environment
run: |
sudo apt-get update
sudo apt-get install -y build-essential cmake libssl-dev</p></li><li><p>name: Build project
run: |
mkdir build && cd build
cmake ..
make</p></li><li><p>name: Run tests
run: |
cd build
./unit_tests || exit 1</p>

登录后复制

这个流程会在每次推送到 main 分支或创建 PR 时触发，在 Ubuntu 最新 LTS 环境中完成依赖安装、编译和测试。你也可以添加代码格式检查（如 clang-format）、静态分析（如 cppcheck）等步骤。

GitLab CI：使用 .gitlab-ci.yml 配置流水线

GitLab CI 的配置文件是项目根目录下的 .gitlab-ci.yml。GitLab Runner 默认支持 Linux 环境，适合本地或私有部署。

stages:
  - build
  - test
<p>variables:
CC: gcc
CXX: g++</p><p>before_script:</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1496">
                            <img src="https://img.php.cn/upload/ai_manual/000/969/633/68b7a456e0374854.png" alt="PhotoAid Image Upscaler">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1496">PhotoAid Image Upscaler</a>
                            <p>PhotoAid出品的免费在线AI图片放大工具</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="PhotoAid Image Upscaler">
                                <span>52</span>
                            </div>
                        </div>
                        <a href="/ai/1496" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="PhotoAid Image Upscaler">
                        </a>
                    </div>
                <ul><li>apt-get update</li><li>apt-get install -y build-essential cmake</li></ul><p>build_job:
stage: build
script:</p><ul><li>mkdir build</li><li>cd build</li><li>cmake ..</li><li>make
artifacts:
paths:<ul><li>build/</li></ul></li></ul><p>test_job:
stage: test
script:</p><ul><li>cd build</li><li>ctest --verbose

登录后复制

该配置定义了两个阶段：构建和测试。构建产物通过 artifacts 传递给后续阶段。确保你的 GitLab 项目已注册可用的 Runner（可通过 Docker 或 shell 执行器运行在 Linux 主机上）。