AWS·GCP 인프라 지옥 탈출기


[메인 프로젝트 2편]

RAG 시스템에 들어갈 524건의 판례 데이터를 전수 정제하고 벡터 DB 구축을 마친 후, 저에게 주어진 다음 미션은 '인프라 아키텍처 설계 및 서비스 배포'였습니다. 아무리 훌륭한 AI 모델을 만들었어도 사용자가 인터넷 주소(URL)를 치고 들어와 쓸 수 없다면 그것은 서비스가 아닌 '연구실의 코드'일 뿐이기 때문입니다.

하지만 로컬 컴퓨터를 떠나 클라우드 가상 서버(Cloud Server)의 세계로 들어간 순간, 예상치 못한 거대한 인프라의 파도가 몰아쳤습니다. 밤낮없이 서버와 사투를 벌이며 끝내 서비스를 무중단으로 띄워낸 눈물겨운 트러블슈팅 기록을 공개합니다.

☁️ 1. 복잡한 클라우드 권한 전쟁: GCP IAM 및 결제 권한 장애

저희 서비스의 핵심 두뇌는 LLM API(오픈에이전트 및 클라우드 모델)를 호출하는 것이었습니다. 개발이 한창 진행되던 중, 갑자기 모든 분석 기능이 멈춰 서는 비상사태가 발생했습니다.

  • 문제점 (할당량 초과 및 권한 꼬임): 무료 제공 API의 할당량(Quota)이 초과되면서 발생한 문제였습니다. 즉시 유료 티어로 전환해 결제 계정을 연결하려 했으나, GCP(Google Cloud Platform) 특유의 복잡한 IAM(식별 및 액세스 관리) 권한 체계가 발목을 잡았습니다. 결제 계정과 프로젝트 간의 매핑 권한이 완전히 꼬여버린 것입니다.

  • 해결 전략 (인프라 우회 및 재매핑): 마냥 권한 승인을 기다리며 시간을 지체할 수 없었습니다. 기존 프로젝트의 꼬인 실타래를 푸는 대신, 과감하게 신규 프로젝트를 생성하고 해당 인프라에 결제 계정을 강제로 직접 매핑하는 우회 아키처를 수립했습니다. 결제 권한 설정을 최적화하여 크레딧을 확보함과 동시에 중단되었던 AI 분석 기능을 정상화했습니다.

🧠 아키텍트로서 얻은 인사이트 "클라우드 서비스 운영 시, '권한(IAM)' 관리는 단순한 보안 설정을 넘어 개발 스펙 그 자체만큼 중요하다는 것을 뼈저리게 실감했습니다."

🌋 2. 발표 직전의 악몽: React 빌드 실패와 메모리 부족(OOM)

가장 피를 말렸던 순간은 최종 프로젝트 발표를 불과 얼마 앞두지 않은 시점이었습니다. 서버 환경에 프론트엔드(React)를 올리는 과정에서 치명적인 장애가 연달아 터졌습니다.

  • 현상 1 (Node.js 버전 충돌): 서버 환경의 Node.js 버전 이슈로 인해 React 프로젝트의 최종 빌드(Build)가 계속해서 실패했습니다.

  • 현상 2 (OOM, Out Of Memory): 설상가상으로 가상 서버의 제한된 메모리 리소스로 인해 빌드 도중 프로세스가 강제로 종료되는 메모리 부족(OOM) 현상까지 겹쳤습니다. 한마디로 서버가 뻗어버린 것입니다.

🚨 위기 관리 전략: '로컬 시연'과 '사후 완벽 배포'의 분리

당장 몇 분 뒤가 발표인 상황에서 인프라를 전면 수정하는 것은 자살행위였습니다. 저는 리스크를 최소화하기 위해 "발표 시에는 로컬 환경 시연으로 안정성을 확보하고, 배포는 발표 직후 완수한다"는 냉정한 위기 관리 판단을 내렸습니다.

발표를 성공적으로 마친 직후, 저는 곧바로 서버 가상환경을 전면 재구성하고 꼬여있던 포트 충돌을 해소했습니다. 이어서 백엔드(FastAPI)와 프론트엔드(React)를 다시 빌드하여 마침내 클라우드 인프라 배포를 완수해 냈습니다.

💻 당시 포트 충돌 해소 명령어 (Bash)

# 당시 꼬여있던 서버 포트를 강제 해제하고 환경을 재구성했던 명령어


fuser -k 80/tcp


fuser -k 8000/tcp

(※ 위 fuser 명령어를 통해 80포트와 8000포트의 프로세스를 강제 종료하고 인프라를 정상화했습니다.)

🔄 3. 인프라 안정화: AWS EC2 기반 무중단 배포 시스템 구축

