[혼자 만든 게임 출시기 2] AI 개발 세션 수십 개를 동시에 돌리면 생기는 일
1편에서 저희는 게임 저장소마다 AI 세션을 하나씩 둔다고 했습니다. 장기 세션은 장기만, 파루 세션은 파루만, 게임 포털 세션은 포털만 고칩니다. 지금 저희 PC에는 이런 세션이 마흔 개 넘게 걸려 있습니다.
사람 마흔 명이 한 사무실에서 일하면 생기는 문제가, AI 세션 마흔 개가 한 PC에서 일해도 똑같이 생깁니다. 회의실이 겹치고, 공용 프린터가 고장 나고, 남의 서류가 내 서류에 섞입니다. 이번 편은 실제로 겪은 다섯 가지 사고와, 그 뒤에 만든 규칙 이야기입니다.
왜 세션을 나누는가
하나의 AI 세션에 게임 마흔 개를 다 맡기면 대화가 금방 길어지고, 이 게임 이야기를 하다 저 게임 파일을 건드리는 실수가 생깁니다. 저장소마다 세션을 나누면 각 세션은 자기 게임의 코드와 기록만 깊게 압니다. 사람으로 치면 게임마다 전담 개발자가 한 명씩 있는 셈입니다.
대신 여러 게임이 함께 쓰는 것, 예를 들어 게임 포털 서버, 공용 로그인, 이 PC 한 대의 자원에서 부딪힙니다.
사고 1. 에뮬레이터 세 대가 같은 포트를 잡았다
안드로이드 앱을 시험하려면 에뮬레이터(PC 안의 가상 폰)를 띄웁니다. 어느 날 세 세션이 각자 앱을 시험하려고 에뮬레이터를 띄웠는데, 셋 다 **같은 포트 번호(5600)**를 썼습니다. 각 세션의 기본 설정을 그대로 썼기 때문입니다.
결과는 이랬습니다.
- 한 세션이 설치한 앱이 다른 세션의 가상 폰에 깔리거나,
- 에뮬레이터와 PC를 잇는 연결 프로그램(adb)이 다른 세션 때문에 자꾸 다시 시작되어, 시험 도중 연결이 끊겼습니다.
바꾼 것: 에뮬레이터를 띄울 때 세션마다 다른 포트를 쓰고, 연결이 끊기면 자기 포트로 다시 붙는 방법을 공유 노트에 적어 두었습니다. 사람 팀이 회의실 예약표를 쓰는 것과 같습니다.
사고 2. 공용 빌드 캐시가 깨졌다
안드로이드 앱을 만드는 도구(Gradle)는 한 번 받은 부품을 PC 한곳에 모아 두고 같이 씁니다. 여러 세션이 동시에 빌드를 돌리자 이 공용 보관함이 깨졌고, 그 뒤로는 전혀 상관없는 게임의 빌드까지 줄줄이 실패했습니다.
바꾼 것: 세션마다 Gradle 보관함을 따로 쓰게 했습니다(GRADLE_USER_HOME을 게임별 폴더로). 디스크는 조금 더 쓰지만, 한 세션의 문제가 다른 세션으로 번지지 않습니다. 이 방법은 지금 여러 게임 저장소의 README 첫머리에 적혀 있습니다.
사고 3. 다른 게임의 「추적 허용」 창이 우리 창을 막았다
아이폰 앱은 광고 추적을 하려면 「앱 추적 허용」(ATT) 창으로 물어봐야 합니다. 맥에서 공용 아이폰 시뮬레이터로 어썸동산을 시험하는데, 아무리 해도 이 창이 안 떴습니다.
원인은 다른 게임(파루)이었습니다. 같은 시뮬레이터에 파루의 ATT 창이 이미 떠 있었고, iOS는 그 상태에서 들어온 우리 앱의 요청을 조용히 넘겨 버렸습니다. 오류 메시지도 없었습니다. 깨끗한 시뮬레이터에서는 바로 떴습니다.
바꾼 것: 심사용 녹화처럼 중요한 확인은 새로 만든 깨끗한 시뮬레이터에서 합니다. 이 일은 나중에 App Store 반려 대응(7편에서 다룰 예정)과도 이어집니다.
사고 4. 남의 커밋과 섞여 게임 하나가 잠깐 열리지 않았다
가장 아찔했던 일입니다. 저희 게임은 모두 하나의 게임 포털 서버에 올라갑니다. 그래서 각 게임 세션은 자기 게임 파일을 포털 저장소에 넣고 배포합니다.
11월 1일, 「백귀 행차」 세션이 새 기능 파일을 포털에 올리고 있었습니다. 그런데 포털의 기본 작업 폴더에는 다른 세션이 아직 올리지 않은 작업이 남아 있었습니다. 백귀 세션은 이 상태에서 자기 코드를 먼저 서버 저장소에 올렸습니다. 그사이 또 다른 세션(장산범)이 배포를 하면서 백귀 코드까지 같이 배포했는데, 새로 추가된 파일 하나가 공개 허용 목록에 없어 빠졌습니다. 그래서 백귀 행차 페이지가 잠깐 열리지 않았습니다.
다행히 배포 전후 자동 점검 덕분에 바로 알아챘고, 허용 목록을 맞춘 뒤 다시 배포해 고쳤습니다.
바꾼 것(교훈):
- 새 공개 파일을 더할 때는 허용 목록부터 맞춘 다음에 올린다.
- **“남이 내 코드를 같이 배포할 수 있다”**고 생각하고 일한다. 반쯤 된 코드를 공용 저장소에 올려 두지 않는다.
- 세션은 자기가 바꾼 파일만 커밋하고, 다른 세션의 작업을 임시로 치우거나(stash), 되돌리거나(reset), 브랜치를 바꾸지 않는다.
마지막 규칙은 지금 모든 세션에 기본 규칙으로 들어가 있습니다.
사고 5(진행 중). 서버를 같이 쓰면 알려야 한다
어제(11월 20일) 이 블로그를 세팅하면서도 같은 문제를 만났습니다. 블로그를 띄우려고 회사 홈페이지 서버와 게임 포털 서버의 웹 서버 설정(nginx)에 한 줄씩 더해야 했는데, 두 서버는 각각 홈페이지 세션과 포털 세션이 관리합니다.
그래서 블로그 세션이 설정을 바꾼 직후, 두 세션에 메시지를 보냈습니다.
포털 서버의 games.conf에 블로그용 include 한 줄을 넣었습니다. 백업은 여기 있습니다. games.conf를 다시 만드는 배포가 있다면 이 줄을 지우지 말아 주세요.
사람 팀이라면 슬랙에 남길 한 줄입니다. 이 한 줄이 없으면, 며칠 뒤 포털 세션이 설정을 새로 만들면서 블로그를 모르고 지워 버릴 수 있습니다.
지금 쓰는 규칙 정리
석 달 동안 쌓인 규칙을 줄이면 이렇습니다.
- 한 세션은 한 저장소. 다른 저장소 파일은 읽기만 한다.
- 공용 자원은 나눠 쓴다. 에뮬레이터 포트, 빌드 캐시는 세션별로.
- 중요한 확인은 깨끗한 환경에서. 공용 시뮬레이터 상태를 믿지 않는다.
- 자기 파일만 커밋한다. 남의 작업을 치우거나 되돌리지 않는다.
- 공용 서버를 바꾸면 주인 세션에 바로 알린다. 무엇을, 어디에, 백업은 어디에.
- 큰 기록은 공유 노트 폴더에. 메시지에는 요약만 쓰고, 자세한 내용은 노트 파일로 남긴다.
규칙만 보면 사람 개발팀의 규칙과 거의 같습니다. AI 세션이라고 다를 게 없었습니다. 다른 점이 있다면, AI 세션은 규칙을 한 번 적어 두면 잊지 않고 지킨다는 것 정도입니다.
다음 편은 「웹게임 하나로 웹·안드로이드·아이폰 세 군데에 내기」입니다.
이 글에 나온 게임
- 백귀 행차: Google Play 심사 중이며, 웹에서 먼저 해 볼 수 있습니다 → https://games.awesomedevapp.com
- 장산범: App Store (Google Play는 심사 중)
- 어썸동산: Google Play · App Store
- 파루 — 조선의 밤을 버텨라: Google Play · App Store