원격 디버깅 실전 가이드: SSH 터널 · VS Code · IntelliJ · PyCharm으로 Java·Node·Python·Go 원격 Attach

# 잘못된 예: 0.0.0.0으로 바인딩 → 모든 인터페이스에서 접근 가능
java -agentlib:jdwp=transport=dt_socket,server=y,address=0.0.0.0:5005,suspend=n -jar app.jar

# 올바른 예: localhost에만 바인딩
java -agentlib:jdwp=transport=dt_socket,server=y,address=127.0.0.1:5005,suspend=n -jar app.jar

# 로컬 5005 → 원격 서버 127.0.0.1:5005 로 터널
ssh -N -L 5005:127.0.0.1:5005 deploy@staging-server

# 백그라운드 실행 + 자동 재연결
ssh -f -N -L 5005:127.0.0.1:5005 deploy@staging-server
# -f: 백그라운드, -N: 명령 실행 안 함

# JDK 8
java -agentlib:jdwp=transport=dt_socket,server=y,address=5005,suspend=n \
  -jar myservice.jar

# JDK 9+ (주소 바인딩 문법 변경)
java -agentlib:jdwp=transport=dt_socket,server=y,address=127.0.0.1:5005,suspend=n \
  -jar myservice.jar

# Spring Boot Gradle 프로젝트에서 디버그 모드
./gradlew bootRun --debug-jvm
# → 기본 5005 포트에 suspend=y 로 대기

# 로컬 PC에서
ssh -N -L 5005:127.0.0.1:5005 deploy@staging-01.internal

# 이후 IDE에서 localhost:5005 로 attach

# 기본 inspect (연결 전에도 실행 계속)
node --inspect=127.0.0.1:9229 dist/server.js

# 첫 줄에서 멈춤 (초기화 코드 디버깅 시)
node --inspect-brk=127.0.0.1:9229 dist/server.js

# 이미 실행 중인 프로세스에 시그널로 inspect 활성화
kill -USR1 <PID>
# → stderr에 "Debugger listening on ws://127.0.0.1:9229/..." 출력

ssh -N -L 9229:127.0.0.1:9229 deploy@staging-node-server

# 1. 설치
pip install debugpy

# 2-A. CLI로 실행 (가장 단순)
python -m debugpy --listen 127.0.0.1:5678 --wait-for-client app.py

# 2-B. 코드에 삽입 (기존 실행 스크립트 유지할 때)

import debugpy

# 포트 5678에서 대기
debugpy.listen(("127.0.0.1", 5678))
print("Waiting for debugger attach...")
debugpy.wait_for_client()  # 디버거 붙을 때까지 블로킹
debugpy.breakpoint()       # 여기서 멈춤

# 이후 비즈니스 로직
def process_order(order_id):
    # 디버거로 여기까지 step-into 가능
    ...

# 2-C. 이미 실행 중인 프로세스에 attach (제한적)
# → debugpy를 코드에 미리 내장해야 함. 런타임 inject는 지원 안 됨.

ssh -N -L 5678:127.0.0.1:5678 deploy@staging-api-server

# 설치
go install github.com/go-delve/delve/cmd/dlv@latest

# 방법 A: 소스에서 빌드 + 디버그 (개발용)
dlv debug ./cmd/server \
  --headless --listen=127.0.0.1:2345 \
  --api-version=2 --accept-multiclient

# 방법 B: 이미 빌드된 바이너리에 attach
dlv attach <PID> \
  --headless --listen=127.0.0.1:2345 \
  --api-version=2 --accept-multiclient

# 방법 C: 빌드된 바이너리 실행 (최적화 비활성화 필수)
go build -gcflags="all=-N -l" -o myserver ./cmd/server
dlv exec ./myserver \
  --headless --listen=127.0.0.1:2345 \
  --api-version=2 --accept-multiclient

ssh -N -L 2345:127.0.0.1:2345 deploy@staging-go-server

{
  "version": "0.2.0",
  "configurations": [
    // ── Java Remote Attach ──
    {
      "type": "java",
      "name": "Java Remote (5005)",
      "request": "attach",
      "hostName": "localhost",
      "port": 5005,
      "projectName": "myservice"
    },

    // ── Node.js Remote Attach ──
    {
      "type": "node",
      "name": "Node Remote (9229)",
      "request": "attach",
      "port": 9229,
      "address": "localhost",
      "localRoot": "${workspaceFolder}",
      "remoteRoot": "/app",
      "sourceMaps": true,
      "skipFiles": ["<node_internals>/**"]
    },

    // ── Python Remote Attach (debugpy) ──
    {
      "type": "debugpy",
      "name": "Python Remote (5678)",
      "request": "attach",
      "connect": {
        "host": "localhost",
        "port": 5678
      },
      "pathMappings": [
        {
          "localRoot": "${workspaceFolder}",
          "remoteRoot": "/app"
        }
      ],
      "justMyCode": false
    },

    // ── Go Remote Attach (Delve) ──
    {
      "type": "go",
      "name": "Go Remote (2345)",
      "request": "attach",
      "mode": "remote",
      "port": 2345,
      "host": "localhost",
      "substitutePath": [
        {
          "from": "${workspaceFolder}",
          "to": "/app"
        }
      ]
    }
  ]
}