최종 배포 성공에 그치지 않고, 사용자가 24시간 언제든 접속할 수 있는 서비스 안정성을 확보해야 했습니다. 가상 서버 터미널을 닫아도 서비스가 꺼지지 않도록 백그라운드 실행 기법을 정교하게 적용했습니다.

💻 백그라운드 무중단 실행 및 세션 관리 명령어 (Bash)

# 백엔드 및 프론트엔드 프로세스의 무중단 백그라운드 실행 세션 관리


nohup uvicorn main:app --host 0.0.0.0 --port 8000 &


disown

그 결과, 현재까지도 아무런 리스크 없이 외부에서 접속 가능한 AWS EC2 기반의 무중단 인프라 시스템을 안정적으로 유지하고 있습니다.

넥스트 예고: 기술적 완벽주의 vs 일정 중심의 실용주의 ⚖️

모든 인프라가 마침내 정상 궤도에 올랐을 때, 문득 뒤를 돌아보니 프로젝트 과정에서 팀원들과 치열하게 부딪혔던 소통의 흔적들이 보였습니다. "왜 더 빨리 배포하지 않느냐"는 의견과 "시스템 체력을 먼저 키워야 안정적인 배포가 가능하다"는 저의 신념 사이의 온도 차.

단순한 기술 구현을 넘어, 팀의 리스크를 관리하고 동료의 관점을 이해하는 'AI PM'으로 성장하게 된 마지막 이야기는 [3편: 협업 및 최종 소회 편]에서 이어집니다. 마지막까지 함께해 주세요!

📚 [정주행 추천] 커널로그 & 메인 프로젝트 전편 보기

비전공자 만학도가 AI 리터러시를 깨우고, RAG 기반 프롭테크 서비스를 실제 론칭하기까지의 위대한 여정입니다. 궁금한 회차를 클릭하시면 해당 칼럼으로 바로 이동합니다.

[1부: 패러다임의 시프트 (챌린지 편)]

[2부: 실전 레이스 (메인 프로젝트 편)]

댓글

댓글 쓰기

이 블로그의 인기 게시물

초등 한자 공부, 다산 정약용의 《아학편》으로 시작하는 어린이 문해력 가이드 (1. 天地父母)

이미지
대자연의 장엄한 고마움과 생명 탄생의 따뜻한 경이로움 - 초등 한자 공부와 아이의 문해력 해답 안녕하세요, 우리 아이들의 초등 한자 학습을 통해 바른 문해력 성장을 돕는 디지털 아학편 가이드입니다. 지루하게 자형의 뜻도 모른 채 암기하던 기존의 교과에서 벗어나, 다산 정약용 선생님의 정교한 눈높이 실학 설계를 통해 우주의 근본인 하늘과 땅, 그리고 그 품속에서 나를 가장 먼저 보살피는 부모님의 가치인 **천지부모(天地父母)**를 깊이 사유해 봅니다. 어린이 문해력의 기초를 다지는 초등 한자 공부, 다산 정약용의 《아학편》에서 그 해답을 찾아볼까요? 기획자 관점의 의미와 가치: 천지부모(天地父母)는 단순히 자연과 부모 자식의 호칭을 넘어, 나라는 존재를 받쳐주는 거대한 자연 순리의 품과 내 영혼의 뿌리인 부모님의 무조건적인 사랑을 자각하게 돕는 '인성 배움의 주춧돌이자 첫 단추' 입니다. 스스로를 귀히 여기고 주변에 감사할 줄 아는 바른 예절을 다져가길 기대합니다. 아학편 교육론 스토리텔링: 다산 정약용 선생은 누추한 유배지에서도 어린이 학동들이 눈앞의 실재하는 감각 사물과 자연의 짝을 조화롭게 느끼는 것이 올바른 인지 발달의 축복이라고 보셨습니다. 하늘과 땅(天地)이라는 거대한 우주의 틀을 인지한 뒤 바로 곁에서 나를 지탱하는 가장 구체적인 사랑의 대리인인 부모(父母)를 잇달아 공부하게 함으로써, 우주의 운행과 나의 탄생이 하나의 따뜻한 순리임을 자연스럽게 깨우쳐 주셨습니다. 오늘의 4자 탐험: 天地父母 (천지부모) 👀 섹션 1: 한자 조립소 글자가 만들어진 핵심적인 육서(六書)의 원리를 눈으로 보며 天地父母의 깊이 있는 한자 자형 구조를 쉽게 정주행해 보세요. 天 地 父 母 아래 버튼을 클릭하면 한자의 신비로운 조립...
Read more »

