create-entity-server 0.9.14 → 0.9.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-entity-server",
-  "version": "0.9.14",
+  "version": "0.9.16",
   "description": "Create a new entity-server project in one command — like create-react-app or create-vite.",
   "keywords": [
     "entity-server",

package/template/scripts/run.sh

@@ -1,7 +1,9 @@
 #!/bin/bash
 # Entity Server - Run Script
 
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# 심볼릭 링크 경로(/home/codeshop → /data/codeshop)로 실행돼도 systemd ExecStart 의 실경로와
+# 매칭되도록 pwd -P 로 실경로로 정규화한다. (find_systemd_service 의 ExecStart 매칭에 필요)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 
 cd "$PROJECT_ROOT"
@@ -45,6 +47,15 @@ find_systemd_service() {
     [ -z "$namespace" ] && namespace="default"
 
     local svc_name="${namespace}-entity-server.service"
+
+    # 유닛이 실제로 로드되어 있는지 먼저 확인한다.
+    # (등록되지 않은 유닛은 LoadState=not-found 이며, 이 경우 systemd 서비스로 취급하지 않는다.)
+    local load_state=""
+    load_state=$(systemctl show -p LoadState --value "$svc_name" 2>/dev/null || true)
+    if [ "$load_state" != "loaded" ]; then
+        return 1
+    fi
+
     local exec_start=""
     exec_start=$(systemctl show -p ExecStart --value "$svc_name" 2>/dev/null || true)
 
@@ -135,6 +146,12 @@ is_pid_running() {
         return 1
     fi
 
+    # 리눅스: /proc 로 먼저 확인한다. kill -0 은 다른 사용자(root) 프로세스에 대해
+    # EPERM 으로 실패해 "없음"으로 오판하므로, 존재 확인에 의존하면 안 된다.
+    if [ -d "/proc/$pid" ]; then
+        return 0
+    fi
+
     if kill -0 "$pid" 2>/dev/null; then
         return 0
     fi
@@ -148,6 +165,18 @@ is_pid_running() {
     return 1
 }
 
+# PID를 종료합니다. 권한이 부족하면(다른 사용자/root 소유) sudo 로 재시도합니다.
+kill_pid_signal() {
+    local sig="$1"
+    local pid="$2"
+
+    if kill "$sig" "$pid" 2>/dev/null; then
+        return 0
+    fi
+    # 권한 부족 등으로 실패하면 sudo 로 한 번 더 시도한다.
+    sudo -n kill "$sig" "$pid" 2>/dev/null || true
+}
+
 # PID를 종료하고 남아 있으면 강제 종료까지 진행합니다.
 force_stop_pid() {
     local pid="$1"
@@ -156,7 +185,7 @@ force_stop_pid() {
         return 1
     fi
 
-    kill "$pid" 2>/dev/null || true
+    kill_pid_signal -TERM "$pid"
     if is_pid_running "$pid" && has_command powershell.exe; then
         powershell.exe -NoProfile -Command "Stop-Process -Id $pid -ErrorAction SilentlyContinue" >/dev/null 2>&1 || true
     fi
@@ -168,7 +197,7 @@ force_stop_pid() {
         sleep 0.1
     done
 
-    kill -9 "$pid" 2>/dev/null || true
+    kill_pid_signal -KILL "$pid"
     if is_pid_running "$pid" && has_command powershell.exe; then
         powershell.exe -NoProfile -Command "Stop-Process -Id $pid -Force -ErrorAction SilentlyContinue" >/dev/null 2>&1 || true
     fi
@@ -318,7 +347,37 @@ find_server_pids() {
     port=$(get_server_value "port" "3400")
 
     if has_command ss; then
-        ss -ltnp 2>/dev/null | sed -n "s/.*:$port .*pid=\([0-9]\+\).*/\1/p" | sort -u
+        local ss_pids
+        ss_pids="$(ss -ltnp 2>/dev/null | sed -n "s/.*:$port .*pid=\([0-9]\+\).*/\1/p" | sort -u)"
+        if [ -n "$ss_pids" ]; then
+            echo "$ss_pids"
+            return
+        fi
+
+        # ss 가 LISTEN 은 보이는데 PID 가 비어 있으면, 다른 사용자(root 등) 소유 소켓이라
+        # 일반 권한으로 PID 가 안 보이는 경우다. sudo 로 한 번 더, 그 다음 lsof/fuser 로 보강한다.
+        if ss -ltn 2>/dev/null | grep -q ":$port "; then
+            local sudo_pids
+            sudo_pids="$(sudo -n ss -ltnp 2>/dev/null | sed -n "s/.*:$port .*pid=\([0-9]\+\).*/\1/p" | sort -u)"
+            if [ -n "$sudo_pids" ]; then
+                echo "$sudo_pids"
+                return
+            fi
+
+            if has_command lsof; then
+                local lsof_pids
+                lsof_pids="$(sudo -n lsof -tiTCP:"$port" -sTCP:LISTEN 2>/dev/null | awk '/^[0-9]+$/' | sort -u)"
+                if [ -n "$lsof_pids" ]; then
+                    echo "$lsof_pids"
+                    return
+                fi
+            fi
+
+            if has_command fuser; then
+                sudo -n fuser "$port"/tcp 2>/dev/null | tr ' ' '\n' | awk '/^[0-9]+$/' | sort -u
+                return
+            fi
+        fi
         return
     fi
 
@@ -423,9 +482,11 @@ show_unmanaged_server_message() {
     if [ "$LANGUAGE" = "en" ]; then
         echo "ℹ️  A process is using port $port, but it was not started by this project's pid file."
         echo "   For safety, run.sh stop does not kill processes based on port match alone."
+        echo "   To kill it anyway (by port, ignoring process name): ./run.sh stop --force"
     else
         echo "ℹ️  포트 $port 를 사용하는 프로세스가 있지만, 현재 프로젝트의 pid 파일로 시작한 서버가 아닙니다."
         echo "   안전을 위해 run.sh stop 은 포트 일치만으로 프로세스를 종료하지 않습니다."
+        echo "   그래도 종료하려면(포트 기준, 프로세스명 무시): ./run.sh stop --force"
     fi
 
     print_port_process_details
@@ -467,7 +528,94 @@ stop_pid_with_confirm() {
     return 1
 }
 
+# 설정 포트를 점유한 모든 PID 를 프로세스명과 무관하게 강제 종료한다 (--force 전용).
+# systemd 서비스가 등록돼 있으면 먼저 'systemctl stop' 으로 완전히 중지한다.
+#   - systemctl stop 은 명시적 중지라 Restart=always 정책을 트리거하지 않는다.
+#   - 반대로, 서비스를 stop 하지 않고 PID 만 kill 하면 systemd 가 비정상 종료로 보고 즉시 재기동한다.
+# stop 이후에도 포트를 쥔 잔여(고아) 프로세스가 있으면 그때 kill 한다(이미 unit 이 멈춰 재기동 안 됨).
+force_stop_by_port() {
+    local port
+    port=$(get_server_value "port" "3400")
+
+    local svc=""
+    svc=$(find_systemd_service || true)
+    if [ -n "$svc" ]; then
+        local svc_state=""
+        svc_state=$(systemctl is-active "$svc" 2>/dev/null || true)
+        if [ "$svc_state" = "active" ] || [ "$svc_state" = "activating" ] || [ "$svc_state" = "failed" ]; then
+            echo "ℹ️  systemd 서비스 완전 중지: $svc"
+            sudo systemctl stop "$svc"
+            # 포트가 풀릴 때까지 잠시 대기 (systemctl stop 은 재기동을 유발하지 않는다)
+            local i=0
+            while [ "$i" -lt 30 ]; do
+                if [ -z "$(find_server_pids | head -n 1)" ]; then
+                    break
+                fi
+                sleep 0.1
+                i=$((i + 1))
+            done
+        fi
+    fi
+
+    rm -f "$PID_FILE"
+
+    local killed_any=0
+    local pid=""
+    while read -r pid; do
+        pid=$(echo "$pid" | tr -d '[:space:]')
+        [ -z "$pid" ] && continue
+        local name=""
+        name=$(get_pid_name "$pid")
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "⚠️  --force: killing PID $pid (${name:-unknown}) on port $port"
+        else
+            echo "⚠️  --force: 포트 $port 점유 PID $pid (${name:-unknown}) 강제 종료"
+        fi
+        if force_stop_pid "$pid"; then
+            killed_any=1
+        else
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "❌ failed to kill PID $pid"
+            else
+                echo "❌ PID $pid 종료 실패"
+            fi
+            return 1
+        fi
+    done < <(find_server_pids)
+
+    if [ "$killed_any" -eq 1 ]; then
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "✅ ${SERVER_NAME} force-stopped (port $port)"
+        else
+            echo "✅ ${SERVER_NAME} 강제 종료 완료 (포트 $port)"
+        fi
+        return 0
+    fi
+
+    if [ -n "$svc" ]; then
+        if [ "$LANGUAGE" = "en" ]; then
+            echo "✅ ${SERVER_NAME} stopped via systemd (port $port released)"
+        else
+            echo "✅ ${SERVER_NAME} systemd 로 중지됨 (포트 $port 해제)"
+        fi
+        return 0
+    fi
+
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "ℹ️  no process is occupying port $port."
+    else
+        echo "ℹ️  포트 $port 를 점유한 프로세스가 없습니다."
+    fi
+    return 0
+}
+
 stop_server() {
+    # --force: 프로세스명을 따지지 않고 포트 점유 PID 를 무조건 종료한다.
+    if [ "${FORCE_STOP:-0}" -eq 1 ]; then
+        force_stop_by_port
+        return $?
+    fi
+
     local svc=""
     svc=$(find_systemd_service || true)
     if [ -n "$svc" ]; then
@@ -584,14 +732,17 @@ if [ $# -eq 0 ]; then
         echo "Modes:"
         echo "  dev   environment=development, keep database.default, then run binary"
         echo "  start run current config in background without modifying configs"
-        echo "  stop  stop background server started by this script"
+        echo "  stop  stop background server started by this script (--force: kill by port)"
+        echo "  restart restart server (--force: force-kill by port, then start)"
         echo "  status show server status"
         echo ""
         echo "Examples:"
-        echo "  $0 dev     # Start in development mode"
-        echo "  $0 start   # Start current config in background"
-        echo "  $0 stop    # Stop server"
-        echo "  $0 status  # Show status"
+        echo "  $0 dev            # Start in development mode"
+        echo "  $0 start          # Start current config in background"
+        echo "  $0 stop           # Stop server"
+        echo "  $0 stop --force   # Kill whatever occupies the port (ignore process name)"
+        echo "  $0 restart --force # Force-kill by port, then start"
+        echo "  $0 status         # Show status"
     else
         echo "Entity Server - 실행 스크립트"
         echo "==========================="
@@ -603,38 +754,33 @@ if [ $# -eq 0 ]; then
         echo "모드:"
         echo "  dev   environment=development로 설정하고 database.default는 유지한 채 바이너리 실행"
         echo "  start 설정파일을 수정하지 않고 현재 설정 그대로 백그라운드 실행"
-        echo "  stop    run.sh로 백그라운드 실행한 서버 중지"
-        echo "  restart 서버 재시작"
+        echo "  stop    run.sh로 백그라운드 실행한 서버 중지 (--force: 포트 기준 강제 종료)"
+        echo "  restart 서버 재시작 (--force: 포트 기준 강제 종료 후 시작)"
         echo "  status  서버 상태 조회"
         echo ""
         echo "예제:"
-        echo "  $0 dev     # 개발 모드로 시작"
-        echo "  $0 start   # 현재 설정 그대로 시작(백그라운드)"
-        echo "  $0 stop    # 서버 중지"
-        echo "  $0 restart # 서버 재시작"
-        echo "  $0 status  # 상태 조회"
-    fi
-
-    echo ""
-    if [ -f "$SERVER_CONFIG" ] && [ -f "$DATABASE_CONFIG" ] && [ -f "$SERVER_BIN" ]; then
-        if [ "$LANGUAGE" = "en" ]; then
-            echo "Current status:"
-        else
-            echo "현재 상태:"
-        fi
-        show_status
-    else
-        if [ "$LANGUAGE" = "en" ]; then
-            echo "Current status: unavailable (missing config or server binary)"
-        else
-            echo "현재 상태: 확인 불가 (설정 파일 또는 서버 바이너리 없음)"
-        fi
+        echo "  $0 dev             # 개발 모드로 시작"
+        echo "  $0 start           # 현재 설정 그대로 시작(백그라운드)"
+        echo "  $0 stop            # 서버 중지"
+        echo "  $0 stop --force    # 포트 점유 프로세스를 이름 무관 강제 종료"
+        echo "  $0 restart --force # 포트 기준 강제 종료 후 재시작"
+        echo "  $0 status          # 상태 조회"
     fi
     exit 0
 fi
 
 MODE="$1"
 
+# --force: 프로세스명을 따지지 않고, 설정 포트를 점유한 PID 면 무조건 종료한다.
+FORCE_STOP=0
+for arg in "$@"; do
+    case "$arg" in
+        --force | -f)
+            FORCE_STOP=1
+            ;;
+    esac
+done
+
 if [ ! -f "$SERVER_CONFIG" ]; then
     if [ "$LANGUAGE" = "en" ]; then
         echo "❌ configs/server.json not found"
@@ -666,6 +812,22 @@ fi
 
 case "$MODE" in
     dev|development)
+        # systemd 서비스로 등록된 환경에서는 dev 직접 실행을 막고 안내만 한다.
+        # (dev 는 설정을 development 로 바꾸고 포그라운드 실행하므로 systemd 운영과 충돌한다)
+        dev_svc=$(find_systemd_service || true)
+        if [ -n "$dev_svc" ]; then
+            if [ "$LANGUAGE" = "en" ]; then
+                echo "ℹ️  '$dev_svc' is registered as a systemd service; dev mode is disabled."
+                echo "   Use: sudo systemctl start/stop/restart $dev_svc  (or ./run.sh start|stop|restart)"
+                echo "   To run dev mode, remove the service first: sudo ./scripts/service-remove.sh"
+            else
+                echo "ℹ️  '$dev_svc' 가 systemd 서비스로 등록되어 있어 dev 모드 실행을 막습니다."
+                echo "   사용: sudo systemctl start/stop/restart $dev_svc  (또는 ./run.sh start|stop|restart)"
+                echo "   dev 모드로 실행하려면 먼저 서비스를 제거하세요: sudo ./scripts/service-remove.sh"
+            fi
+            exit 0
+        fi
+
         running_pid=$(find_active_server_pid || true)
         if [ -n "$running_pid" ]; then
             if [ "$LANGUAGE" = "en" ]; then
@@ -702,6 +864,11 @@ case "$MODE" in
                 echo "   재시작: sudo systemctl restart $svc"
                 exit 0
             fi
+            # 부팅 시 자동 시작되도록 enable 까지 함께 켠다 (이미 enabled 면 멱등).
+            if [ "$(systemctl is-enabled "$svc" 2>/dev/null || true)" != "enabled" ]; then
+                echo "ℹ️  systemd 서비스 자동시작 등록(enable): $svc"
+                sudo systemctl enable "$svc" 2>/dev/null || true
+            fi
             echo "ℹ️  systemd 서비스 시작: $svc"
             sudo systemctl start "$svc"
             echo "✅ ${SERVER_NAME} 시작 완료 (systemd)"
@@ -767,10 +934,23 @@ case "$MODE" in
         ;;
 
     stop)
+        # 명시적 stop 은 부팅 자동시작도 끈다(disable). restart 는 이 경로를 타지 않으므로
+        # enable 상태가 유지된다. (start=enable 과 대칭)
+        stop_svc=$(find_systemd_service || true)
+        if [ -n "$stop_svc" ] && [ "$(systemctl is-enabled "$stop_svc" 2>/dev/null || true)" = "enabled" ]; then
+            echo "ℹ️  systemd 서비스 자동시작 해제(disable): $stop_svc"
+            sudo systemctl disable "$stop_svc" 2>/dev/null || true
+        fi
         stop_server
         ;;
 
     restart)
+        # --force restart: 포트 점유 프로세스를 이름 무관 강제 종료한 뒤 재기동한다.
+        if [ "$FORCE_STOP" -eq 1 ]; then
+            stop_server || exit $?
+            exec "$SCRIPT_DIR/run.sh" start
+        fi
+
         svc=$(find_systemd_service || true)
         if [ -n "$svc" ]; then
             echo "ℹ️  systemd 서비스 재시작: $svc"

package/template/scripts/service-install.sh

@@ -7,9 +7,17 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 
-# Load language from .env
+# Load language and namespace from .env
+# run.sh 와 동일한 서비스명을 산출하기 위해 SERVER_NAMESPACE/NAMESPACE 를 .env 에서 읽는다.
+# (run.sh 는 .env 를 source 하므로, 여기서도 같은 값을 반영하지 않으면 서비스명이 어긋난다.)
 if [ -f "$PROJECT_ROOT/.env" ]; then
     LANGUAGE=$(sed -n 's/^LANGUAGE=//p' "$PROJECT_ROOT/.env" | tail -n 1)
+    if [ -z "${SERVER_NAMESPACE:-}" ]; then
+        SERVER_NAMESPACE=$(sed -n 's/^SERVER_NAMESPACE=//p' "$PROJECT_ROOT/.env" | tail -n 1)
+    fi
+    if [ -z "${NAMESPACE:-}" ]; then
+        NAMESPACE=$(sed -n 's/^NAMESPACE=//p' "$PROJECT_ROOT/.env" | tail -n 1)
+    fi
 fi
 LANGUAGE=${LANGUAGE:-ko}
 
@@ -65,6 +73,19 @@ if [ "$EUID" -ne 0 ]; then
     exit 1
 fi
 
+# 이미 등록되어 있는지 먼저 확인한다. 등록돼 있으면 기존 ExecStart 와 함께 안내하고
+# 재등록(덮어쓰기)으로 진행한다. (경로 변경 등으로 재설치가 필요한 경우가 있으므로 막지 않는다)
+if systemctl list-unit-files 2>/dev/null | grep -q "^${SERVICE_NAME}\.service" || [ -f "$UNIT_PATH" ]; then
+    existing_exec=$(systemctl show -p ExecStart --value "${SERVICE_NAME}.service" 2>/dev/null || true)
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "ℹ️  Service '$SERVICE_NAME' is already registered. Re-installing (overwrite)."
+        [ -n "$existing_exec" ] && echo "   current ExecStart: $existing_exec"
+    else
+        echo "ℹ️  '$SERVICE_NAME' 서비스가 이미 등록되어 있습니다. 재등록(덮어쓰기)합니다."
+        [ -n "$existing_exec" ] && echo "   현재 ExecStart: $existing_exec"
+    fi
+fi
+
 cat > "$UNIT_PATH" <<EOF
 [Unit]
 Description=Entity Server

package/template/scripts/service-remove.sh

@@ -7,9 +7,17 @@ set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
 
-# Load language from .env
+# Load language and namespace from .env
+# run.sh 와 동일한 서비스명을 산출하기 위해 SERVER_NAMESPACE/NAMESPACE 를 .env 에서 읽는다.
+# (run.sh 는 .env 를 source 하므로, 여기서도 같은 값을 반영하지 않으면 서비스명이 어긋난다.)
 if [ -f "$PROJECT_ROOT/.env" ]; then
     LANGUAGE=$(sed -n 's/^LANGUAGE=//p' "$PROJECT_ROOT/.env" | tail -n 1)
+    if [ -z "${SERVER_NAMESPACE:-}" ]; then
+        SERVER_NAMESPACE=$(sed -n 's/^SERVER_NAMESPACE=//p' "$PROJECT_ROOT/.env" | tail -n 1)
+    fi
+    if [ -z "${NAMESPACE:-}" ]; then
+        NAMESPACE=$(sed -n 's/^NAMESPACE=//p' "$PROJECT_ROOT/.env" | tail -n 1)
+    fi
 fi
 LANGUAGE=${LANGUAGE:-ko}
 
@@ -54,6 +62,31 @@ for arg in "$@"; do
     esac
 done
 
+UNIT_PATH="/etc/systemd/system/${SERVICE_NAME}.service"
+
+# 제거를 묻기 전에 서비스가 실제로 등록되어 있는지 먼저 확인한다.
+# (등록되어 있지 않으면 묻지 않고 안내만 출력하고 종료한다.)
+SERVICE_EXISTS=false
+if systemctl list-unit-files 2>/dev/null | grep -q "^${SERVICE_NAME}\.service"; then
+    SERVICE_EXISTS=true
+fi
+if [ ! -f "$UNIT_PATH" ] && [ "$SERVICE_EXISTS" = false ]; then
+    if [ "$LANGUAGE" = "en" ]; then
+        echo "ℹ️  Service '$SERVICE_NAME' is not registered."
+        echo "   Nothing to remove."
+        echo ""
+        echo "   To register the service, run:"
+        echo "   sudo $(dirname "$0")/service-install.sh"
+    else
+        echo "ℹ️  '$SERVICE_NAME' 서비스가 등록되어 있지 않습니다."
+        echo "   제거할 항목이 없습니다."
+        echo ""
+        echo "   서비스를 등록하려면:"
+        echo "   sudo $(dirname "$0")/service-install.sh"
+    fi
+    exit 0
+fi
+
 if [ "$INTERACTIVE" = true ] && [ "$CONFIRMED" = false ]; then
     if [ "$LANGUAGE" = "en" ]; then
         echo "[interactive] systemd service removal"
@@ -79,8 +112,6 @@ if [ "$INTERACTIVE" = true ] && [ "$CONFIRMED" = false ]; then
     fi
 fi
 
-UNIT_PATH="/etc/systemd/system/${SERVICE_NAME}.service"
-
 if [ "$EUID" -ne 0 ]; then
     if command -v sudo >/dev/null 2>&1; then
         exec sudo "$0" --yes
@@ -93,27 +124,6 @@ if [ "$EUID" -ne 0 ]; then
     exit 1
 fi
 
-SERVICE_EXISTS=false
-if systemctl list-unit-files | grep -q "^${SERVICE_NAME}\.service"; then
-    SERVICE_EXISTS=true
-fi
-if [ ! -f "$UNIT_PATH" ] && [ "$SERVICE_EXISTS" = false ]; then
-    if [ "$LANGUAGE" = "en" ]; then
-        echo "ℹ️  Service '$SERVICE_NAME' is not registered."
-        echo "   Nothing to remove."
-        echo ""
-        echo "   To register the service, run:"
-        echo "   sudo $(dirname "$0")/service-install.sh"
-    else
-        echo "ℹ️  '$SERVICE_NAME' 서비스가 등록되어 있지 않습니다."
-        echo "   제거할 항목이 없습니다."
-        echo ""
-        echo "   서비스를 등록하려면:"
-        echo "   sudo $(dirname "$0")/service-install.sh"
-    fi
-    exit 0
-fi
-
 if [ "$SERVICE_EXISTS" = true ]; then
     systemctl stop "$SERVICE_NAME" 2>/dev/null || true
     systemctl disable "$SERVICE_NAME" 2>/dev/null || true