에이전트 런타임 서버 셋업
에이전트를 서버에서 상시 구동하면 그 나름대로의 문제가 따라온다. 서버에 달린 RAM은 양이 정해져 있다. 폭주한 프로그램 하나가 남김없이 먹어치우면 리눅스는 패닉에 빠져 프로세스를 거의 무작위로 죽이기 시작한다. 얘가 가끔 SSH 연결처럼 엉뚱한 걸 죽이면 서버 전체가 같이 내려간다. 그래서 욕심 많은 프로세스 하나가 전체를 무너뜨리기 전에 느려지는 선에서 그치도록 방어를 여러 겹 쌓아야 한다.
이 글은 에이전트 런타임 셋업을 다룬다. 에이전트 인터페이스나 추론 얘기가 아니다. 셋은 서로 다르다. Claude를 예로 들면, 에이전트 추론은 Anthropic 서버가 담당하고 에이전트 인터페이스는 휴대폰이어도 되지만, 에이전트 런타임은 Claude 로컬 바이너리(모델이 아니라 프로그램)가 접근할 수 있는 파일 시스템이어야 한다. 에이전트 런타임은 인터페이스 계층과는 분리될 수 있다. 종종 하나지만.
계층
1. 넘칠 때 받아줄 큰 공간 (swap)
RAM이 책상이라면 swap은 옆에 놓인 서류 캐비닛이다. 책상이 가득 차면 잘 안 쓰는 서류가 바닥에 내던져지는 대신 캐비닛으로 옮겨 간다.
서버 SSD에 128GB짜리 swap 파일을 만들어 두었다. RAM보다 느리지만 느린 쪽이 죽는 쪽보다 낫다. 셋업에 함정이 하나 숨어 있는데, 파일을 바이트 그대로 써 내려가는 dd로 만들어야 한다는 점이다. fallocate는 구멍 뚫린 파일을 만들고, 리눅스는 그런 파일을 swap으로 받아주지 않는다.
2. swap 앞단의 압축 버퍼 (zswap)
페이지가 느린 서류 캐비닛으로 가기 전에 리눅스가 먼저 zstd로 압축해 RAM 한구석에 쟁여 둔다. 옷을 상자에 넣기 전에 진공 압축팩으로 부피를 줄이는 셈이다. 스왑된 데이터는 대부분 디스크까지 내려가지도 않아서 속도가 유지된다.
사촌 격인 zram이 아니라 zswap을 고른 이유는 zswap의 사용량이 그걸 유발한 프로세스에 청구되기 때문이다. 이 성질이 4번 계층에서 중요해진다.
3. 정중한 문지기 (earlyoom)
커널의 OOM 킬러는 시스템이 이미 응답을 멈춘 마지막 순간에야 움직인다. earlyoom은 메모리를 지켜보다가 그보다 일찍 나서는 작은 데몬이다. RAM과 swap의 여유가 둘 다 5% 아래로 내려가면 가장 뚱뚱한 프로세스에게 정중하게 종료를 요청하고(SIGTERM), 2% 아래로 내려가면 강제로 끝장을 본다(SIGKILL). 반드시 살아남아야 하는 것들은 죽이지 않는 목록으로 보호한다. systemd, sshd, tailscaled, docker/containerd, 그리고 earlyoom 자신이다.
4. 무거운 줄 아는 작업에 채우는 구속복 (cgroup 상한)
메모리를 많이 먹을 게 뻔한 작업은 시작하기 전에 미리 감시한다.
이렇게 하면 명령이 메모리 제한이 걸린 상자 안에서 돈다. 8GB를 넘기면 커널은 그 상자만 죽이고, 서버의 나머지는 눈치도 못 챈다. 폭발 반경이 정확히 작업 하나뿐이라 얘가 제일 좋다.
5. 들어오는 길목의 경호원
SSH와 Tailscale 데몬에는 OOM 점수 -500을 부여한다. 커널에게 "정말 누군가를 죽여야겠다면 어지간하면 다른 프로세스부터 골라라"라고 말해 두는 셈이다. 덕분에 언제든 다시 들어가서 수습할 수 있다.
6. 튜닝 손잡이 몇 개 (sysctl)
압축 계층으로는 미리미리 스왑하고(swappiness=100), 메모리를 기다리느라 서버가 멈추는 일이 없게 백그라운드 정리를 더 일찍 시작하고(watermark_scale_factor=125), 비상 예비분은 더 크게 잡아 둔다(min_free_kbytes).