<div id="readability-page-1" class="page"><div><div aria-hidden="false"><a rel="noopener follow" href="/?source=post_page---byline--42e9778679c5---------------------------------------"><div><p><img alt="이상문" src="https://miro.medium.com/v2/resize:fill:64:64/1*PdFTYwkEj-ebxhH52VWJ8w.png" width="32" height="32" loading="lazy" data-testid="authorPhoto"></p></div></a></div><p id="3db1">이 글을 통해 Google Cloud Run을 활용하여 클라우드 상에서 서버 프로그램을 배포하는 전체 흐름을 정리한다. 프로젝트 설정부터 Docker 컨테이너 빌드, Cloud Run 배포 및 웹 브라우저에서 확인까지 따라할 수 있는 형태로 구성한다.</p><h2 id="f1ff">1. Google Cloud 프로젝트 생성 및 설정</h2><h2 id="b397">1–1. GCP 콘솔에서 프로젝트 생성</h2><ul><li id="1a87"><a href="https://console.cloud.google.com/" rel="noopener ugc nofollow" target="_blank">Google Cloud Console</a>에 접속한다.</li><li id="f6cc">왼쪽 상단의 <strong>프로젝트 선택</strong> 버튼 클릭 → <strong>새 프로젝트</strong> 클릭.</li><li id="d65f">프로젝트 이름 입력 후 <strong>만들기</strong>를 클릭한다.</li></ul><h2 id="900a">1–2. gcloud CLI로 프로젝트 생성 (선택)</h2><pre><span id="a9dc">gcloud projects create [PROJECT_ID] --name="[PROJECT_NAME]"</span></pre><ul><li id="21c3"><code>[PROJECT_ID]</code>: 고유한 ID (예: my-cloud-run-app)</li><li id="8332"><code>[PROJECT_NAME]</code>: 사람이 읽기 쉬운 이름</li></ul><p id="1820">프로젝트 생성 후 기본 프로젝트로 설정한다.</p><pre><span id="3d13">gcloud config set project [PROJECT_ID]</span></pre><h2 id="1a88">2. 필수 API 활성화</h2><p id="6018">Cloud Run과 Cloud Build API는 컨테이너를 빌드하고 배포하는 데 필수적인 서비스이다.</p><ul><li id="1977"><strong>Cloud Run API</strong>: HTTP 요청을 수신할 수 있는 컨테이너 기반 서버리스 애플리케이션을 실행한다.</li><li id="1e6a"><strong>Cloud Build API</strong>: 소스 코드에서 컨테이너 이미지를 빌드하고 Container Registry 또는 Artifact Registry로 푸시한다.</li></ul><p id="e5bd">다음 명령어로 두 API를 활성화할 수 있다.</p><pre><span id="e4da">gcloud services enable run.googleapis.com<br>gcloud services enable cloudbuild.googleapis.com</span></pre><h2 id="73fc">3. 간단한 서버 프로그램 작성</h2><p id="be35">이 단계에서는 Cloud Run을 통해 배포할 실제 서버 프로그램을 작성한다. 이 프로그램은 클라우드에서 실행되는 HTTP 서버의 역할을 하며, 기본적으로 “Hello from Cloud Run!” 메시지를 반환하게 된다.</p><h2 id="da9f">예: Python (FastAPI 기반)</h2><p id="5d1c"><code>main.py</code></p><pre><span id="16dd">from fastapi import FastAPI<p>app = FastAPI()<br>@app.get("/")<br>def read_root():<br>    return {"message": "Hello from Cloud Run!"}</p></span></pre><p id="e345"><code>requirements.txt</code></p><pre><span id="65b2">fastapi<br>uvicorn[standard]</span></pre><p id="15b1"><code>Dockerfile</code></p><pre><span id="be58">FROM python:3.11-slim<p>WORKDIR /app<br>COPY requirements.txt ./<br>RUN pip install --no-cache-dir -r requirements.txt<br>COPY . .<br>CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]</p></span></pre><h2 id="b251">4. Docker 컨테이너 빌드 및 푸시</h2><p id="f730">작성한 서버 프로그램을 클라우드에 배포하기 위해 컨테이너 이미지를 먼저 빌드하고 Container Registry에 업로드한다.</p><h2 id="2b17">4–1. Cloud Build를 통한 이미지 빌드 및 Container Registry 푸시</h2><pre><span id="2f34">gcloud builds submit \<br>  --tag gcr.io/[PROJECT_ID]/my-cloud-run-app</span></pre><ul><li id="6374"><code>gcr.io/[PROJECT_ID]/my-cloud-run-app</code>: 컨테이너 이미지 경로</li></ul><blockquote><p id="5e3c"><em>⚠️ 위 명령은 이미지를 업로드하는 작업까지만 수행하며, 아직 Cloud Run을 통해 서비스되는 상태는 아니다. 실제 서비스를 이용하려면 다음 단계를 통해 배포를 완료해야 한다.</em></p></blockquote><h2 id="28ed">5. Cloud Run에 배포</h2><pre><span id="4bd8">gcloud run deploy my-cloud-run-app \<br>  --image gcr.io/[PROJECT_ID]/my-cloud-run-app \<br>  --platform managed \<br>  --region asia-northeast3 \<br>  --allow-unauthenticated</span></pre><ul><li id="1933"><code>--platform managed</code>: Cloud Run fully-managed 사용</li><li id="4cdd"><code>--region</code>: 원하는 리전을 설정 (서울은 <code>asia-northeast3</code>)</li><li id="b6ec"><code>--allow-unauthenticated</code>: 인증 없이 누구나 접근 가능하게 설정</li></ul><p id="6378">배포가 완료되면 서비스 URL이 출력되며, 이 URL을 통해 클라우드 상에서 실제 서버 프로그램이 동작하는 것을 확인할 수 있다.</p><h2 id="a7e0">6. 웹 브라우저에서 테스트</h2><p id="63ea">터미널 출력에 나오는 URL을 복사해 웹 브라우저에서 접속해서 서비스를 동작시켜 보자. 앞에서 배포를 정상적으로 완료하게 되면 서비스하고 있는 URL을 확인할 수 있다.</p><blockquote><p id="34c0"><em>예시: </em><code><a href="https://my-cloud-run-app-abcdefg-uc.a.run.app/" rel="noopener ugc nofollow" target="_blank"><em>https://my-cloud-run-app-abcdefg-uc.a.run.app</em></a></code></p></blockquote><p id="a77d"><code>{"message":"Hello from Cloud Run!"}</code>이 출력된다면 배포가 성공한 것이다.</p></div></div>

