> For AI agents: the complete documentation index is available at https://www.tteam.icu/llms.txt, the full documentation bundle is available at https://www.tteam.icu/llms-full.txt.

# Jenkins DevOps 配置

## [安装](https://www.tteam.icu/ops/service/jenkins.md)

[官网](https://www.jenkins.io/download/)

## 常用项

这些配置项主要用于传统 Freestyle 任务和脚本式发布任务，适合快速搭建一个可参数化、可回滚、可查看日志的发布流程。

- `Discard old builds`: 控制构建记录保留策略，避免日志和制品无限增长。
- `This project is parameterized`: 开启参数化构建，用于选择分支、版本、环境和其他变量。

### General

- `Choice Parameter`: 下拉选择参数，适合固定环境或固定选项。
- `Git Parameter`: Git 分支或 Tag 参数，常在高级选项中选择 `DESCENDING_SMART` 和 `TOP`。
- `String Parameter`: 字符串参数，适合输入版本号、镜像名或临时变量。

### 源码管理

- `git`: `Branches to build` 可以设置为 `${Version}`，让构建分支跟随参数变化。

### 构建环境

- `Delete workspace before build starts`: 每次构建前清理工作区，避免旧文件影响新构建。
- `Add timestamps to the Console Output`: 在控制台日志中显示时间，便于排查耗时和定位错误。

### Build Steps

- `Conditional step (single)`: 搭配 `Execute shell` 可以按条件执行本机多行命令。
- `Execute shell script on remote host using ssh`: 通过 SSH 到远端机器执行多行命令。

### 构建后操作

- `Groovy Postbuild`: 通过 Groovy Script 在构建列表中显示自定义消息。

## 安装docker的loki插件

如果希望 Docker 容器日志直接写入 Loki，可以安装 Loki Docker Driver。

```shell
docker plugin install grafana/loki-docker-driver:2.8.0 --alias loki --grant-all-permissions
```

## [muen上线脚本](https://www.tteam.icu/script/jenkins/jenkins-scripts.md)