인스턴스의 볼륨은 서버의 데이터 파티션에 만들어지고, 고객마다 용량 제한을 겁니다. 이 제한에는 XFS 파일시스템의 프로젝트 쿼터(pquota)가 필요하며, 파티션을 만들 때만 정할 수 있어 설치 전에 준비해야 합니다.
1. 무엇을 준비하나
확인 범위
이 절차는 Ubuntu 24.04 판정 환경(GPU 없음)에서 확인했습니다. 실제 GPU 서버에서의 확인은 진행 중입니다.
/data/volumes에 마운트한 데이터 파티션 —/data/volumes가 없으면 스크립트는/를 검사합니다.- 파일시스템 XFS · 마운트 옵션
pquota(또는prjquota) - 크기 — GPU당 128GB (권장 1TB). 고객에게 제공하는 용량은 데이터 파티션에서 200GB를 뺀 크기입니다.
- 템플릿 이미지 — 등록(활성화) 직후 서버가 공식 템플릿 이미지를 자동으로 받습니다. 디스크 약 70GB(공유 레이어 덕에 실사용은 더 작습니다)와 회선(데이터센터 27분 · 가정 회선은 더 걸립니다)을 씁니다. 공급자가 할 일은 없습니다.
쿼터가 없으면 한 고객이 디스크를 가득 채웠을 때 그 서버 전체가 새 대여를 받을 수 없습니다. 그래서 쿼터가 없는 서버는 등록이 보류됩니다. 보류는 영구 거부가 아니라, 재구성한 뒤 다시 등록하면 풀립니다.
2. 지금 상태 확인하기
데이터 디스크와 마운트 옵션은 아래 명령으로 볼 수 있습니다.
lsblk -f
grep /data/volumes /proc/mounts둘째 명령의 출력에 xfs와 prjquota가 함께 보이면 준비된 것입니다. 설치 스크립트의 6 단계도 같은 기준으로 판정하고 결과는 셋입니다.
- 쿼터 켜짐 — 통과합니다.
- 쿼터 없음 — 재구성 방법을 출력하고 등록 전에 멈춥니다(종료 코드
8). 등록 토큰은 쓰이지 않습니다. - 판정 불가 — 경고를 출력하고 계속합니다(서버가 등록 때 다시 판정).
이대로 등록하면 서버가 보류합니다. 재구성 뒤 같은 명령으로 다시 실행하세요.
보류를 감수하고 지금 등록하려면 명령 끝에 --accept-hold 를 붙이세요.이미 등록된 서버를 토큰 없이 다시 실행(업데이트)할 때는 쿼터가 없어도 멈추지 않고 경고만 합니다.
3. 재구성하기
데이터가 모두 지워집니다
포맷은 해당 장치의 데이터를 모두 지웁니다. 반드시 백업한 뒤 장치 이름을 확인하세요. 설치 스크립트는 포맷 · 파티션 · 마운트를 실행하지 않고 명령을 출력만 합니다.
스크립트가 출력하는 재구성 명령은 아래와 같습니다. <데이터 디스크>는 lsblk -f로 확인한 실제 장치 이름으로 바꿉니다. 스크립트도 이 명령을 예시로 출력할 뿐이니, 서버의 디스크 구성에 맞는지 확인한 뒤 실행하세요.
lsblk -f
sudo mkfs.xfs -f /dev/<데이터 디스크>
sudo mkdir -p /data/volumes
echo '/dev/<데이터 디스크> /data/volumes xfs defaults,pquota 0 0' | sudo tee -a /etc/fstab
sudo mount /data/volumes && grep /data/volumes /proc/mounts아직 실제 GPU 서버에서 확인하지 않았습니다. 위 재구성 명령은 스크립트가 출력하는 글자 그대로이며, 판정 환경에서는 실행해 보지 않았습니다.
마지막 명령의 출력에 prjquota가 보이면 끝입니다. 이미 보류로 등록된 서버라면 콘솔에 아래 안내가 보입니다.
디스크 재구성 필요
데이터 파티션을 XFS 로 포맷하고 pquota 옵션으로 마운트한 뒤, 등록 토큰을 재발급받아 설치 스크립트를 다시 실행해 주세요. 파티션을 다시 만드는 작업이라 기존 데이터가 삭제됩니다 — 진행 전에 반드시 백업하세요.
- 등록 전에 멈췄던 경우(종료 코드
8) — 토큰이 살아 있으니 같은 명령을 그대로 다시 실행합니다(24시간이 지났으면 재발급). - 보류로 등록된 경우 — 콘솔에서 등록 토큰을 재발급받아 새 명령으로 실행합니다.
4. Docker 저장 위치 — 스크립트가 함께 확인합니다
설치 스크립트는 볼륨 위치와 함께 Docker가 이미지와 컨테이너를 저장하는 위치(기본 /var/lib/docker)도 확인합니다. 두 위치가 서로 다른 파일시스템이면 둘 다 판정합니다. 인스턴스 디스크 제한은 Docker 저장 위치의 파일시스템에서 걸립니다. 미리 보려면 아래 명령으로 직접 확인할 수 있습니다.
docker info --format '{{.DockerRootDir}}'
df -hT "$(docker info --format '{{.DockerRootDir}}')"두 위치가 다른 파일시스템이고 판정이 기준에 못 미치면, 스크립트가 Docker 저장 위치를 볼륨과 같은 파일시스템으로 옮기는 방법을 화면에 출력합니다. 스크립트가 직접 옮기지는 않습니다.
5. 재구성 없이 먼저 등록하기 — --accept-hold
당장 재구성할 수 없다면 명령 끝에 --accept-hold를 붙여 실행할 수 있습니다. 쿼터 없이 등록하고, 서버는 등록을 보류(pending_review)로 둡니다.
재구성 전에는 신규 인스턴스가 배치되지 않습니다. 재구성 뒤 토큰을 재발급받아 다시 실행해야 합니다.
curl -fsSL <공개 사이트 주소>/install.sh | sudo bash -s -- --token=wwe_… --accept-hold