<think>我们正在处理关于
GitLab CI/CD的
使用教程和最佳实践的问题。根据提供的引用，我们可以整合信息并构建一个结构化的回答。
引用[1]提到了一系列视频教程，包括Docker安装
GitLab和
GitLab Runner，.
gitlab-
ci.yml的编写，常用关键词，部署项目到不同环境（如docker镜像、OSS、远程服务器），以及流水线的最佳实践和调试手段。
引用[2]提到了
GitLab CI/CD是开发和运维管理的效率神器，并提到了.
gitlab-
ci.yml关键词参考。
引用[3]简要说明了定义pipeline的阶段(stage)，每个阶段的任务，以及如何设置参数变量。
因此，我们可以将回答分为以下几个部分：
1. 概述
GitLab CI/CD
2. 安装和配置（
GitLab和Runner）
3. .
gitlab-
ci.yml文件的结构和常用关键词
4. 部署示例（前端项目）
5. 变量管理和流水线触发
6. 最佳实践和调试
注意：由于引用内容有限，我们主要基于这些引用进行总结，同时结合通用知识补充。
同时，按照要求，我们需要生成相关问题。</think>###
GitLab CI/CD 使用教程与最佳实践
GitLab CI/CD 是基于 `.
gitlab-
ci.yml` 配置文件实现的自动化流程，核心流程如下：
---
#### **1. 环境安装与配置**
- **安装
GitLab**
推荐
使用 Docker 部署（引用[1]）：
```bash
docker run -d --name
gitlab -p 443:443 -p 80:80 -p 22:22 \
-v /srv/
gitlab/config:/etc/
gitlab \
-v /srv/
gitlab/logs:/var/log/
gitlab \
-v /srv/
gitlab/data:/var/opt/
gitlab \
gitlab/
gitlab-ce:latest
```
- **安装
GitLab Runner**（引用[1][3]）
同样推荐 Docker 方式：
```bash
docker run -d --name
gitlab-runner --restart always \
-v /srv/
gitlab-runner/config:/etc/
gitlab-runner \
-v /var/run/docker.sock:/var/run/docker.sock \
gitlab/
gitlab-runner:latest
```
注册 Runner 到
GitLab 项目：
```bash
docker exec -it
gitlab-runner
gitlab-runner register
# 输入
GitLab URL、注册令牌、执行器类型（如 docker）、默认镜像
```
---
#### **2. 编写 `.
gitlab-
ci.yml` 配置文件**
关键结构（引用[1][3]）：
```yaml
stages: # 定义流水线阶段
- build
- test
- deploy
variables: # 全局变量（引用[3]）
PROJECT_NAME: "my-app"
build-job:
stage: build
image: node:18 # 指定执行环境
script:
- npm install
- npm run build
artifacts:
paths:
- dist/ # 保存构建产物供后续阶段
使用
test-job:
stage: test
image: node:18
script:
- npm run test
deploy-job:
stage: deploy
image: alpine
script:
- apk add openssh-client
- scp -r dist/ user@server:/path/to/deploy # SSH 部署示例（引用[1]）
only:
- main # 仅 main 分支触发
```
---
#### **3. 核心功能实践**
- **变量管理**（引用[1][3]）
- **预定义变量**：如 `$
CI_COMMIT_SHA`（提交哈希）
- **自定义变量**：在
GitLab 项目设置 `Settings >
CI/CD > Variables` 添加敏感信息（如 API 密钥）
- 在 YAML 中引用：`- echo $API_KEY`
- **流水线触发方式**（引用[1]）
- **自动触发**：代码推送时自动运行
- **手动触发**：在
GitLab 界面点击 `Run Pipeline`
- **API 触发**：`curl -X POST -H "PRIVATE-TOKEN: <token>" "https://
gitlab.com/api/v4/projects/<project_id>/pipeline"`
- **部署到不同环境**
- **云存储（如 OSS）**（引用[1]）：
```yaml
deploy-oss:
script:
- apt-get install ossutil # 安装阿里云工具
- ossutil cp dist/ oss://bucket-name/ --recursive
```
- **远程服务器（SSH）**（引用[1]）：
```yaml
deploy-ssh:
before_script:
- mkdir -p ~/.ssh
- echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa # 私钥注入变量
- chmod 600 ~/.ssh/id_rsa
script:
- ssh user@server "cd /app;
git pull && restart-app"
```
---
#### **4. 最佳实践与调试**（引用[1][2]）
- **优化流水线**：
-
使用 `cache` 缓存依赖（如 `node_modules`）：
```yaml
cache:
key: $
CI_COMMIT_REF_SLUG
paths:
- node_modules/
```
- 并行化任务：`test-job` 拆分为多个子任务并行执行
- **调试技巧**：
- 本地验证配置：`
gitlab-runner exec docker test-job`
- 查看日志：
GitLab 流水线页面点击作业日志
- **安全建议**：
- 敏感变量设置为 `Protected`（仅保护分支可访问）
-
使用 `rules` 替代 `only/except` 实现更灵活的触发条件：
```yaml
deploy-prod:
rules:
- if: $
CI_COMMIT_BRANCH == "main" && $
CI_PIPELINE_SOURCE == "push"
```
---
#### **5. 典型应用场景**
1. **前端项目自动化**（引用[1]）：构建 → 测试 → 部署到 OSS/CDN
2. **后端服务**：构建 Docker 镜像 → 推送镜像仓库 → 滚动更新 K8s
3. **移动端**：构建 APK/IPA → 上传到测试平台（如 Firebase）
> **提示**：完整关键词参考官方文档 [.
gitlab-
ci.yml keyword reference](https://docs.
gitlab.com/ee/
ci/yaml/)（引用[2]）
最低0.47元/天 解锁文章
扫一扫
2万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
