fix(jenkins): upload otelcol archive for server provision

jenkins/Jenkinsfile.production-server-provision

@@ -34,6 +34,7 @@ pipeline {
     booleanParam(name: 'ENABLE_SERVICES', defaultValue: true, description: '启用并启动 spacetimedb 与 api-server systemd 服务')
     booleanParam(name: 'ENABLE_OTELCOL', defaultValue: true, description: '安装并启用本机 OpenTelemetry Collector；api-server 模板默认开启 OTLP，如需关闭请在 API_ENV_FILE 中将 GENARRATIVE_OTEL_ENABLED 改为 false')
     string(name: 'OTELCOL_VERSION', defaultValue: '0.151.0', description: 'otelcol-contrib 版本')
+    stashedFile 'OTELCOL_CONTRIB_ARCHIVE'
   }
 
   stages {
@@ -72,6 +73,19 @@ pipeline {
           if (!(params.OTELCOL_VERSION?.trim() ==~ /^[0-9]+\.[0-9]+\.[0-9]+$/)) {
             error("OTELCOL_VERSION 格式应为 x.y.z: ${params.OTELCOL_VERSION}")
           }
+          def otelcolArchiveFilename = env.OTELCOL_CONTRIB_ARCHIVE_FILENAME?.trim()
+          def expectedOtelcolArchiveFilename = "otelcol-contrib_${params.OTELCOL_VERSION.trim()}_linux_amd64.tar.gz"
+          if (params.ENABLE_OTELCOL) {
+            if (!otelcolArchiveFilename) {
+              error("ENABLE_OTELCOL=true 时必须在 OTELCOL_CONTRIB_ARCHIVE 上传 ${expectedOtelcolArchiveFilename}。")
+            }
+            if (otelcolArchiveFilename != expectedOtelcolArchiveFilename) {
+              error("OTELCOL_CONTRIB_ARCHIVE 文件名必须是 ${expectedOtelcolArchiveFilename}，当前上传: ${otelcolArchiveFilename}")
+            }
+          }
+          if (!params.ENABLE_OTELCOL && otelcolArchiveFilename) {
+            echo "ENABLE_OTELCOL=false，已上传的 OTELCOL_CONTRIB_ARCHIVE 将不会被安装。"
+          }
           if (!params.SPACETIME_DOWNLOAD_ROOT?.trim()) {
             error('SPACETIME_DOWNLOAD_ROOT 不能为空。')
           }
@@ -129,9 +143,28 @@ pipeline {
             # jenkins-checkout-source.sh 会 reset/clean 到目标 commit，前面的临时 chmod 可能被 Git mode 还原；
             # 直接执行脚本前在二次 checkout 之后再补执行位，避免 Linux agent 报 Permission denied。
             chmod +x scripts/prepare-server-provision-tools.sh
+BASH
+        '''
+        script {
+          if (params.ENABLE_OTELCOL) {
+            echo "准备使用手动上传的 otelcol-contrib 包: ${env.OTELCOL_CONTRIB_ARCHIVE_FILENAME}"
+            sh 'bash -lc "rm -rf manual-provision-tool-upload && mkdir -p manual-provision-tool-upload"'
+            dir('manual-provision-tool-upload') {
+              unstash 'OTELCOL_CONTRIB_ARCHIVE'
+            }
+            env.OTELCOL_ARCHIVE_SOURCE = 'manual-provision-tool-upload/OTELCOL_CONTRIB_ARCHIVE'
+          } else {
+            env.OTELCOL_ARCHIVE_SOURCE = ''
+          }
+        }
+        sh '''
+          bash <<'BASH'
+            set -euo pipefail
 
             PROVISION_TOOLS_DIR="${PROVISION_TOOLS_DIR:-provision-tools}" \
             OTELCOL_VERSION="${OTELCOL_VERSION:-0.151.0}" \
+            PREPARE_OTELCOL="${ENABLE_OTELCOL:-true}" \
+            OTELCOL_ARCHIVE_SOURCE="${OTELCOL_ARCHIVE_SOURCE:-}" \
             SPACETIME_DOWNLOAD_ROOT="${SPACETIME_DOWNLOAD_ROOT:-https://github.com/clockworklabs/SpacetimeDB/releases/latest/download}" \
             scripts/prepare-server-provision-tools.sh
 BASH
@@ -195,8 +228,10 @@ BASH
         sh '''
           bash <<'BASH'
             set -euo pipefail
-            chmod +x "${PROVISION_TOOLS_DIR:-provision-tools}/otelcol-contrib" \
-              "${PROVISION_TOOLS_DIR:-provision-tools}/spacetime/spacetime" \
+            if [[ "${ENABLE_OTELCOL:-true}" == "true" ]]; then
+              chmod +x "${PROVISION_TOOLS_DIR:-provision-tools}/otelcol-contrib"
+            fi
+            chmod +x "${PROVISION_TOOLS_DIR:-provision-tools}/spacetime/spacetime" \
               "${PROVISION_TOOLS_DIR:-provision-tools}/spacetime/bin/current/spacetimedb-cli" \
               "${PROVISION_TOOLS_DIR:-provision-tools}/spacetime/bin/current/spacetimedb-standalone"
             chmod +x scripts/jenkins-server-provision.sh