운영 요령
DS918+ Docker에서 cpus와 pids_limit을 검사한 결과
DS918+ DSM 7.3에서 cpus는 컨테이너 생성을 막고 pids_limit은 조용히 비적용된 이유를 cgroup과 inspect 출력으로 확인했습니다.
LibreOffice로 Office·HWP 문서를 변환하는 컨테이너에 자원 제한을 넣는 과정에서 두 가지 반대되는 동작을 만났습니다. CPU 상한을 뜻하는 cpus를 넣으면 컨테이너가 아예 만들어지지 않았습니다. 반면 pids_limit은 설정 파일에 적어도 오류 없이 생성됐습니다. 생성 성공만 보고 두 설정이 모두 반영됐다고 판단하면 안 되는 상황이었습니다.
이 서비스는 한 번에 하나의 변환만 처리하고, Office 작업은 180초, HWP 작업은 300초의 시간 한도를 둡니다. 문서 변환은 짧은 작업처럼 보여도 LibreOffice와 임시 파일이 함께 움직이므로, Compose 파일의 선언과 NAS 커널이 실제로 제공하는 제한 기능을 분리해 확인했습니다.
CPU 상한 오류는 cgroup v1의 CFS 지원 경고에서 시작됐습니다
먼저 NAS의 Docker가 어떤 cgroup 환경에서 돌아가는지 확인했습니다. 커널은 Linux 4.4.302+였고 Docker는 cgroupfs 드라이버와 cgroup v1을 사용하고 있었습니다. CPU 코어 수는 4개였지만, 코어 수와 CPU 대역폭 제한 가능 여부는 별개의 조건이었습니다.
$ docker info 2>&1 | grep -iE 'warning|cgroup'
Cgroup Driver: cgroupfs
Cgroup Version: 1
WARNING: No kernel memory TCP limit support
WARNING: No cpu cfs quota support
WARNING: No cpu cfs period support
WARNING: No blkio throttle.read_bps_device support
WARNING: No blkio throttle.write_bps_device support
WARNING: No blkio throttle.read_iops_device support
WARNING: No blkio throttle.write_iops_device support
출력에는 CPU CFS quota와 CFS period를 지원하지 않는다는 경고가 함께 나왔습니다. 이 환경에서 cpus를 설정하면 Docker는 NanoCPUs can not be set 오류를 내고 생성 단계에서 멈췄습니다. Compose 문법이 틀린 문제가 아니라, 해당 상한을 구현할 커널 기능이 없는 경우였습니다.
CPU를 절대량으로 막는 방식은 포기하고 cpu_shares를 선택했습니다. 이 값은 CPU 사용량의 상한이 아닙니다. 다른 컨테이너와 CPU를 두고 경쟁할 때만 반영되는 상대 가중치이므로, 처리 시간이 항상 일정하게 제한되는 설정으로 해석하지 않았습니다.
pids 컨트롤러가 없는지 먼저 확인해 PID 제한의 전제를 분리했습니다
pids_limit은 CPU 상한과 달리 컨테이너 생성 오류를 내지 않았습니다. 그래서 생성 성공 여부 대신 cgroup 컨트롤러 목록과 생성된 컨테이너의 HostConfig를 차례로 봤습니다. 이 순서를 거치지 않으면 설정 파일의 숫자만 보고 PID 제한이 작동한다고 오해하기 쉽습니다.
$ ls /sys/fs/cgroup/
blkio cpu cpuacct cpuset devices freezer memory synomonitor systemd
목록에는 CPU, 메모리, 디바이스 관련 컨트롤러가 있었지만 pids는 없었습니다. PID 수를 제한할 컨트롤러가 없는 상태에서 Compose의 pids_limit은 선언으로만 남을 수 있습니다. 이 항목은 실패 메시지 없이 넘어갈 수 있으므로, CPU 상한 오류보다 발견이 늦어질 수 있었습니다.
반대로 메모리와 CPU 상대 가중치는 컨테이너 설정에 들어갔는지 inspect 출력으로 확인할 수 있었습니다. Compose의 자원 항목을 한 덩어리로 취급하지 않고, 항목마다 커널 지원 여부와 Docker 반영 결과를 나누어 봐야 했습니다.
Compose 값과 inspect 값을 한 표에서 대조했습니다
생성 뒤에는 Compose 파일이 아니라 Docker가 보관한 HostConfig를 기준으로 적용 여부를 판정했습니다. 메모리와 CPU 상대 가중치는 값이 남아 있었지만 PID 상한은 비어 있었습니다. 설정을 읽은 Docker가 모든 값을 같은 방식으로 처리하지 않았다는 점이 이 비교에서 드러났습니다.
$ docker inspect bakkwo-converter-1 --format 'mem={{.HostConfig.Memory}} shares={{.HostConfig.CpuShares}} pids={{.HostConfig.PidsLimit}}'
mem=4294967296 shares=512 pids=<no value>
| 확인 항목 | 설정 또는 시스템 조건 | 확인 결과 | 판정 |
|---|---|---|---|
| 메모리 제한 | mem_limit: 4g | Memory=4294967296 | 적용 |
| CPU 상대 가중치 | cpu_shares: 512 | CpuShares=512 | 적용 |
| PID 상한 | pids_limit: 256 | PidsLimit=<no value> | 미적용 |
| CPU CFS 기능 | cpus 상한 필요 | quota·period 지원 경고 | 사용 불가 |
| PID cgroup | PID 제한 필요 | pids 컨트롤러 없음 | 미적용 조건 |
메모리 한도에는 /work tmpfs와 LibreOffice가 쓰는 메모리가 함께 포함됩니다. 임시 작업 공간은 /work와 /tmp tmpfs로 제한했고, 변환 프로세스는 고정 UID/GID로 실행했습니다. 읽기 전용 루트 파일 시스템, capability 제거, no-new-privileges와 게시 포트 미사용도 같은 실행 조건에 포함했습니다.
LibreOffice 고아 프로세스를 거두기 위해 tini를 PID 1으로 고정했습니다
PID 상한이 이 NAS에서 실제로 적용되지 않았더라도, 변환 프로세스 정리는 별도로 다뤘습니다. converter가 PID 1이면 시간 초과·취소·정리 중 LibreOffice 프로세스 그룹을 끝낸 뒤 남는 soffice.bin을 회수하지 못할 수 있습니다. 고아 프로세스는 PID 1에 붙지만 converter는 자기 자식만 기다리기 때문입니다.
그래서 이미지는 converter가 직접 PID 1이 되는 구조 대신 tini를 포함하도록 만들었습니다. PID 제한이 가능한 환경에서는 좀비가 누적돼 새 LibreOffice 프로세스를 띄우지 못하고 변환이 계속 실패하는 상황을 막기 위한 선택입니다.
ENTRYPOINT ["/usr/bin/tini", "--", "/usr/local/bin/converter"]
실행 중인 프로세스도 확인했습니다. tini가 PID 1로 있고 converter가 그 자식으로 실행됐습니다. tini는 받은 신호를 자식에게 넘기므로 docker stop의 신호 전달 방식도 유지됩니다.
$ docker top bakkwo-converter-1 -o pid,stat,comm
PID STAT COMMAND
635 Ss tini
767 Sl converter
Compose의 init: true는 선택하지 않았습니다. 이 방식은 호스트 Docker의 docker-init 바이너리를 컨테이너에 넣는데, Synology Container Manager에서 그 바이너리의 존재를 확인하지 못했습니다. 이미지를 통해 tini를 포함하면 Compose, docker run, Container Manager 화면으로 실행할 때도 init 구성이 빠지지 않습니다.
이 NAS에서는 설정 파일보다 생성 뒤의 값이 최종 판정 기준입니다
이 사례에서 cpus는 지원되지 않아 즉시 실패했고, pids_limit은 지원되지 않아도 조용히 넘어갔습니다. 둘 다 자원 제한 설정이지만 발견 방법은 달랐습니다. 오류 메시지가 보이는 항목만 고치고 끝내면, 적용되지 않은 제한을 놓칠 수 있었습니다.
변환 컨테이너를 점검할 때는 먼저 docker info에서 cgroup 버전과 CPU CFS 관련 경고를 보고, 다음으로 /sys/fs/cgroup/에 필요한 컨트롤러가 있는지 확인합니다. 마지막에는 docker inspect로 메모리, CPU 상대 가중치, PID 상한의 실제 값을 비교하고 docker top으로 PID 1 구성을 확인하는 순서가 맞았습니다.
시간 제한이나 취소 뒤 변환 엔진이 10초 안에 돌아오지 않으면 그 엔진을 버리고 다음 작업을 실행하도록 했습니다. 동시 실행을 하나로 유지한 상태에서, 자원 제한의 실제 적용 여부와 프로세스 회수를 함께 확인한 구성이었습니다.