From 6befa3c33a2b6dff31509fc42272c2f468582d40 Mon Sep 17 00:00:00 2001
From: kdletters <kdletters@qq.com>
Date: Sat, 15 Aug 2026 17:29:25 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=A8=E9=A2=84=E8=A7=88=E6=B5=81?=
 =?UTF-8?q?=E6=B0=B4=E7=BA=BF=E9=A6=96=E6=AC=A1=E8=A7=A6=E5=8F=91=E5=8F=82?=
 =?UTF-8?q?=E6=95=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

在 Jenkins Job 配置中预声明部署参数
增加 buildWithParameters 首次触发合同检查
---
 jenkins/preview-deployer-job-config.xml | 32 ++++++++++++++++++++++++-
 scripts/check-preview-deployer.mjs      |  5 ++++
 2 files changed, 36 insertions(+), 1 deletion(-)

diff --git a/jenkins/preview-deployer-job-config.xml b/jenkins/preview-deployer-job-config.xml
index a2317950f..a0cbd4247 100644
--- a/jenkins/preview-deployer-job-config.xml
+++ b/jenkins/preview-deployer-job-config.xml
@@ -5,7 +5,37 @@
   <keepDependencies>false</keepDependencies>
   <properties>
     <hudson.model.ParametersDefinitionProperty>
-      <parameterDefinitions/>
+      <parameterDefinitions>
+        <hudson.model.ChoiceParameterDefinition>
+          <name>ACTION</name>
+          <description>部署、查询状态或卸载分支预览容器</description>
+          <choices class="java.util.Arrays$ArrayList">
+            <a class="string-array">
+              <string>DEPLOY</string>
+              <string>STATUS</string>
+              <string>UNINSTALL</string>
+            </a>
+          </choices>
+        </hudson.model.ChoiceParameterDefinition>
+        <hudson.model.StringParameterDefinition>
+          <name>SOURCE_BRANCH</name>
+          <description>源码分支；DEPLOY 和 UNINSTALL 必填</description>
+          <defaultValue></defaultValue>
+          <trim>true</trim>
+        </hudson.model.StringParameterDefinition>
+        <hudson.model.StringParameterDefinition>
+          <name>COMMIT_HASH</name>
+          <description>可选；必须是 SOURCE_BRANCH 历史中的 commit</description>
+          <defaultValue></defaultValue>
+          <trim>true</trim>
+        </hudson.model.StringParameterDefinition>
+        <hudson.model.StringParameterDefinition>
+          <name>DEPLOYMENT_ID</name>
+          <description>预览实例稳定 ID</description>
+          <defaultValue></defaultValue>
+          <trim>true</trim>
+        </hudson.model.StringParameterDefinition>
+      </parameterDefinitions>
     </hudson.model.ParametersDefinitionProperty>
   </properties>
   <definition class="org.jenkinsci.plugins.workflow.cps.CpsScmFlowDefinition" plugin="workflow-cps">
diff --git a/scripts/check-preview-deployer.mjs b/scripts/check-preview-deployer.mjs
index 230052052..32d1b0497 100644
--- a/scripts/check-preview-deployer.mjs
+++ b/scripts/check-preview-deployer.mjs
@@ -132,6 +132,11 @@ assertIncludes(
   '<scriptPath>jenkins/Jenkinsfile.preview-deployer</scriptPath>',
   'Jenkins Job 必须从受保护 master 读取固定流水线。',
 );
+assertIncludes(
+  jobConfig,
+  '<hudson.model.ChoiceParameterDefinition>',
+  'Jenkins Job 首次触发前必须已经声明 buildWithParameters 参数。',
+);
 assertIncludes(
   nginx,
   'location ^~ /api/preview-deployer/',