# Gateway-K8s Job 配置清单（对照 Jenkins 界面）

目标：从 Harbor 取 **预生产 gateway 镜像** → 打上生产 tag → 推到 **39.105.153.68** → 可选更新 **ACK**。

---

## 常规（General）

| 项 | 建议 | 说明 |
|----|------|------|
| 描述 | `gateway 镜像晋升 → ACK` | 可选 |
| GitHub project | 不勾 | — |
| Gogs secret | 可保留 | 仅 Webhook 用；手动发版可不配触发器 |
| **参数化构建过程** | **可不勾** | 参数在 Jenkinsfile `parameters {}` 里；**首次 Build 一次**后会出现「Build with Parameters」 |
| 丢弃旧的构建 | 建议勾，保留 15 次 | 与 Jenkinsfile `buildDiscarder` 一致 |
| 不允许并发构建 | 按需 | gateway 单服务一般可勾，避免两次同时改 ACK |

---

## 流水线（Pipeline）

| 项 | 应填 | 你截图中的注意点 |
|----|------|------------------|
| 定义 | **Pipeline script from SCM** | ✓ 正确 |
| SCM | Git | ✓ |
| Repository URL | `http://8.152.195.41:3000/alien/alien_cloud` | 须为 **`alien_cloud`（下划线）**，不要 `alien cloud`（空格） |
| Credentials | **`dujian/****** (git)`** 等 Git 凭据 | ✓ 正确；**不要**选 `robot$alien_cloud+jenkins-k8s` |
| 分支 | `*/uat-20260202` | 与 Gitea 实际分支一致；避免 `uat 20260202`（空格） |
| Script Path | `docs/jenkins/produ/gateway/Jenkinsfile` | ✓ 正确 |
| **轻量级检出** | **建议勾选** | 只拉 Jenkinsfile；脚本内再**稀疏检出** `_shared`，不拉 `alien-gateway` 等源码 |

Harbor / ACK 凭据不在 SCM 里配，在 Jenkins **凭据管理**：

| ID | 类型 | 用途 |
|----|------|------|
| `harbor-robot-alien` | Username/Password | `robot$alien_cloud+jenkins-k8s` + Token |
| `ack-kubeconfig-alien` | Secret file | ACK kubeconfig |

---

## 构建触发器

| 项 | 建议 |
|----|------|
| 全部 | 发版以 **手动 Build with Parameters** 为主时可全不勾 |

---

## 首次运行参数示例

| 参数 | 示例 |
|------|------|
| `SOURCE_TAG` | `uat-build-42`（UAT 已推到 Harbor 的 tag） |
| `TARGET_TAG` | 留空 → `produ-<构建号>` |
| `DEPLOY_STRATEGY` | 先试 **`skip`**（只晋升 Harbor）；确认后再 `rolling` |
| `DRY_RUN` | 第一次可勾，只看计划 |

---

## 与旧版 build 型 Job 的区别

本 Job **不会** Maven、不会 `docker build`、不会 Checkout `alien-gateway` 源码目录。  
预生产镜像须已由 UAT 流水线推到：`39.105.153.68/alien_cloud/gateway:<SOURCE_TAG>`。
