ci(client-cpp): multi-toolchain package matrix for release zips

Add per-classifier SDK packages (glibc 2.17 on CentOS 7, Windows VS2015-2026), workflow_dispatch variant filter, and documentation for choosing the right zip.

Author: hongzhi-gao

.github/scripts/package-client-cpp-centos7.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with this
+# work for additional information regarding copyright ownership.  The ASF
+# licenses this file to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance with the
+# License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# Build client-cpp inside CentOS 7 + devtoolset-8 for glibc 2.17-compatible .so.
+set -euxo pipefail
+
+# CentOS 7 EOL: use vault mirrors when default mirrors are unavailable.
+if grep -q mirrorlist /etc/yum.repos.d/CentOS-*.repo 2>/dev/null; then
+  sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-*.repo
+  sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-*.repo
+fi
+
+yum install -y centos-release-scl epel-release
+yum install -y devtoolset-8-gcc devtoolset-8-gcc-c++ devtoolset-8-binutils \
+  make wget tar which git patch unzip
+
+CMAKE_VERSION=3.28.4
+CMAKE_DIR=/opt/cmake-${CMAKE_VERSION}
+if [[ ! -x "${CMAKE_DIR}/bin/cmake" ]]; then
+  wget -q "https://github.com/Kitware/CMake/releases/download/v${CMAKE_VERSION}/cmake-${CMAKE_VERSION}-linux-x86_64.tar.gz" \
+    -O /tmp/cmake.tar.gz
+  rm -rf "${CMAKE_DIR}"
+  mkdir -p /opt
+  tar xf /tmp/cmake.tar.gz -C /opt
+  mv "/opt/cmake-${CMAKE_VERSION}-linux-x86_64" "${CMAKE_DIR}"
+fi
+
+JAVA_HOME=/opt/jdk-17
+if [[ ! -x "${JAVA_HOME}/bin/java" ]]; then
+  wget -q "https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.13%2B11/OpenJDK17U-jdk_x64_linux_hotspot_17.0.13_11.tar.gz" \
+    -O /tmp/jdk17.tar.gz
+  rm -rf "${JAVA_HOME}"
+  mkdir -p /opt
+  tar xf /tmp/jdk17.tar.gz -C /opt
+  mv /opt/jdk-17.0.13+11 "${JAVA_HOME}"
+fi
+
+export PATH="${CMAKE_DIR}/bin:${JAVA_HOME}/bin:${PATH}"
+export JAVA_HOME
+
+scl enable devtoolset-8 -- bash -c '
+  set -euxo pipefail
+  gcc --version
+  cmake --version
+  java -version
+  cd "${GITHUB_WORKSPACE:?GITHUB_WORKSPACE is not set}"
+  ./mvnw clean package -P with-cpp -pl iotdb-client/client-cpp -am -DskipTests \
+    -Dspotless.skip=true \
+    -Dclient.cpp.package.classifier=linux-x86_64-glibc217
+'
+
+SO="iotdb-client/client-cpp/target/install/lib/libiotdb_session.so"
+test -f "${SO}"
+
+echo "=== Build host glibc ==="
+ldd --version | head -1
+
+echo "=== Highest GLIBC_* symbols in libiotdb_session.so ==="
+objdump -T "${SO}" | grep GLIBC_ | sed "s/.*GLIBC_/GLIBC_/" | sort -Vu | tail -10
+
+max_glibc=$(objdump -T "${SO}" | grep -oE "GLIBC_[0-9.]+" | sed "s/GLIBC_//" | sort -t. -k1,1n -k2,2n -k3,3n | tail -1)
+echo "max_glibc=${max_glibc}"
+
+# Fail if any symbol requires glibc newer than 2.17
+if awk -v max="${max_glibc}" "BEGIN { exit !(max > 2.17) }"; then
+  echo "ERROR: libiotdb_session.so requires glibc > 2.17 (max=${max_glibc})"
+  exit 1
+fi
+
+echo "glibc compatibility check passed (max=${max_glibc} <= 2.17)"