Cloud Run은 HTTP 요청으로 호출 가능한 스테이트리스(Stateless) 컨테이너를 실행하는 관리형 컴퓨팅 플랫폼입니다. Cloud Run은 서버리스입니다. 인프라를 관리할 필요가 없으므로 우수한 앱을 빌드하는 데 가장 중요한 작업에 집중할 수 있습니다. Knative에서 빌드되므로 Cloud Run (완전 관리형) 또는 Cloud Run for Anthos 중 하나를 사용하여 컨테이너를 실행할 수 있습니다. 이 Codelab의 목표는 컨테이너 이미지를 빌드하여 Cloud Run에 배포하는 것입니다.
기본 요건
해당 없음
자습형 환경 설정
Google 계정 (Gmail 또는 Google 앱)이 아직 없다면 계정을 만들어야 합니다. Google Cloud Platform Console(console.cloud.google.com)에 로그인하여 새 프로젝트를 만듭니다.
모든 Google Cloud 프로젝트에서 고유한 이름인 프로젝트 ID를 기억하세요(위의 이름은 이미 사용되었으므로 사용할 수 없습니다). 이 ID는 나중에 이 Codelab에서 PROJECT_ID라고 부릅니다.
다음으로 Google Cloud 리소스를 사용하려면 Cloud Console에서 결제를 사용 설정해야 합니다.
이 codelab을 실행하는 과정에는 많은 비용이 들지 않지만 더 많은 리소스를 사용하려고 하거나 실행 중일 경우 비용이 더 들 수 있습니다(이 문서 마지막의 '삭제' 섹션 참조).
Google Cloud Platform의 신규 사용자는 $300 무료 체험판을 사용할 수 있습니다.
Cloud Shell
노트북에서 원격으로 작동할 수 있는 상황에서 Google Cloud에서 실행되는 명령줄 환경인 Cloud Shell을 사용합니다.
이 Debian 기반 가상 머신에는 필요한 모든 개발 도구가 로드되어 있습니다. 영구적인 5GB 홈 디렉토리를 제공하고 Google Cloud에서 실행되므로 네트워크 성능과 인증이 크게 개선됩니다. 즉, 이 Codelab에 필요한 것은 브라우저뿐입니다(Chromebook에서도 작동 가능).
Google Cloud Shell을 활성화하려면 개발자 콘솔에서 오른쪽 상단의 버튼을 클릭하면 됩니다. 환경을 프로비저닝하고 연결하는 데는 몇 분 정도만 소요됩니다.
'Cloud Shell 시작' 버튼을 클릭합니다.
Cloud Shell에 연결되면 인증이 이미 완료되어 있고 프로젝트가 이미 PROJECT_ID으로 설정되어 있음을 확인할 수 있습니다.
gcloud auth list
명령어 결과
Credentialed accounts: - <myaccount>@<mydomain>.com (active)
gcloud config list project
명령어 결과
[core] project = <PROJECT_ID>
Cloud Shell은 또한 향후 명령어를 실행할 때 유용할 수 있는 일부 환경 변수도 기본적으로 설정합니다.
echo $GOOGLE_CLOUD_PROJECT
명령어 결과
<PROJECT_ID>
어떤 이유로 프로젝트가 설정되지 않은 경우 다음 명령어를 실행하면 됩니다.
gcloud config set project <PROJECT_ID>
PROJECT_ID를 찾고 계신가요? 설정 단계에서 사용한 ID를 확인하거나 콘솔 대시보드에서 찾아보세요.
중요: 마지막으로 기본 영역 및 프로젝트 구성을 설정합니다.
gcloud config set compute/zone us-central1-f
다양한 영역을 선택할 수 있습니다. 리전 및 영역 영역 문서에서 자세히 알아보세요.
Cloud Run API를 사용 설정합니다.
Cloud Shell에서 Cloud Run API를 사용 설정합니다.
gcloud services enable run.googleapis.com
이렇게 하면 다음과 같은 성공적인 메시지가 생성됩니다.
Operation "operations/acf.cc11852d-40af-47ad-9d59-477a12847c9e" finished successfully.
HTTP 요청에 응답하는 간단한 익스프레스 기반 Node.js 앱을 빌드합니다.
앱을 빌드하려면 Cloud Shell을 사용하여 helloworld-nodejs라는 새 디렉터리를 만들고 이 디렉터리로 변경합니다.
mkdir helloworld-nodejs cd helloworld-nodejs
다음 콘텐츠로 package.json라는 파일을 만듭니다.
{
"name": "cloudrun-helloworld",
"version": "1.0.0",
"description": "Simple hello world sample in Node",
"main": "index.js",
"scripts": {
"start": "node index.js"
},
"author": "",
"license": "Apache-2.0",
"dependencies": {
"express": "^4.17.1"
}
}무엇보다도 위의 파일에는 시작 스크립트 명령어와 Express 웹 앱 프레임워크의 종속 항목이 포함되어 있습니다.
그런 다음, 동일한 디렉터리에 index.js 파일을 만들고 다음 콘텐츠를 복사합니다.
const express = require('express');
const app = express();
app.get('/', (req, res) => {
console.log('Hello world received a request.');
const target = process.env.TARGET || 'World';
res.send(`Hello ${target}!`);
});
const port = process.env.PORT || 8080;
app.listen(port, () => {
console.log('Hello world listening on port', port);
});이 코드는 PORT 환경 변수로 정의한 포트를 리슨하는 기본 웹 서버를 생성합니다. 이제 앱에서 컨테이너화, 테스트, Container Registry에 업로드할 준비가 되었습니다.
샘플 앱을 컨테이너화하려면 소스 파일이 있는 디렉터리에 Dockerfile라는 새 파일을 만들고 다음 콘텐츠를 복사합니다.
# Use the official lightweight Node.js 12 image.
# https://hub.docker.com/_/node
FROM node:12-slim
# Create and change to the app directory.
WORKDIR /usr/src/app
# Copy application dependency manifests to the container image.
# A wildcard is used to ensure both package.json AND package-lock.json are copied.
# Copying this separately prevents re-running npm install on every code change.
COPY package*.json ./
# Install production dependencies.
RUN npm install --only=production
# Copy local code to the container image.
COPY . ./
# Run the web service on container startup.
CMD [ "npm", "start" ]이제 Dockerfile이 포함되어 있는 디렉터리에서 다음 명령어를 실행하여 Cloud Build로 컨테이너 이미지를 빌드합니다.
gcloud builds submit --tag gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld
$GOOGLE_CLOUD_PROJECT는 Cloud Shell에서 실행될 때 Google Cloud 프로젝트 ID를 포함하는 환경 변수입니다. gcloud config get-value project를 실행하여 가져올 수도 있습니다.
레지스트리로 푸시하면 이미지 이름 (gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld)이 포함된 SUCCESS 메시지가 표시됩니다. 이미지는 Container Registry에 저장되어 있으며 원하는 경우 재사용할 수 있습니다.
다음 명령어를 사용하여 현재 프로젝트와 연결된 모든 컨테이너 이미지를 나열할 수 있습니다.
gcloud container images list
Cloud Shell에서 앱을 로컬로 실행하고 테스트하려면 이 표준 docker 명령어를 사용하면 시작할 수 있습니다.
docker run -d -p 8080:8080 gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld
Cloud Shell에서 웹 미리보기 
를 클릭하고 포트 8080에서 미리보기를 선택합니다.
그러면 Hello World! 라는 브라우저 창이 열립니다.
curl localhost:8080를 사용할 수도 있습니다.
컨테이너화된 앱을 Cloud Run에 배포하는 작업은 다음 명령어를 통해 실행됩니다. 빌드한 앱의 올바른 이미지 이름으로 조정하거나 gcr.io/cloudrun/hello 사전 빌드된 이미지를 사용해야 합니다.
gcloud run deploy helloworld \ --image gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld \ --platform managed \ --region us-central1 \ --allow-unauthenticated
--allow-unauthenticated 배포 옵션을 사용하면 인증 없이 앱에 연결할 수 있습니다. --platform managed \ 배포 옵션은 Anthos를 통해 Kubernetes 인프라가 아닌 완전 관리형 환경을 요청한다는 의미입니다.
그런 다음 배포가 완료될 때까지 잠시 기다립니다. 완료되면 명령줄에 서비스 URL이 표시됩니다.
Service [helloworld] revision [helloworld-00001] has been deployed and is serving traffic at https://helloworld-wdl7fdwaaa-uc.a.run.app
이제 웹브라우저에서 서비스 URL을 열어 배포된 컨테이너를 방문할 수 있습니다.
Cloud Run은 수신된 요청을 처리하기 위해 컨테이너 이미지를 자동 및 수평으로 확장한 다음 수요가 감소하면 축소합니다. 요청 처리 도중 소비한 CPU, 메모리, 네트워킹에 대해서만 비용을 지불하면 됩니다.
서비스 사용 중에는 Cloud Run이 요금이 청구되지 않지만 빌드된 컨테이너 이미지 저장 요금은 계속 청구될 수 있습니다.
Google Cloud 프로젝트를 삭제하여 해당 프로젝트에서 사용하는 모든 리소스의 요금이 청구되지 않도록 하거나 다음 명령어를 사용하여 helloworld 이미지를 삭제하면 됩니다.
gcloud container images delete gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld
Cloud Run 서비스를 삭제하려면 다음 명령어를 사용합니다.
gcloud run services delete helloworld \ --platform managed \ --region us-central1
수고하셨습니다. 컨테이너 이미지로 패키징된 앱을 Cloud Run에 배포했습니다.
자세히 알아보기
다음 단계는 빠른 시작: Google Cloud에서 Cloud Run for Anthos에 배포를 확인하는 것입니다.
코드 소스에서 Cloud Run에 적합한 스테이트리스(Stateless) HTTP 컨테이너를 빌드하고 Container Registry로 푸시하는 방법에 대한 자세한 내용은 다음 리소스를 참조하세요.
기본 오픈소스 프로젝트인 Knative에 대한 자세한 내용은 Knative를 참조하세요.