流水线优化 - 最后推送到Harbor 制品库

docs/jenkins/Jenkinsfile-uat-build-deploy.groovy

@@ -179,7 +179,9 @@ pipeline {
         }
 
         stage('Push images to Harbor') {
-            when { expression { return params.PUSH_TO_HARBOR == true } }
+            when {
+                expression { return params.PUSH_TO_HARBOR == true }
+            }
             steps {
                 script {
                     def reg = params.HARBOR_REGISTRY.trim()
@@ -290,6 +292,11 @@ pipeline {
     post {
         always {
             sh 'rm -f settings.xml || true'
+            script {
+                if (!params.PUSH_TO_HARBOR) {
+                    echo '>>> Harbor push SKIPPED: PUSH_TO_HARBOR is false. On "Build with Parameters" check PUSH_TO_HARBOR.'
+                }
+            }
         }
         success {
             script {

docs/jenkins/README-UAT-HARBOR-PUSH.md

@@ -87,12 +87,30 @@ echo '<TOKEN>' | docker login 39.105.153.68 -u 'robot$alien_cloud+jenkins-k8s' -
 
 ## 四、Build with Parameters（推荐首次 gateway）
 
+### 配置页 vs 构建页（易混）
+
+| 页面 | `HARBOR_PUSH_SCOPE` 长什么样 |
+|------|-------------------------------|
+| **Job → 配置（Configure）** | 多行**文本框**，每行一个选项——这是在**编辑**下拉列表，不是让你手打 tag |
+| **Build with Parameters（立即构建旁）** | **下拉框**，可点选 `all-java-services`、`gateway-only` 等 |
+
+若在「配置」里看到文本框，属正常；请去 **Build with Parameters** 里选。
+
+### 必须勾选 PUSH_TO_HARBOR
+
+| 参数 | 说明 |
+|------|------|
+| **`PUSH_TO_HARBOR`** | **必须勾选**，否则整个「Push images to Harbor」阶段**跳过**，Harbor 不会出现 gateway（与 `HARBOR_PUSH_SCOPE` 选什么无关） |
+| `HARBOR_PUSH_SCOPE` | 仅当 `PUSH_TO_HARBOR=true` 时生效 |
+
+配置里「Set by Default」未勾时，每次构建都要在 **Build with Parameters** 手动勾选 **PUSH_TO_HARBOR**。
+
 | 参数 | 首次试跑建议 |
 |------|----------------|
 | `GIT_BRANCH` | `uat-20260202` |
 | `FORCE_UPDATE` | 按需 |
-| **`PUSH_TO_HARBOR`** | **`true`** |
-| **`HARBOR_PUSH_SCOPE`** | 默认 **`all-java-services`**；试单个服务选 **`gateway-only`** 等 |
+| **`PUSH_TO_HARBOR`** | **勾选 true** |
+| **`HARBOR_PUSH_SCOPE`** | 下拉选 **`all-java-services`** 或 **`gateway-only`** |
 | `HARBOR_REGISTRY` | `39.105.153.68` |
 | `HARBOR_PROJECT` | `alien_cloud` |