cancan-microstack 0.0.1__py3-none-any.whl

cancan_microstack/assets/scripts/podman/start_podman.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+
+# controllersrv 启动脚本（Podman 详细日志版）
+
+# 设置脚本错误时退出
+set -e
+
+# 获取脚本所在目录的绝对路径
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# 日志前缀
+LOG_PREFIX="[controllersrv]"
+
+echo "$LOG_PREFIX 正在初始化..."
+echo "$LOG_PREFIX 项目根目录: $PROJECT_ROOT"
+
+# 切换到项目根目录
+cd "$PROJECT_ROOT"
+
+# 检查环境
+if [ -d "venv" ]; then
+    source venv/bin/activate
+    PYTHON_CMD="python"
+    echo "$LOG_PREFIX 激活虚拟环境: $(which python)"
+else
+    PYTHON_CMD="python3"
+    echo "$LOG_PREFIX 使用系统 Python: $(which python3)"
+fi
+
+# 检查 Python 版本
+PY_VERSION=$($PYTHON_CMD --version 2>&1)
+echo "$LOG_PREFIX Python 版本: $PY_VERSION"
+
+# 设置环境变量
+export NE_CONFIG=prod
+export PYTHONPATH="$PROJECT_ROOT/src:$PROJECT_ROOT/src/libs:$PROJECT_ROOT/cmd:$PYTHONPATH"
+echo "$LOG_PREFIX 环境变量 PYTHONPATH 设置完成"
+
+# 创建日志目录
+mkdir -p "$PROJECT_ROOT/server_log_data"
+LOG_FILE="$PROJECT_ROOT/server_log_data/controllersrv-startup.log"
+PID_FILE="$PROJECT_ROOT/server_log_data/controllersrv.pid"
+
+# 清理旧 PID
+if [ -f "$PID_FILE" ]; then
+    rm -f "$PID_FILE"
+fi
+
+# 检查端口
+if lsof -i :22100 -sTCP:LISTEN -t >/dev/null ; then
+    echo "❌ $LOG_PREFIX 端口 22100 被占用，无法启动"
+    exit 1
+fi
+
+# 启动服务
+echo "$LOG_PREFIX 正在启动后台进程..."
+echo "$LOG_PREFIX 日志输出至: $LOG_FILE"
+
+nohup $PYTHON_CMD cmd/controllersrv/run.py > "$LOG_FILE" 2>&1 &
+SERVICE_PID=$!
+echo $SERVICE_PID > "$PID_FILE"
+echo "$LOG_PREFIX 进程已启动，PID: $SERVICE_PID"
+
+# 健康检查
+echo "$LOG_PREFIX 等待健康检查 (http://localhost:22100/internal/health)..."
+MAX_RETRIES=30
+for ((i=1; i<=MAX_RETRIES; i++)); do
+    # 检查进程是否存在
+    if ! ps -p $SERVICE_PID > /dev/null 2>&1; then
+        echo ""
+        echo "❌ $LOG_PREFIX 进程意外退出！"
+        echo "---------------------------------------------------"
+        tail -n 10 "$LOG_FILE"
+        echo "---------------------------------------------------"
+        rm -f "$PID_FILE"
+        exit 1
+    fi
+
+    if curl -s http://localhost:22100/internal/health >/dev/null; then
+        echo "✅ $LOG_PREFIX 健康检查通过！服务已就绪。"
+        exit 0
+    fi
+    
+    sleep 1
+done
+
+echo "❌ $LOG_PREFIX 启动超时，强制停止..."
+kill $SERVICE_PID 2>/dev/null || true
+rm -f "$PID_FILE"
+exit 1

