Initial managed-container HA resource agent baseline

2026-09-17 10:54:08 -04:00
commit b6c4fc848f
24 changed files with 4951 additions and 0 deletions
@@ -0,0 +1,113 @@
+#!/bin/bash
+
+# OCF Resource Agent:
+#   loxthelion:managed-container
+#
+# v0.4
+# Container lifecycle: systemd user Quadlet
+# Application profile: PostgreSQL
+#
+# Version 0.4 adds explicit PostgreSQL demotion scaffolding.
+# Healthy primaries report OCF_RUNNING_PROMOTED while healthy standbys
+# report OCF_SUCCESS.
+
+: "${OCF_ROOT:=/usr/lib/ocf}"
+OCF_FUNCTIONS_DIR="${OCF_ROOT}/lib/heartbeat"
+# Preserve explicit resource identity before ocf-shellfuncs supplies its
+# standalone-invocation default; never publish a score for that dummy resource.
+MC_PROMOTION_RESOURCE_INSTANCE="${OCF_RESOURCE_INSTANCE:-}"
+. "${OCF_FUNCTIONS_DIR}/ocf-shellfuncs"
+
+# Pacemaker uses "Promoted" terminology, while many OCF shell libraries
+# still expose the historical OCF_RUNNING_MASTER constant for return code 8.
+# Normalize both forms here so the agent remains portable.
+: "${OCF_RUNNING_PROMOTED:=${OCF_RUNNING_MASTER:-8}}"
+
+# Internal managed-containerd client return classes.
+# Private RA implementation statuses, not OCF action return codes.
+readonly MC_PROXY_RC_TRANSPORT=10
+readonly MC_PROXY_RC_HARD_FAILURE=11
+
+
+# Resolve modules relative to this entrypoint, independent of Pacemaker's cwd.
+MC_MODULE_DIR="$(CDPATH= cd -- "$(command dirname -- "${BASH_SOURCE[0]}")" && pwd)/managed-container.d"
+for MC_MODULE in proxy common container engine; do
+    if ! . "${MC_MODULE_DIR}/${MC_MODULE}.sh"; then
+        ocf_exit_reason "Unable to load resource-agent module ${MC_MODULE_DIR}/${MC_MODULE}.sh"
+        exit "${OCF_ERR_CONFIGURED}"
+    fi
+done
+
+# Structural self-test for release/deployment validation.
+# This deliberately runs through the real entrypoint module-loading path.
+if [ "${MC_ENTRYPOINT_SELFTEST:-0}" = "1" ]; then
+    for MC_REQUIRED_FUNCTION in \
+        mc_proxy_monitor \
+        mc_proxy_monitor_cache_clear \
+        mc_promotion_monitor
+    do
+        if ! command -V "${MC_REQUIRED_FUNCTION}" >/dev/null 2>&1; then
+            printf 'ENTRYPOINT_SELFTEST_MISSING=%s\n' \
+                "${MC_REQUIRED_FUNCTION}" >&2
+            exit 1
+        fi
+    done
+
+    printf '%s\n' 'ENTRYPOINT_STRUCTURE_OK=1'
+    exit 0
+fi
+
+unset MC_MODULE
+mc_engine_load || exit $?
+
+case "$1" in
+    meta-data)
+        mc_engine_metadata
+        exit $?
+        ;;
+
+    validate-all)
+        mc_promotion_validate
+        exit $?
+        ;;
+
+    monitor|status)
+        mc_promotion_monitor
+        exit $?
+        ;;
+
+    start)
+        mc_promotion_action start
+        exit $?
+        ;;
+
+    stop)
+        mc_promotion_action stop
+        exit $?
+        ;;
+
+    promote)
+        mc_promotion_action promote
+        exit $?
+        ;;
+
+    demote)
+        mc_promotion_action demote
+        exit $?
+        ;;
+
+    notify)
+        mc_application_notify
+        exit $?
+        ;;
+
+    rejoin)
+        mc_promotion_action rejoin
+        exit $?
+        ;;
+
+    *)
+        echo "Usage: $0 {start|stop|promote|demote|notify|rejoin|monitor|status|validate-all|meta-data}"
+        exit "${OCF_ERR_UNIMPLEMENTED}"
+        ;;
+esac