#!/usr/bin/env bash set -euo pipefail # DEPLOY-002 accepts a values file path only. Secret contents remain in # Kubernetes and are never expanded into this process or Helm arguments. values_file="${1:-}" chart_dir="${CHART:-deploy/helm/knowledge-platform}" release_name="${RELEASE:-knowledge-platform}" namespace="${NAMESPACE:-knowledge-platform}" deploy_timeout="${DEPLOY_TIMEOUT:-10m}" if [[ -z "${values_file}" || ! -f "${values_file}" ]]; then echo "VALUES must point to an existing environment values file" >&2 exit 2 fi for tool in helm kubectl; do if ! command -v "${tool}" >/dev/null 2>&1; then echo "required deployment tool is missing: ${tool}" >&2 exit 2 fi done # Helm 4 renamed --atomic to --rollback-on-failure. Select the equivalent flag # by major version while preserving compatibility with supported Helm 3. helm_version="$(helm version --template '{{.Version}}')" if [[ "${helm_version}" =~ ^v?([0-9]+) ]] && (( BASH_REMATCH[1] >= 4 )); then rollback_flag=(--rollback-on-failure) else rollback_flag=(--atomic) fi helm lint "${chart_dir}" --values "${values_file}" # The test-hook ConfigMap contains resource names only. Its fixed, controlled # shape lets awk extract names without adding a YAML parser or reading Secrets. preflight_yaml="$({ helm template "${release_name}" "${chart_dir}" \ --namespace "${namespace}" \ --values "${values_file}" \ --show-only templates/tests/preflight-references.yaml })" runtime_secret="$({ printf '%s\n' "${preflight_yaml}" | awk '$1 == "runtimeSecret:" {gsub(/\"/, "", $2); print $2}' })" ingress_enabled="$({ printf '%s\n' "${preflight_yaml}" | awk '$1 == "ingressEnabled:" {gsub(/\"/, "", $2); print $2}' })" rabbitmq_enabled="$({ printf '%s\n' "${preflight_yaml}" | awk '$1 == "rabbitmqEnabled:" {gsub(/\"/, "", $2); print $2}' })" if [[ -z "${runtime_secret}" || -z "${ingress_enabled}" || -z "${rabbitmq_enabled}" ]]; then echo "failed to resolve Helm Secret references" >&2 exit 2 fi secret_has_key() { local secret_name="$1" local key_name="$2" local present present="$({ kubectl -n "${namespace}" get secret "${secret_name}" \ -o go-template="{{with .data}}{{if index . \"${key_name}\"}}present{{end}}{{end}}" })" [[ "${present}" == "present" ]] } if ! kubectl get namespace "${namespace}" >/dev/null; then echo "target namespace does not exist: ${namespace}" >&2 exit 2 fi if ! kubectl -n "${namespace}" get secret "${runtime_secret}" >/dev/null; then echo "referenced runtime Secret does not exist: ${runtime_secret}" >&2 exit 2 fi required_runtime_keys=( DATABASE_URL RABBITMQ_URL BOS_ACCESS_KEY_ID BOS_SECRET_ACCESS_KEY BAIDU_QIANFAN_API_KEY OCEANBASE_VECTOR_PASSWORD MCP_AUTH_TOKEN ) for key in "${required_runtime_keys[@]}"; do if ! secret_has_key "${runtime_secret}" "${key}"; then echo "referenced runtime Secret is missing required key: ${key}" >&2 exit 2 fi done if [[ "${ingress_enabled}" == "true" ]]; then for key in apiTlsSecret mcpTlsSecret; do tls_secret="$({ printf '%s\n' "${preflight_yaml}" | awk -v field="${key}:" '$1 == field {gsub(/\"/, "", $2); print $2}' })" if ! kubectl -n "${namespace}" get secret "${tls_secret}" >/dev/null; then echo "referenced TLS Secret does not exist: ${tls_secret}" >&2 exit 2 fi done fi if [[ "${rabbitmq_enabled}" == "true" ]]; then rabbitmq_secret="$({ printf '%s\n' "${preflight_yaml}" | awk '$1 == "rabbitmqSecret:" {gsub(/\"/, "", $2); print $2}' })" if ! kubectl -n "${namespace}" get secret "${rabbitmq_secret}" >/dev/null; then echo "referenced RabbitMQ Secret does not exist: ${rabbitmq_secret}" >&2 exit 2 fi for key in username password erlang-cookie; do if ! secret_has_key "${rabbitmq_secret}" "${key}"; then echo "referenced RabbitMQ Secret is missing required key: ${key}" >&2 exit 2 fi done fi # The version-specific rollback flag keeps the previous release active when a # pre-upgrade migration or rollout fails. Helm serializes operations for this # release and waits for hook/workload readiness before returning success. helm upgrade --install "${release_name}" "${chart_dir}" \ --namespace "${namespace}" \ --values "${values_file}" \ "${rollback_flag[@]}" \ --wait \ --timeout "${deploy_timeout}" \ --history-max 10