cancan_microstack/assets/scripts/podman/stop.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+
+# controllersrv 停止脚本（详细版）
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+PID_FILE="$PROJECT_ROOT/server_log_data/controllersrv.pid"
+LOG_PREFIX="[controllersrv-stop]"
+CONTROLLER_PORT=22100
+
+stop_by_pid() {
+    local target_pid=$1
+    echo "$LOG_PREFIX 正在发送 SIGTERM 信号给 PID: $target_pid ..."
+    if ! kill "$target_pid" 2>/dev/null; then
+        echo "ℹ️  $LOG_PREFIX PID $target_pid 已不存在 / already gone"
+        return 0
+    fi
+
+    echo -n "$LOG_PREFIX 等待进程退出 / waiting for exit"
+    for i in {1..10}; do
+        if ! ps -p "$target_pid" > /dev/null 2>&1; then
+            echo ""
+            echo "✅ $LOG_PREFIX PID $target_pid 已正常停止"
+            return 0
+        fi
+        echo -n "."
+        sleep 1
+    done
+
+    echo ""
+    echo "⚠️  $LOG_PREFIX PID $target_pid 响应超时，正在强制 kill -9 ..."
+    kill -9 "$target_pid" 2>/dev/null || true
+    echo "✅ $LOG_PREFIX PID $target_pid 已强制停止"
+}
+
+stop_by_port() {
+    # 兜底逻辑：当 PID 文件缺失时，通过端口检测正在运行的 controllersrv 实例
+    # Fallback: kill processes listening on controllersrv port when the PID file is missing
+    if ! command -v lsof >/dev/null 2>&1; then
+        echo "ℹ️  $LOG_PREFIX 未运行 (缺少 lsof，无法检测端口)"
+        exit 0
+    fi
+
+    local port_pids
+    port_pids=$(lsof -i :$CONTROLLER_PORT -sTCP:LISTEN -t 2>/dev/null || true)
+    if [ -z "$port_pids" ]; then
+        echo "ℹ️  $LOG_PREFIX 未运行 (未检测到监听 $CONTROLLER_PORT 的进程)"
+        exit 0
+    fi
+
+    echo "⚠️  $LOG_PREFIX 未找到 PID 文件，但检测到监听 $CONTROLLER_PORT 的进程: $port_pids"
+    for pid in $port_pids; do
+        stop_by_pid "$pid"
+    done
+    echo "✅ $LOG_PREFIX 已通过端口兜底逻辑停止 controllersrv"
+}
+
+if [ -f "$PID_FILE" ]; then
+    OLD_PID=$(cat "$PID_FILE")
+    if ! ps -p "$OLD_PID" > /dev/null 2>&1; then
+        echo "ℹ️  $LOG_PREFIX 进程 $OLD_PID 不存在，清理残留文件"
+        rm -f "$PID_FILE"
+        stop_by_port
+        exit 0
+    fi
+
+    stop_by_pid "$OLD_PID"
+    rm -f "$PID_FILE"
+    exit 0
+fi
+
+stop_by_port

cancan_microstack/assets/scripts/podman/stop_all_podman.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+
+# 一键停止脚本（Podman 并行版）
+
+# 设置脚本错误时退出
+set -e
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+echo "========================================="
+echo "🛑 一键停止所有服务"
+echo "========================================="
+echo "当前时间: $(date '+%Y-%m-%d %H:%M:%S')"
+echo ""
+
+# 并行执行停止
+(
+    echo "🔵 [任务 1] 停止 controllersrv..."
+    bash "$SCRIPT_DIR/stop.sh" && echo "✅ [任务 1] controllersrv 已停止"
+) &
+PID_1=$!
+
+(
+    echo "🟣 [任务 2] 停止 Podman Compose 集群..."
+    bash "$SCRIPT_DIR/stop_compose_podman.sh" && echo "✅ [任务 2] Compose 集群已停止"
+) &
+PID_2=$!
+
+wait $PID_1
+wait $PID_2
+
+echo ""
+echo "========================================="
+echo "✅ 所有服务已停止"
+echo "========================================="

