배포

npm install @teamlearners/clawops@latest

npm ls @teamlearners/clawops
# └── @teamlearners/clawops@0.43.0   ← 이 이상이어야 합니다

import { ClawOpsAgent } from '@teamlearners/clawops/agent';

const agent = new ClawOpsAgent({ from: '07012345678', session: mySession });

await agent.serve();

CMD ["node", "app.js"]     # ✅
CMD node app.js            # ⛔ PID 1 이 /bin/sh 가 됩니다
CMD ["npm", "start"]       # ⛔ PID 1 이 npm 이 됩니다

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
spec:
  replicas: 1 # 여러 개 두셔도 됩니다 — 6번
  strategy:
    type: RollingUpdate
    rollingUpdate:
      maxUnavailable: 0 # 옛 pod 를 먼저 내리지 않는다
      maxSurge: 1 # 새 pod 를 먼저 띄운다
  selector:
    matchLabels:
      app: my-agent
  template:
    metadata:
      labels:
        app: my-agent
    spec:
      # ⚠️ 기본값 30초를 그대로 두면 통화 중에 강제 종료됩니다.
      #    통화 길이보다 길게 잡으세요.
      terminationGracePeriodSeconds: 600
      containers:
        - name: agent
          image: my-registry/my-agent:v1
          command: ["node", "app.js"] # 3번 참고
          env:
            - name: CLAWOPS_API_KEY
              valueFrom:
                secretKeyRef:
                  name: clawops
                  key: api-key
          readinessProbe:
            exec:
              command: ["cat", "/tmp/clawops-ready"]
            periodSeconds: 2
            failureThreshold: 30

{
  "family": "my-agent",
  "containerDefinitions": [
    {
      "name": "agent",
      "image": "my-registry/my-agent:v1",
      "command": ["node", "app.js"],
      "stopTimeout": 120,
      "healthCheck": {
        "command": ["CMD-SHELL", "cat /tmp/clawops-ready || exit 1"],
        "interval": 5,
        "retries": 12,
        "startPeriod": 60
      }
    }
  ]
}

"deploymentConfiguration": {
  "minimumHealthyPercent": 100,
  "maximumPercent": 200
}

kubectl apply -f deployment.yaml
kubectl get pods -w

my-agent-aaa   1/1   Running       # 옛 pod — 계속 전화를 받는 중
my-agent-bbb   0/1   Running       # 새 pod — 아직 연결 전 (프로브가 막고 있음)
my-agent-bbb   1/1   Running       # 새 pod 연결됨
my-agent-aaa   1/1   Terminating   # 이제서야 옛 pod 가 내려간다

SIGTERM 수신 — 종료 절차 시작
인계 대기 — 자리를 유지한 채 후임을 기다린다 (최대 20s)
인계 완료 — 새 전화는 후임이 받는다
Drain 완료(6.2s): 3건 모두 정상 종료

kubectl get deploy my-agent -o jsonpath='{.spec.strategy.rollingUpdate}{"\n"}'
# {"maxSurge":1,"maxUnavailable":0}

kubectl get deploy my-agent -o jsonpath='{.spec.template.spec.terminationGracePeriodSeconds}{"\n"}'
# 600

kubectl get deploy my-agent -o jsonpath='{.spec.template.spec.containers[0].readinessProbe}{"\n"}'
# {"exec":{"command":["cat","/tmp/clawops-ready"]},...}   ← 비어 있으면 프로브가 없는 것입니다

spec:
  replicas: 3

// 블루 인스턴스에서 — 예: 관리용 엔드포인트가 호출
const { completed, forced } = await agent.drain(); // 상한 없음: 통화가 끝날 때까지

          volumeMounts:
            - name: tmp
              mountPath: /tmp
      volumes:
        - name: tmp
          emptyDir: {}

await agent.serve({ healthPort: 8080 });

          readinessProbe:
            httpGet:
              path: /healthz
              port: 8080
            periodSeconds: 2
            failureThreshold: 30

await agent.serve({ drainTimeoutMs: 100_000, shutdownDeadlineMs: 110_000 }); // ECS stopTimeout 120 일 때

const agent = new ClawOpsAgent({
  from: '07012345678',
  session: mySession,
  onTakenOver: (code, reason) => console.log('자리를 넘겼습니다:', reason),
});
await agent.connect();

// ... 종료할 때
const { completed, forced } = await agent.drain();