Stories by 이상문 on Medium

이 글을 통해 Google Cloud Run을 활용하여 클라우드 상에서 서버 프로그램을 배포하는 전체 흐름을 정리한다. 프로젝트 설정부터 Docker 컨테이너 빌드, Cloud Run 배포 및 웹 브라우저에서 확인까지 따라할 수 있는 형태로 구성한다.
1. Google Cloud 프로젝트 생성 및 설정
1–1. GCP 콘솔에서 프로젝트 생성
Google Cloud Console에 접속한다.
왼쪽 상단의 프로젝트 선택 버튼 클릭 → 새 프로젝트 클릭.
프로젝트 이름 입력 후 만들기를 클릭한다.
1–2. gcloud CLI로 프로젝트 생성 (선택)
gcloud projects create [PROJECT_ID] --name="[PROJECT_NAME]"
[PROJECT_ID]: 고유한 ID (예: my-cloud-run-app)
[PROJECT_NAME]: 사람이 읽기 쉬운 이름
프로젝트 생성 후 기본 프로젝트로 설정한다.
gcloud config set project [PROJECT_ID]
2. 필수 API 활성화
Cloud Run과 Cloud Build API는 컨테이너를 빌드하고 배포하는 데 필수적인 서비스이다.
Cloud Run API: HTTP 요청을 수신할 수 있는 컨테이너 기반 서버리스 애플리케이션을 실행한다.
Cloud Build API: 소스 코드에서 컨테이너 이미지를 빌드하고 Container Registry 또는 Artifact Registry로 푸시한다.
다음 명령어로 두 API를 활성화할 수 있다.
gcloud services enable run.googleapis.com
gcloud services enable cloudbuild.googleapis.com
3. 간단한 서버 프로그램 작성
이 단계에서는 Cloud Run을 통해 배포할 실제 서버 프로그램을 작성한다. 이 프로그램은 클라우드에서 실행되는 HTTP 서버의 역할을 하며, 기본적으로 “Hello from Cloud Run!” 메시지를 반환하게 된다.
예: Python (FastAPI 기반)
main.py
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def read_root():
    return {"message": "Hello from Cloud Run!"}
requirements.txt
fastapi
uvicorn[standard]
Dockerfile
FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt ./
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8080"]
4. Docker 컨테이너 빌드 및 푸시
작성한 서버 프로그램을 클라우드에 배포하기 위해 컨테이너 이미지를 먼저 빌드하고 Container Registry에 업로드한다.
4–1. Cloud Build를 통한 이미지 빌드 및 Container Registry 푸시
gcloud builds submit \
  --tag gcr.io/[PROJECT_ID]/my-cloud-run-app
gcr.io/[PROJECT_ID]/my-cloud-run-app: 컨테이너 이미지 경로
⚠️ 위 명령은 이미지를 업로드하는 작업까지만 수행하며, 아직 Cloud Run을 통해 서비스되는 상태는 아니다. 실제 서비스를 이용하려면 다음 단계를 통해 배포를 완료해야 한다.
5. Cloud Run에 배포
gcloud run deploy my-cloud-run-app \
  --image gcr.io/[PROJECT_ID]/my-cloud-run-app \
  --platform managed \
  --region asia-northeast3 \
  --allow-unauthenticated
--platform managed: Cloud Run fully-managed 사용
--region: 원하는 리전을 설정 (서울은 asia-northeast3)
--allow-unauthenticated: 인증 없이 누구나 접근 가능하게 설정
배포가 완료되면 서비스 URL이 출력되며, 이 URL을 통해 클라우드 상에서 실제 서버 프로그램이 동작하는 것을 확인할 수 있다.
6. 웹 브라우저에서 테스트
터미널 출력에 나오는 URL을 복사해 웹 브라우저에서 접속해서 서비스를 동작시켜 보자. 앞에서 배포를 정상적으로 완료하게 되면 서비스하고 있는 URL을 확인할 수 있다.
예시: https://my-cloud-run-app-abcdefg-uc.a.run.app
{"message":"Hello from Cloud Run!"}이 출력된다면 배포가 성공한 것이다.

Google Cloud Run을 활용한 서버 애플리케이션 배포 가이드

댓글