cancan_microstack/assets/scripts/podman/stop_compose_podman.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+
+# Podman Compose 停止脚本 (强力版)
+# 能够识别并停止所有相关容器，包括僵尸进程
+
+set -e
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+LOG_PREFIX="[compose-stop]"
+
+echo "$LOG_PREFIX 正在扫描运行中的服务..."
+cd "$PROJECT_ROOT"
+
+# 1. 发现容器
+# 搜索逻辑：匹配 'my_app' (项目前缀) 或明确的服务名称
+# 使用 --no-trunc 确保名字完整
+TARGETS=$(podman ps --format "{{.Names}}" | grep -E "my_app|postgres.internal|redis.internal|rabbitmq.internal|infrasrv|opsbffsrv|besrv" || true)
+
+if [ -z "$TARGETS" ]; then
+    echo "✅ $LOG_PREFIX 没有发现运行中的相关容器"
+    exit 0
+fi
+
+# 转换换行符为空格，形成列表
+CONTAINER_LIST=$(echo "$TARGETS" | tr '\n' ' ')
+
+echo "$LOG_PREFIX 发现以下容器正在运行:"
+echo "$TARGETS" | sed "s/^/  - /"
+echo ""
+
+# 2. 停止容器 (并行发送 SIGTERM)
+echo "$LOG_PREFIX 正在发送停止信号 (Timeout=10s)..."
+# 忽略报错，确保脚本继续执行
+podman stop -t 10 $CONTAINER_LIST 2>/dev/null || true
+
+# 3. 检查残留并强制清理
+echo "$LOG_PREFIX 检查残留..."
+REMAINING=$(podman ps --format "{{.Names}}" | grep -E "my_app|postgres.internal|redis.internal|rabbitmq.internal|infrasrv|opsbffsrv|besrv" || true)
+
+if [ -n "$REMAINING" ]; then
+    echo "⚠️  $LOG_PREFIX 以下容器未响应停止信号，正在强制清除 (kill)..."
+    echo "$REMAINING" | sed "s/^/  - /"
+    
+    REMAINING_LIST=$(echo "$REMAINING" | tr '\n' ' ')
+    podman stop -t 0 $REMAINING_LIST 2>/dev/null || podman rm -f $REMAINING_LIST 2>/dev/null || true
+    
+    # 再次检查
+    FINAL_CHECK=$(podman ps --format "{{.Names}}" | grep -E "my_app|postgres.internal|redis.internal|rabbitmq.internal" || true)
+    if [ -n "$FINAL_CHECK" ]; then
+        echo "❌ $LOG_PREFIX 无法停止以下容器 (可能需要手动处理):"
+        echo "$FINAL_CHECK"
+        exit 1
+    fi
+    echo "✅ $LOG_PREFIX 已强制停止所有残留容器"
+else
+    echo "✅ $LOG_PREFIX 所有容器已正常停止"
+fi

cancan_microstack/assets/scripts/start_controllersrv.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+# controllersrv 启动脚本
+
+cd /Users/victor.lai/project/my_app_be
+
+export NE_CONFIG=dev
+export PYTHONPATH=/Users/victor.lai/project/my_app_be/src:/Users/victor.lai/project/my_app_be/src/libs:/Users/victor.lai/project/my_app_be/cmd
+
+/Users/victor.lai/project/my_app_be/venv/bin/python cmd/controllersrv/run.py

cancan_microstack/assets/scripts/utils/check_all_db_tables.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# 检查所有数据库表是否正确创建
+# 用于验证数据库初始化是否完整
+
+echo "======================================"
+echo "检查所有数据库表"
+echo "======================================"
+echo ""
+
+# 颜色定义
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# 检查数据库是否存在
+echo "1. 检查数据库是否存在"
+echo "-----------------------------------"
+databases=$(podman exec my_app_postgres psql -U postgres -t -c "SELECT datname FROM pg_database WHERE datname IN ('main', 'infra', 'ops', 'biz');")
+for db in main infra ops biz; do
+    if echo "$databases" | grep -q "$db"; then
+        echo -e "  ${GREEN}✓${NC} Database: $db"
+    else
+        echo -e "  ${RED}✗${NC} Database: $db (不存在)"
+    fi
+done
+echo ""
+
+# 检查 infra 数据库的表
+echo "2. 检查 infra 数据库的表"
+echo "-----------------------------------"
+expected_infra_tables=(
+    "service_info_tbl"
+    "service_config_tbl"
+    "service_action_log_tbl"
+)
+infra_tables=$(podman exec my_app_postgres psql -U postgres -d infra -t -c "\dt" | awk '{print $3}' | grep -v "^$")
+for table in "${expected_infra_tables[@]}"; do
+    if echo "$infra_tables" | grep -q "^$table$"; then
+        echo -e "  ${GREEN}✓${NC} infra.$table"
+    else
+        echo -e "  ${RED}✗${NC} infra.$table (不存在)"
+    fi
+done
+echo ""
+
+# 检查 ops 数据库的表
+echo "3. 检查 ops 数据库的表"
+echo "-----------------------------------"
+expected_ops_tables=(
+    "caddy_access_log_tbl"
+    "caddy_certificate_tbl"
+    "caddy_rate_limit_tbl"
+    "caddy_route_tbl"
+    "caddy_stats_tbl"
+)
+ops_tables=$(podman exec my_app_postgres psql -U postgres -d ops -t -c "\dt" | awk '{print $3}' | grep -v "^$")
+for table in "${expected_ops_tables[@]}"; do
+    if echo "$ops_tables" | grep -q "^$table$"; then
+        echo -e "  ${GREEN}✓${NC} ops.$table"
+    else
+        echo -e "  ${RED}✗${NC} ops.$table (不存在)"
+    fi
+done
+echo ""
+
+# 检查 biz 数据库的表
+echo "4. 检查 biz 数据库的表"
+echo "-----------------------------------"
+expected_biz_tables=(
+    "k_line_data_tbl"
+    "k_line_current_data_tbl"
+    "tech_article_tbl"
+)
+biz_tables=$(podman exec my_app_postgres psql -U postgres -d biz -t -c "\dt" | awk '{print $3}' | grep -v "^$")
+for table in "${expected_biz_tables[@]}"; do
+    if echo "$biz_tables" | grep -q "^$table$"; then
+        echo -e "  ${GREEN}✓${NC} biz.$table"
+    else
+        echo -e "  ${RED}✗${NC} biz.$table (不存在)"
+    fi
+done
+echo ""
+
+# 检查触发器函数是否存在
+echo "5. 检查触发器函数"
+echo "-----------------------------------"
+trigger_functions=("update_modified_column" "upd_timestamp")
+for db in infra ops biz; do
+    echo "  检查 $db 数据库的触发器函数："
+    functions=$(podman exec my_app_postgres psql -U postgres -d $db -t -c "SELECT proname FROM pg_proc WHERE pronamespace = (SELECT oid FROM pg_namespace WHERE nspname = 'public') AND proname IN ('update_modified_column', 'upd_timestamp');")
+    for func in "${trigger_functions[@]}"; do
+        if echo "$functions" | grep -q "$func"; then
+            echo -e "    ${GREEN}✓${NC} $func"
+        else
+            echo -e "    ${YELLOW}⚠${NC} $func (不存在，某些表可能需要此函数)"
+        fi
+    done
+done
+echo ""
+
+echo "======================================"
+echo "检查完成"
+echo "======================================"

