인프라 상태를 안전한 운영 흐름으로 바꾼 게임 서버 제어판

대시보드는 GCP Console과 저장·종료 절차의 복잡성을 숨기고 지금 할 수 있는 동작과 기다려야 하는 상태만 보여주도록 설계했습니다.

배경과 과제

배경

최대 10여명 정도가 함께 플레이했고 각자 접속 가능한 시간은 달랐습니다. 고정된 운영 시간을 정하기 어려웠기 때문에, GCP Console이나 서버 운영 지식 없이도 필요할 때 서버를 켜고 접속 가능한 상태를 확인할 수 있어야 했습니다.

VM을 24시간 실행하면 사용하지 않는 시간에도 비용이 발생하고 매번 관리자가 GCP Console에서 실행하는 방식은 운영 부담과 권한 공유 문제를 남겼습니다.

핵심 과제

클라우드와 게임 서버의 복잡한 운영 절차를 개발 지식이 없는 사용자가 이해할 수 있는 몇 개의 안전한 동작으로 바꿔야 했습니다.

설계 시 고려한 점

  • 서버 시작, 사양 변경, 종료가 겹치면 중복 제어와 잘못된 순서의 중지가 데이터 손실이나 운영 오류로 이어질 수 있었습니다.
  • 단순 cron 종료는 실제 접속자와 서버 시작 직후의 보호 시간을 고려하지 못했습니다.

운영 제약

  • 서버가 켜졌다는 표시만으로는 게임에 접속할 수 없었기 때문에 준비가 끝날 때까지 저장·종료·공지 같은 동작을 활성화하지 않아야 했습니다.
  • 실행 중인 서버의 사양을 바꾸려면 재시작이 필요하므로, 접속자가 있으면 변경을 막고 사용자가 재시작 영향을 먼저 확인하게 해야 했습니다.
  • 자동 종료는 0명 상태를 확인하되, 방금 시작한 서버나 다시 접속한 사용자를 종료하지 않도록 보호 시간과 타이머 초기화가 필요했습니다.

운영 시스템과 상태를 화면에 투영한 방법

제어 UI, 서버 상태와 운영 경계를 연결한 구조

Dashboard는 Compute Engine의 VM 상태와 VM 내부 Palworld REST API의 응답을 연결하고 Firestore에는 제어 작업과 자동 종료 상태를 기록합니다.

제어 UI, 서버 상태와 운영 경계를 연결한 구조사용자와 Cloud Scheduler가 Cloud Run 대시보드에 요청하고 대시보드가 Compute Engine API, Firestore, private VPC를 통한 Palworld REST API와 연결되는 구조운영 주체제어 애플리케이션게임 서버HTTPS 제어 요청인증된 auto-stopVM 조회·시작·중지private VPC의REST API상태·잠금 기록lifecycle 제어사용자브라우저Cloud SchedulerCloud Run DashboardNext.js · APIFirestoreCompute Engine APIPalworld VMREST API
제어 UI, 서버 상태와 운영 경계를 연결한 구조사용자와 Cloud Scheduler가 Cloud Run 대시보드에 요청하고 대시보드가 Compute Engine API, Firestore, private VPC를 통한 Palworld REST API와 연결되는 구조운영 주체제어 애플리케이션게임 서버HTTPS 제어 요청인증된auto-stopVM조회·시작·중지private VPC의REST API상태·잠금 기록lifecycle 제어사용자브라우저Cloud SchedulerCloud RunDashboardNext.js · APIFirestoreComputeEngine APIPalworld VMREST API

VM lifecycle과 Palworld readiness를 분리한 상태 투영

하나의 boolean으로 서버 상태를 판단하지 않고 Compute VM 상태와 Palworld metrics 응답을 조합해 화면에 표시할 상태를 정했습니다.

판별 입력VM 상태 + Palworld REST metrics 응답VM이 RUNNING이어도 Palworld REST API가 응답하지 않으면 사용자는 아직 접속할 수 없습니다.
  1. PROVISIONING / STAGINGVM 시작 중
    STARTING_VMCompute VM이 실행 상태에 도달하기 전의 전환 상태
  2. RUNNINGmetrics unavailable
    BOOTING_SERVERVM은 켜졌지만 Palworld 서버가 아직 준비되지 않은 상태
  3. RUNNINGmetrics available
    ONLINEPalworld REST API가 응답해 접속 가능 상태로 표시
  4. STOPPING / SUSPENDINGVM 전환 중
    STOPPING종료 작업이 진행되는 동안 제어 가능 상태를 제한
  5. TERMINATED / SUSPENDEDREST 조회 없음
    OFFLINEVM이 실행 중이 아니므로 게임 서버도 접속 불가
  6. 그 외 상태판별 불가
    UNKNOWN정의된 조합으로 설명할 수 없는 상태를 숨기지 않고 표시

운영 흐름으로 만든 변화

사용자 흐름
사용자가 GCP Console이나 종료 순서를 직접 다루지 않고도 상태 기반 화면에서 서버를 시작하고 온라인이 된 뒤 접속할 수 있게 했습니다.
상태 표현
VM의 실행 여부와 Palworld의 readiness를 분리해 접속 가능 여부를 너무 이르게 표시하지 않도록 했습니다.
안전장치
profile 변경 전 접속자 확인, 제어 작업 잠금, 오류 메시지와 강제 중지 분리로 운영자가 다음 행동을 판단할 수 있게 했습니다.