# IntelliJ가 자동 생성해 주는 JVM 인자 (복사해서 서버에 적용)
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005

# 원격 서버의 코드에 추가
import debugpy
debugpy.listen(("0.0.0.0", 5678))  # SSH 터널 사용 시 0.0.0.0도 가능
debugpy.wait_for_client()

# Pod 이름으로 직접
kubectl port-forward pod/myservice-abc123-xyz 5005:5005 -n staging

# Deployment를 통해 (임의 Pod 선택)
kubectl port-forward deployment/myservice 5005:5005 -n staging

# Service를 통해
kubectl port-forward svc/myservice 5005:5005 -n staging

# deployment-debug.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myservice-debug
  namespace: staging
spec:
  replicas: 1 # 디버그용은 반드시 1개
  selector:
    matchLabels:
      app: myservice-debug
  template:
    metadata:
      labels:
        app: myservice-debug
    spec:
      containers:
        - name: myservice
          image: myregistry/myservice:debug-20260307
          ports:
            - containerPort: 8080
              name: http
            - containerPort: 5005
              name: jdwp
          env:
            - name: JAVA_TOOL_OPTIONS
              value: >-
                -agentlib:jdwp=transport=dt_socket,server=y,
                address=127.0.0.1:5005,suspend=n
          resources:
            requests:
              memory: '512Mi'
              cpu: '500m'
            limits:
              memory: '1Gi'
              cpu: '1000m'

kubectl apply -f deployment-debug.yaml
kubectl port-forward deployment/myservice-debug 5005:5005 -n staging

apiVersion: v1
kind: Pod
metadata:
  name: myservice-debug-sidecar
spec:
  shareProcessNamespace: true # PID 네임스페이스 공유
  containers:
    - name: myservice
      image: myregistry/myservice:latest
      ports:
        - containerPort: 8080
    - name: debugger
      image: golang:1.22
      command: ['sleep', 'infinity']
      securityContext:
        capabilities:
          add: ['SYS_PTRACE'] # ptrace 권한 필요

# 사이드카 컨테이너에 진입하여 Delve로 attach
kubectl exec -it myservice-debug-sidecar -c debugger -- bash
# 컨테이너 안에서:
go install github.com/go-delve/delve/cmd/dlv@latest
dlv attach <PID> --headless --listen=:2345 --api-version=2

# 설치
brew install datawire/blackbird/telepresence

# 클러스터 연결
telepresence connect

# 특정 워크로드 가로채기 (트래픽을 로컬로 리다이렉트)
telepresence intercept myservice --port 8080:8080 --env-file .env.telepresence

# 로컬에서 디버그 모드로 실행
JAVA_TOOL_OPTIONS="-agentlib:jdwp=transport=dt_socket,server=y,address=127.0.0.1:5005,suspend=n" \
  java -jar myservice.jar

kubectl debug -it pod/myservice-abc123 \
  --image=busybox \
  --target=myservice \
  --share-processes \
  -n staging

# 성능 영향 체감 수준
에이전트 로드만 (연결 없음)  : ~1-3% 오버헤드
브레이크포인트 1-2개 (히트 빈도 낮음) : ~5% 오버헤드
브레이크포인트 다수 + 조건부 : ~10-30% 오버헤드 (가변)
Evaluate Expression 빈번 실행   : 순간적으로 응답 지연 수 초

# 1. IDE에서 디버거 연결 해제 (Disconnect)

# 2. SSH 터널 종료
# 터미널에서 실행 중이면 Ctrl+C
# 백그라운드면:
lsof -i :5005 | grep ssh
kill <PID>

# 3. 디버그 JVM 옵션 제거 후 프로세스 재시작
# Kubernetes의 경우:
kubectl rollout restart deployment/myservice -n staging
# 또는 디버그 전용 Deployment 삭제:
kubectl delete -f deployment-debug.yaml

# 4. 디버그용 코드 제거 (debugpy.listen 등)
git diff  # 실수로 커밋하지 않았는지 확인

# 5. port-forward 프로세스 종료 확인
lsof -i :5005
lsof -i :5678
lsof -i :9229
lsof -i :2345

# SSH 유휴 타임아웃 방지
ssh -o ServerAliveInterval=60 -o ServerAliveCountMax=3 \
  -N -L 5005:127.0.0.1:5005 deploy@staging-server

# 연결 상태 확인
ss -tlnp | grep 5005
# 또는
netstat -tlnp | grep 5005