cancan_microstack/assets/scripts/utils/check_env.sh

@@ -0,0 +1,177 @@
+#!/bin/bash
+
+# 容器环境检测脚本
+# 自动检测当前系统的容器引擎和 Compose 工具
+
+echo "========================================="
+echo "容器环境检测"
+echo "========================================="
+echo ""
+
+# 颜色定义
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# 检测 Docker
+echo "检测 Docker..."
+if command -v docker &> /dev/null; then
+    DOCKER_VERSION=$(docker --version 2>&1)
+    echo -e "${GREEN}✓ Docker 已安装:${NC} $DOCKER_VERSION"
+    
+    if docker info > /dev/null 2>&1; then
+        echo -e "${GREEN}✓ Docker 运行正常${NC}"
+    else
+        echo -e "${YELLOW}⚠ Docker 未运行${NC}"
+    fi
+    
+    # 检测 docker-compose
+    if command -v docker-compose &> /dev/null; then
+        DOCKER_COMPOSE_V1=$(docker-compose --version 2>&1)
+        echo -e "${GREEN}✓ docker-compose 已安装:${NC} $DOCKER_COMPOSE_V1"
+    else
+        echo -e "${YELLOW}⚠ docker-compose (v1) 未安装${NC}"
+    fi
+    
+    # 检测 docker compose
+    if docker compose version > /dev/null 2>&1; then
+        DOCKER_COMPOSE_V2=$(docker compose version 2>&1)
+        echo -e "${GREEN}✓ docker compose 已安装:${NC} $DOCKER_COMPOSE_V2"
+    else
+        echo -e "${YELLOW}⚠ docker compose (v2) 未安装${NC}"
+    fi
+else
+    echo -e "${RED}✗ Docker 未安装${NC}"
+fi
+
+echo ""
+echo "========================================="
+echo ""
+
+# 检测 Podman
+echo "检测 Podman..."
+if command -v podman &> /dev/null; then
+    PODMAN_VERSION=$(podman --version 2>&1)
+    echo -e "${GREEN}✓ Podman 已安装:${NC} $PODMAN_VERSION"
+    
+    if podman info > /dev/null 2>&1; then
+        echo -e "${GREEN}✓ Podman 运行正常${NC}"
+        
+        # macOS 上检测 Podman Machine
+        if [[ "$OSTYPE" == "darwin"* ]]; then
+            if podman machine list > /dev/null 2>&1; then
+                echo ""
+                echo "Podman Machine 状态:"
+                podman machine list
+            fi
+        fi
+    else
+        echo -e "${YELLOW}⚠ Podman 未运行${NC}"
+        
+        if [[ "$OSTYPE" == "darwin"* ]]; then
+            echo ""
+            echo "macOS 用户请启动 Podman Machine:"
+            echo "  podman machine init --cpus 4 --memory 8192 --disk-size 50"
+            echo "  podman machine start"
+        else
+            echo ""
+            echo "请检查 Podman 服务状态:"
+            echo "  sudo systemctl status podman"
+        fi
+    fi
+    
+    # 检测 podman-compose
+    if command -v podman-compose &> /dev/null; then
+        PODMAN_COMPOSE=$(podman-compose --version 2>&1)
+        echo -e "${GREEN}✓ podman-compose 已安装:${NC} $PODMAN_COMPOSE"
+    else
+        echo -e "${YELLOW}⚠ podman-compose 未安装${NC}"
+        echo "  安装命令: pip install podman-compose"
+    fi
+    
+    # 检测 podman compose (内置)
+    if podman compose version > /dev/null 2>&1; then
+        PODMAN_COMPOSE_BUILTIN=$(podman compose version 2>&1)
+        echo -e "${GREEN}✓ podman compose 可用:${NC} $PODMAN_COMPOSE_BUILTIN"
+    else
+        echo -e "${YELLOW}⚠ podman compose (内置) 不可用${NC}"
+    fi
+else
+    echo -e "${RED}✗ Podman 未安装${NC}"
+    echo ""
+    echo "安装 Podman:"
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        echo "  macOS: brew install podman"
+    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+        echo "  Linux: 参考 https://podman.io/getting-started/installation"
+    fi
+fi
+
+echo ""
+echo "========================================="
+echo "推荐配置"
+echo "========================================="
+echo ""
+
+# 判断推荐使用什么
+if command -v podman &> /dev/null && podman info > /dev/null 2>&1; then
+    echo -e "${GREEN}✓ 推荐使用 Podman 环境${NC}"
+    echo ""
+    echo "启动脚本:"
+    echo "  ./start_podman.sh          - 启动 controllersrv"
+    echo "  ./start_compose_podman.sh  - 启动 Podman Compose 集群"
+    echo "  ./start_all_podman.sh      - 一键启动所有服务"
+    echo ""
+    echo "停止脚本:"
+    echo "  ./stop.sh                  - 停止 controllersrv"
+    echo "  ./stop_compose_podman.sh   - 停止 Podman Compose 集群"
+    echo "  ./stop_all_podman.sh       - 一键停止所有服务"
+elif command -v docker &> /dev/null && docker info > /dev/null 2>&1; then
+    echo -e "${GREEN}✓ 推荐使用 Docker 环境${NC}"
+    echo ""
+    echo "启动脚本:"
+    echo "  ./start.sh          - 启动 controllersrv"
+    echo "  ./start_compose.sh  - 启动 Docker Compose 集群"
+    echo "  ./start_all.sh      - 一键启动所有服务"
+    echo ""
+    echo "停止脚本:"
+    echo "  ./stop.sh           - 停止 controllersrv"
+    echo "  ./stop_compose.sh   - 停止 Docker Compose 集群"
+    echo "  ./stop_all.sh       - 一键停止所有服务"
+else
+    echo -e "${RED}✗ 未检测到可用的容器环境${NC}"
+    echo ""
+    echo "请安装 Docker 或 Podman："
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        echo "  Docker:  https://www.docker.com/products/docker-desktop"
+        echo "  Podman:  brew install podman"
+    fi
+fi
+
+echo ""
+echo "========================================="
+echo "Python 环境检测"
+echo "========================================="
+echo ""
+
+if command -v python3 &> /dev/null; then
+    PYTHON_VERSION=$(python3 --version 2>&1)
+    echo -e "${GREEN}✓ Python3 已安装:${NC} $PYTHON_VERSION"
+else
+    echo -e "${RED}✗ Python3 未安装${NC}"
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+if [ -d "$PROJECT_ROOT/venv" ]; then
+    echo -e "${GREEN}✓ 虚拟环境存在:${NC} $PROJECT_ROOT/venv"
+else
+    echo -e "${YELLOW}⚠ 虚拟环境不存在${NC}"
+    echo "  创建命令: python3 -m venv venv"
+    echo "  激活命令: source venv/bin/activate"
+    echo "  安装依赖: pip install -r requirements.txt"
+fi
+
+echo ""