핵심 구현과 판단

1. 하나의 profile 선택을 guarded control flow로 구성

실행 중인 VM의 사양을 바꾸는 일은 단순 설정 변경이 아니었습니다. 접속자를 먼저 확인하고 저장과 정상 종료를 요청한 뒤 VM이 완전히 TERMINATED 상태인지 확인한 후에만 machine type을 바꾸고 다시 시작했습니다.

  • 접속자가 있으면 profile 변경을 중간에서 차단해 플레이 중인 서버를 재시작하지 않습니다.
  • Compute operation timeout, zone capacity 부족, VM 중지 실패는 같은 실패로 뭉개지지 않도록 단계별 메시지로 변환했습니다.
  • 이 흐름은 transaction이나 atomic profile switch가 아닙니다. 접속자 확인 뒤 새 접속이 생길 수 있고 정상 종료도 설정된 대기 시간을 기준으로 진행됩니다.

2. VM lifecycle과 Palworld readiness를 UI 상태로 투영

VM RUNNING을 곧바로 접속 가능으로 표시하지 않았습니다. Dashboard는 전환 상태에서 더 자주 polling하고 Palworld metrics가 응답한 뒤에만 ONLINE과 접속자 목록, 저장·종료 같은 행동을 활성화했습니다.

  • actionInFlight와 loadingAction으로 같은 화면에서 action이 겹치지 않게 하고 network timeout과 fetch 실패는 사용자가 다시 시도할 수 있는 메시지로 정리했습니다.
  • 실행 중인 profile 변경은 confirmation modal을 거치고 아직 API가 준비되지 않은 경우에만 force stop을 위험 작업으로 분리했습니다.

3. 접속 상태를 기준으로 자동 종료

Cloud Scheduler는 단순히 시간이 되었다고 VM을 끄지 않습니다. VM과 Palworld metrics를 확인하고 접속자가 없어진 시점인 emptySince를 기록한 뒤 startup grace period와 idle threshold를 모두 통과해야 저장과 정상 종료, VM 중지를 요청합니다.

  • 접속자가 다시 생기면 emptySince를 초기화해 종료 타이머를 되돌립니다.
  • auto-stop도 수동 시작·종료·profile 변경과 같은 Firestore control lock을 사용해 서로 겹치는 제어를 줄입니다.
  • idle VM을 멈추는 정책을 구현했지만 확인되지 않은 비용 절감률이나 종료 완료 보장을 주장하지 않습니다.

신뢰성과 안전장치

정상 경로만 제공하지 않고 작업이 겹치거나 서버가 준비되지 않은 상황에서 어떤 행동을 막고 어떤 선택지를 남길지 구분했습니다.

여러 제어 요청이 동시에 들어오는 경우

처리
Firestore transaction에서 진행 중인 operation과 시작 시각을 확인하고 만료되지 않은 작업이 있으면 새 start, shutdown, profile, auto-stop 요청을 거절했습니다.
결과
같은 서버에 겹친 제어가 실행될 가능성을 줄이고 UI에서도 actionInFlight로 중복 클릭을 막았습니다.

사양 변경 중 저장·종료·Compute 작업이 실패하는 경우

처리
profileStep이 timeout, capacity exhaustion, VM stop과 machine type 변경 실패를 단계별 코드와 메시지로 변환하고 종료 실패에는 수동 확인 안내를 남겼습니다.
결과
운영자는 모호한 실패 대신 중단된 단계와 다음 확인 대상을 판단할 수 있습니다.

Palworld REST API가 준비되지 않았거나 응답하지 않는 경우

처리
상태는 BOOTING_SERVER 또는 UNKNOWN으로 표시하고 UI에서는 저장·정상 종료와 공지를 제한했습니다. 위험한 force stop은 별도 확인을 거치는 경로로 뒀습니다.
결과
VM이 켜진 직후를 접속 가능으로 오해하거나 저장 없이 VM을 중지하는 행동을 기본 경로로 만들지 않았습니다.
추가 예외 처리 1개

자동 종료가 종료 기준에 도달한 경우

처리
save와 shutdown 요청 뒤 설정된 대기 시간을 거쳐 VM stop을 요청하고 제어 상태에 마지막 종료 정보를 기록했습니다.
결과
접속자가 없어진 서버를 종료할 수 있지만 auto-stop 뒤 TERMINATED 재확인은 현재 보강할 경계로 남습니다.

아쉬웠던 점과 개선 방향

사양 변경 전에는 접속자가 없는지 확인합니다. 다만 확인 직후 새 사용자가 접속하는 순간까지 완전히 막지는 못합니다.

종료는 저장과 안내, 대기 뒤 VM 중지를 요청하는 흐름입니다. 자동 종료 후 VM이 실제로 완전히 꺼졌는지를 다시 확인하는 단계는 다음 보강 과제입니다.

동시에 여러 제어가 겹치지 않도록 Firestore lock을 사용합니다. 다만 재시도나 만료까지 포함해 어떤 요청이 정확히 한 번만 실행된다고 보장하는 장치는 아닙니다.

ASK ME기준 ·이 글 · 인프라 상태를 안전한 운영 흐름으로 바꾼 게임 서버 제어판

프로젝트, 담당 범위, 기술적 판단을 물어보세요.

추천 질문

포트폴리오에 작성된 내용으로만 답합니다