在 Ubuntu 16.04 上使用 GitLab CI 设置持续集成 (CI) 流水线需要完成以下步骤。GitLab CI/CD 是一个强大的工具，可以自动化代码测试、构建和部署。
步骤 1：安装 GitLab RunnerGitLab Runner 是用于执行 GitLab CI 流水线任务的工具。
安装必要的软件包
sudo apt update
sudo apt install -y curl gnupg
添加 GitLab Runner 的官方存储库
curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
安装 GitLab Runner
sudo apt install -y gitlab-runner
验证安装
gitlab-runner --version
输出类似于 GitLab Runner 15.x.x 表示安装成功。
步骤 2：注册 GitLab Runner
在 GitLab 项目中，获取注册令牌：
转到 Settings > CI/CD > Runners。
复制 Specific Runners 的注册令牌。
在服务器上运行注册命令：
sudo gitlab-runner register
按照提示填写：
- GitLab URL: 输入你的 GitLab 实例 URL（例如
https://gitlab.com）。 - Token: 粘贴项目的注册令牌。
- Description: 给 Runner 起一个描述（例如
Ubuntu Runner）。 - Tags: 添加适当的标签（如
ubuntu,build）。 - Executor: 选择执行器（推荐
docker或shell）。
步骤 3：配置 GitLab CI/CD 文件
在项目的根目录中创建一个 .gitlab-ci.yml 文件，定义流水线配置。例如：
stages:
- build
- test
build-job:
stage: build
script:
- echo "Building the application..."
- echo "Build complete!"
test-job:
stage: test
script:
- echo "Running tests..."
- echo "Tests passed!"
此配置会定义两个阶段 build 和 test，分别运行简单的任务。
步骤 4：验证流水线
提交 .gitlab-ci.yml 文件到 GitLab 仓库：
git add .gitlab-ci.yml
git commit -m "Add CI/CD configuration"
git push origin main
转到 GitLab > CI/CD > Pipelines，你应该能看到新触发的流水线。
步骤 5：配置执行器（可选）
Shell 执行器：直接在服务器上运行命令，无需额外配置。
Docker 执行器：确保 Docker 已安装：
sudo apt install -y docker.io
将 gitlab-runner 用户添加到 docker 组：
sudo usermod -aG docker gitlab-runner
sudo systemctl restart gitlab-runner
注册时选择 docker 执行器，并配置一个默认的 Docker 镜像（如 alpine 或 ubuntu）。
步骤 6：优化和扩展
使用缓存：减少构建时间。
cache:
paths:
- node_modules/
定义环境变量：在 Settings > CI/CD > Variables 中设置环境变量，如 API_KEY。
script:
- echo "Using API_KEY=${API_KEY}"
触发部署：结合工具（如 SSH 或 Kubernetes），在流水线中实现自动化部署。
常见问题
权限错误：确保 gitlab-runner 用户有权限运行 Docker 或访问必要的文件。
流水线失败：检查 .gitlab-ci.yml 文件的语法，或者查看流水线的日志了解更多详情。
完成以上配置后，GitLab CI/CD 流水线应该已经在 Ubuntu 16.04 上成功运行！
发布者：myrgd，转载请注明出处：https://www.object-c.cn/5039