[디지털 아학편 상권] 초등 한자 문해력 교육 로드맵 (총 250단계)

이미지
실용성과 과학적 배치를 결합한 초학 교과서 초등 한자 공부, 다산 정약용의 《아학편》으로 시작하는 어린이 문해력 가이드 [디지털 아학편 상권] 로드맵 (1~250단계) 아이의 눈높이에 맞춰 직관적으로 관찰할 수 있는 세상의 실물부터 시작합니다. 기존의 『천자문』은 첫머리부터 '천지현황(天地玄黃, 하늘은 검고 땅은 누르다)'과 같은 아동이 이해하기 어려운 추상적인 우주관과 관념으로 시작하여 학습 의욕을 상실하게 만들었습니다. 다산 정약용 선생은 이러한 한계를 날카롭게 비판하며, 아동의 인지 발달 단계를 깊이 고려한 '유형자(유형의 사물) 1,000자' 를 상권에 배치하셨습니다. 우주와 자연의 구체적 형상, 인간관계의 실체, 내 몸의 신체 부위 등 직접 만지고 관찰할 수 있는 사물을 과학적으로 유목화하여 아이가 억지로 외우지 않고 세상을 논리적으로 이해하도록 이끕니다. 💡 삼재(三才)의 혁신: 하늘(天)보다 사람(人)이 먼저입니다 다산의 인본주의적 실학 교육관은 배열 순서에서도 빛을 발합니다. 전통적인 천(天)·지(地)·인(人) 순서를 탈피하여, 아동의 삶에서 가장 가깝고 소중한 존재인 '인간과 관계(天地父母, 군신부부 등)' 를 로드맵의 가장 첫머리에 배치하셨습니다. 나를 둘러싼 따뜻한 관계의 본질을 먼저 배운 뒤 자연과 세계, 도구로 시야를 점진적으로 넓혀가는 실사구시적 교수법을 온몸으로 체험해 보세요. 🧭 디지털 아학편 상권 문해력 로드맵 회차를 클릭하시면 개별 한자의 상세 '한자 조립소' 및 '브릿지 학습' 페이지로 바로 이동합니다. I. 인간과 관계 (1-40회) 1. 天地父母 ...
Read more »

초등 한자 공부, 다산 정약용의 《아학편》으로 시작하는 어린이 문해력 가이드 (2. 君臣夫婦)

이미지
사회와 가정을 든든하게 받치고 지탱하는 인륜의 두 기둥 - 초등 한자 공부와 아이의 문해력 해답 안녕하세요, 우리 아이들의 초등 한자 학습을 통해 바른 문해력 성장을 돕는 디지털 아학편 가이드입니다. 지난 1회차 《天地父母》를 통해 온 우주의 드높은 대자연과 자식에 대한 무조건적인 가없는 양육 사랑을 배웠다면, 이번 2회차에서는 사회 공동체와 집안을 든든하게 받쳐 조율해 올리는 인륜의 위대한 대들보인 **군신부부(君臣夫婦)**를 배웁니다. 어린이 문해력의 기초를 다지는 초등 한자 공부, 다산 정약용의 《아학편》에서 그 해답을 찾아볼까요? 기획자 관점의 의미와 가치: 군신부부(君臣夫婦)는 단지 강제적이거나 불평등한 옛 시대의 억압 관계가 아닌, 서로 소중한 직분을 인정하고 엄숙한 약속과 예의를 다해 공경을 전하는 '인격 간의 조화로운 수양 뼈대' 입니다. 아이들이 자신이 선 자리에서 의리를 지키고 온정 어린 태도로 타인을 공경하는 자라남을 함양하길 고대합니다. 아학편 교육론 스토리텔링: 다산 정약용 선생은 아동들이 성현들의 도덕 이치를 억지로 탐하기보다, 실생활 속에서 이웃과 가족을 올바르게 대접하는 직접적인 태도를 눈으로 익혀 나가는 것이 실사구시 교육론의 주춧돌이라고 생각하셨습니다. 임금과 신하(君臣), 남편과 아내(夫婦)가 일터와 문중 안에서 아름다운 약속을 소박하게 실행하는 풍경이야말로 도덕적 성장이 숨 쉬는 영혼의 정직한 교실임을 일깨워 주셨습니다. 오늘의 4자 탐험: 君臣夫婦 (군신부부) 👀 섹션 1: 한자 조립소 글자가 만들어진 핵심적인 육서(六書)의 원리를 눈으로 보며 君臣夫婦의 깊이 있는 한자 자형 구조를 쉽게 정주행해 보세요. 君 臣 夫 婦 아래 버튼을 클릭하면 한자의 신비로운 조립 이치가 나타납니다!...
Read more »