two-thirteen
프롬프트에서 공개 URL까지: AI Studio 앱을 Cloud Run에 올릴 때 볼 것
프롬프트에서 공개 URL까지: AI Studio 앱을 Cloud Run에 올릴 때 볼 것
2026-11-06 Serverless

프롬프트에서 공개 URL까지: AI Studio 앱을 Cloud Run에 올릴 때 볼 것

Google AI Studio의 Build 모드로 만든 앱을 Cloud Run에 배포하는 '바이브 배포' 흐름을 따라가며, API 키가 어디에 들어가는지와 공유하는 순간 생기는 비용 문제를 공식 문서 기준으로 정리합니다.

프롬프트 하나로 앱이 나오는 데모는 이제 익숙합니다. 덜 이야기되는 건 그다음, 그 앱을 남에게 보여 주는 순간입니다.

로컬 미리보기에서는 문제가 없던 앱도 URL을 공유하는 순간 성격이 바뀝니다. 누가 들어오는지, 그 사람의 요청을 누구 돈으로 처리하는지, 키는 어디에 있는지가 갑자기 중요해집니다.

Google AI Studio에서 Cloud Run까지 가는 길을 문서대로 따라가 보면서, 그 경계에서 확인할 것들을 모아 봤습니다.

'바이브 배포'라는 말

Google Cloud의 바이브 코딩 설명 페이지에는 '바이브 배포(vibe deploying)'라는 표현이 나옵니다. 클릭 한 번이나 프롬프트 하나로 앱을 Cloud Run 같은 운영 환경에 올리는 능력을 말합니다.

페이지는 이것이 'DevOps 병목'을 없애 아이디어를 실제 사용자에게 바로 시험해 볼 수 있게 한다고 설명합니다. 그리고 Cloud Run을 트래픽이 없으면 0까지 줄어드는 서버리스 플랫폼으로 소개합니다.

빠른 실험에 잘 맞는 조합입니다. 아무도 안 쓰는 동안에는 인스턴스가 떠 있지 않으니까요.

다섯 단계

Google Cloud의 사용 사례 페이지는 흐름을 다섯 단계로 나눕니다.

① 프롬프트앱을 설명 ② 생성파일·미리보기 ③ 다듬기후속 프롬프트 ④ 피드백전체 화면 공유 ⑤ Cloud Run공개 URL 여기부터 '남'이 앱을 씁니다 키는 어디에? 요금은 누구에게? 공개 범위 · 사용 한도 · 키 위치 ①~③은 혼자 쓰는 구간 실수해도 영향이 나에게 머문다
Google Cloud 사용 사례 페이지의 다섯 단계. 아래쪽 질문은 이 글에서 덧붙인 확인 지점입니다.

먼저 앱을 설명하는 프롬프트를 씁니다. AI Studio가 코드와 파일을 만들고 오른쪽에 실시간 미리보기를 띄웁니다. 그다음 후속 프롬프트로 모양과 기능을 다듬습니다.

네 번째 단계가 흥미롭습니다. 배포하기 전에 프로젝트 URL 뒤에 &fullscreenApplet=true를 붙여 '전체 화면 보기'를 친구나 멘토에게 공유할 수 있다고 적혀 있습니다. 서버를 띄우지 않고도 다른 사람의 손을 먼저 타 보는 셈입니다.

마지막이 'Deploy to Cloud Run' 버튼입니다. 컨테이너로 묶고 호스팅하는 일은 AI Studio가 대신 처리하고, 바로 라이브 URL이 나옵니다.

키는 어디로 가나

여기서 처음 드는 걱정은 Gemini API 키입니다. 브라우저에서 돌아가는 앱이라면 키가 사용자에게 그대로 보일 수 있으니까요.

AI Studio의 Build 모드 문서는 이 부분을 짧게 답합니다. Cloud Run으로 배포하면 API 키가 서버 쪽 환경에 안전하게 들어간다고 합니다. Gemini 호출이 서버 쪽 코드에서 일어나기 때문에 클라이언트 코드에는 키가 남지 않는다는 설명입니다.

다만 조건이 붙습니다. ZIP으로 내려받아 다른 곳에 올린다면 GEMINI_API_KEY 환경 변수를 직접 설정해야 합니다. AI Studio가 대신 해 주는 건 Cloud Run으로 갈 때뿐입니다.

공유하면 내 한도가 줄어든다

두 번째 걱정은 돈입니다. 문서는 앱이 기본적으로 비공개라고 말합니다. 공유한 사람은 코드를 보고 포크할 수 있고, 편집 권한까지 주면 코드를 바꿀 수도 있습니다.

비용 문장은 이렇습니다. 공유된 앱은 내 사용 한도를 쓰고, 유료 모델을 쓰면 비용이 생길 수 있습니다. 그래서 AI Studio는 앱이 비용을 만들 수 있으면 설정할 때와 공유하기 전에 경고를 띄운다고 합니다.

정리하면 이렇습니다. 앱을 만든 사람의 키로, 앱을 쓰는 모든 사람의 호출이 처리됩니다. 데모가 생각보다 잘 퍼지면 청구서도 같이 퍼집니다.

사용자들 Cloud Run 서비스 만든 사람의 API 키 Gemini API 키는 서버 쪽에만 있다 · 요청은 모두 이 키로 처리된다
문서 설명을 바탕으로 그린 구조. 키가 브라우저에 노출되지 않는 대신, 모든 사용자의 호출이 만든 사람의 한도와 요금으로 잡힙니다.

공개 URL을 누르기 전에

문서를 읽고 나면 버튼을 누르기 전에 확인할 것이 세 가지로 좁혀집니다.

  • 이 앱을 누가 쓸 것인가. 나와 동료 몇 명이면 비공개 공유로 충분합니다. 불특정 다수라면 사용량이 곧 내 요금이라는 점을 먼저 받아들여야 합니다.
  • 키가 어디에 있는가. Cloud Run 배포라면 서버 쪽 환경에 있습니다. ZIP으로 옮겼다면 직접 넣어야 하고, 그때 키를 프런트엔드 코드에 박아 넣는 실수가 가장 흔하게 일어날 자리입니다.
  • 코드는 어디에 남는가. Build 모드는 GitHub와 양방향 동기화를 지원합니다. 저장소로 밀어 넣으면 AI가 커밋 메시지를 붙이고, 바깥에서 바뀐 내용도 다시 끌어올 수 있습니다. 데모가 서비스로 자랄 가능성이 있다면 이때부터 저장소에 남겨 두는 편이 낫습니다.

마지막 항목은 이 연재 1편의 질문과 같습니다. 이 코드가 버려질 것인가, 남을 것인가. 남을 것 같다면 버튼 하나로 끝나는 배포 뒤에 저장소와 리뷰를 붙이는 일은 사람이 챙겨야 합니다.