최근에 Google Cloud를 주 클라우드 서비스 제공업체(CSP)로 사용하는 IT 기업에 클라우드 개발자로 채용되었다고 가정해 보겠습니다. 여러분은 서버리스, 스테이트리스(Stateless) 웹 애플리케이션을 클라우드에 빌드하라는 지시를 받았습니다. 이에 따라 Google Cloud에서 제공하는 Cloud Run 서비스를 도입해야 합니다. 이때 몇 가지 고려해야 할 사항이 있습니다.

• Cloud Run API 활성화
• 컨테이너 이미지 스토리지
• 컨테이너화된 서버리스 앱 배포
• 비용 절감 권장사항

여러분은 이전 직장에서 AWS를 사용한 경험이 있으므로 AWS Fargate가 컨테이너화된 환경을 서버리스 방식으로 프로비저닝한다는 점을 알고 있습니다. AWS Fargate는 컨테이너 출시, 확장, 모니터링 작업을 처리하므로 개발자는 애플리케이션 코드에 집중하여 컨테이너화된 애플리케이션을 쉽게 배포, 관리, 확장할 수 있습니다. AWS Fargate를 사용하면 Amazon Elastic Container Service(Amazon ECS) 또는 Amazon Elastic Kubernetes Service(Amazon EKS)를 위한 컨테이너를 배포할 수도 있습니다. 즉 개발자는 필요에 따라 가장 적합한 조정 옵션을 선택할 수 있습니다.

AWS Fargate 기반의 컨테이너화된 서버리스 애플리케이션은 다음 다이어그램과 같습니다.

이제 Google Cloud에서 애플리케이션을 배포하는 방법을 살펴보겠습니다.

개요

Cloud Run은 HTTP 요청으로 호출 가능한 스테이트리스(Stateless) 컨테이너를 실행하는 관리형 컴퓨팅 플랫폼입니다. Cloud Run은 서버리스이므로 인프라 관리가 필요 없습니다. 따라서 개발자가 본연의 업무인 애플리케이션 개발에 집중할 수 있습니다.

Cloud Run은 Knative 기반으로 빌드되어 컨테이너 실행 환경을 선택할 수 있습니다. Cloud Run을 사용하는 완전 관리형 환경 또는 GKE에서 Cloud Run을 사용하는 Google Kubernetes Engine 클러스터 중에서 선택하면 됩니다.

이 실습의 목적은 컨테이너화된 간단한 애플리케이션 이미지를 빌드하여 Cloud Run에 배포하는 방법을 배우는 것입니다.

목표

이 실습에서는 다음을 수행하는 방법에 대해 알아봅니다.

• Cloud Run API를 사용 설정합니다.
• 서버리스, 스테이트리스(Stateless) 컨테이너로 배포할 수 있는 간단한 Node.js 애플리케이션을 만듭니다.
• 애플리케이션을 컨테이너화하고 Container Registry(현재 명칭은 'Artifact Registry')에 업로드합니다.
• Cloud Run에 컨테이너화된 애플리케이션을 배포합니다.
• 추가적인 스토리지 비용이 발생하지 않도록 불필요한 이미지를 삭제합니다.

설정 및 요건

각 실습에서는 정해진 기간 동안 새 Google Cloud 프로젝트와 리소스 집합이 무료로 제공됩니다.

1. 시크릿 창을 사용하여 Qwiklabs에 로그인합니다.

2. 실습 사용 가능 시간(예: 1:15:00)을 참고하여 해당 시간 내에 완료합니다.
   일시중지 기능은 없습니다. 필요한 경우 다시 시작할 수 있지만 처음부터 시작해야 합니다.

3. 준비가 되면 실습 시작을 클릭합니다.

4. 실습 사용자 인증 정보(사용자 이름 및 비밀번호)를 기록해 두세요. Google Cloud Console에 로그인합니다.

5. Google Console 열기를 클릭합니다.

6. 다른 계정 사용을 클릭한 다음, 안내 메시지에 이 실습에 대한 사용자 인증 정보를 복사하여 붙여넣습니다.
   다른 사용자 인증 정보를 사용하는 경우 오류가 발생하거나 요금이 부과됩니다.

7. 약관에 동의하고 리소스 복구 페이지를 건너뜁니다.

실습을 시작하고 콘솔에 로그인하는 방법

1. 실습 시작 버튼을 클릭합니다. 실습 비용을 결제해야 하는 경우 결제 수단을 선택할 수 있는 팝업이 열립니다. 왼쪽에 있는 패널에서 이 실습에 사용해야 하는 임시 사용자 인증 정보를 확인할 수 있습니다.

   

2. 사용자 이름을 복사한 다음 Google 콘솔 열기를 클릭합니다. 실습에서 리소스가 실행되며 계정 선택 페이지를 표시하는 다른 탭이 열립니다.

   참고: 두 개의 탭을 각각 별도의 창으로 나란히 여세요.

3. 계정 선택 페이지에서 다른 계정 사용을 클릭합니다. 로그인 페이지가 열립니다.

   

4. 연결 세부정보 패널에서 복사한 사용자 이름을 붙여넣습니다. 그런 다음 비밀번호를 복사하여 붙여넣습니다.

참고: 연결 세부정보 패널에 표시된 사용자 인증 정보를 사용해야 합니다. Google Cloud Skills Boost 사용자 인증 정보를 사용하지 마세요. 개인용 Google Cloud 계정이 있어도 이 실습에서 사용하지 마세요(요금 청구 방지).

5. 이후에 표시되는 페이지를 클릭하여 넘깁니다.

• 이용약관에 동의합니다.
• 임시 계정이므로 복구 옵션이나 2단계 인증을 추가하지 않습니다.
• 무료 평가판을 신청하지 않습니다.

잠시 후 Cloud 콘솔이 이 탭에서 열립니다.

참고: 왼쪽 상단에 있는 탐색 메뉴를 클릭하면 Google Cloud 제품 및 서비스 목록이 있는 메뉴를 볼 수 있습니다.

Google Cloud Shell 활성화하기

Google Cloud Shell은 다양한 개발 도구가 탑재된 가상 머신으로, 5GB의 영구 홈 디렉터리를 제공하며 Google Cloud에서 실행됩니다.

Google Cloud Shell을 사용하면 명령줄을 통해 Google Cloud 리소스에 액세스할 수 있습니다.

1. Cloud 콘솔의 오른쪽 상단 툴바에서 'Cloud Shell 열기' 버튼을 클릭합니다.

   

2. 계속을 클릭합니다.

환경을 프로비저닝하고 연결하는 데 몇 분 정도 소요됩니다. 연결되면 사용자가 미리 인증되어 프로젝트가 PROJECT_ID로 설정됩니다. 예:

gcloud는 Google Cloud의 명령줄 도구입니다. Cloud Shell에 사전 설치되어 있으며 명령줄 자동 완성을 지원합니다.

• 다음 명령어를 사용하여 사용 중인 계정 이름을 나열할 수 있습니다.

gcloud auth list

출력:

Credentialed accounts: - @.com (active)

출력 예시:

Credentialed accounts: - google1623327_student@qwiklabs.net

• 다음 명령어를 사용하여 프로젝트 ID를 나열할 수 있습니다.

gcloud config list project

출력:

[core] project =

출력 예시:

[core] project = qwiklabs-gcp-44776a13dea667a6 참고: gcloud 전체 문서는 gcloud CLI 개요 가이드를 참조하세요.

참조

기본 Linux 명령어

다음은 이 실습의 지침 또는 코드 블록에 등장할 수 있는 몇 가지 기본 Linux 명령어입니다.

명령어 -->	작업	.	명령어 -->	작업
mkdir(디렉터리 생성)	새 폴더를 만듭니다.	.	cd(디렉터리 변경)	다른 폴더로 위치를 변경합니다.
ls(항목 나열)	디렉터리 내 파일 및 폴더를 나열합니다.	.	cat(연결)	편집기를 사용하지 않고 파일 콘텐츠를 읽어 옵니다.
apt-get update	패키지 관리자 라이브러리를 업데이트합니다.	.	ping	호스트의 연결 가능성을 테스트하기 위해 신호를 보냅니다.
mv(이동)	파일을 이동합니다.	.	cp(복사)	파일 사본을 만듭니다.
pwd(현재 작업 디렉터리)	현재 위치를 반환합니다.	.	sudo(수퍼유저 권한 실행)	상위 관리자 권한을 부여합니다.

작업 1. Cloud Run API 사용 설정 및 Shell 환경 구성

1. Cloud Shell에서 Cloud Run API를 사용 설정합니다.

gcloud services enable run.googleapis.com

2. 사용자 인증 정보의 사용을 승인하라는 메시지가 표시되고 이를 승인하면 다음과 비슷한 성공 메시지가 표시됩니다.

Operation "operations/acf.cc11852d-40af-47ad-9d59-477a12847c9e" finished successfully. 참고: 콘솔의 API 및 서비스 섹션을 사용하여 API를 사용 설정할 수도 있습니다.

3. 컴퓨팅 리전을 설정합니다.

gcloud config set compute/region {{{ project_0.default_region| "Region" }}}

4. LOCATION 환경 변수를 만듭니다.

LOCATION="{{{ project_0.default_region| "Region" }}}"

작업 2. 샘플 애플리케이션 작성

이 작업에서는 HTTP 요청에 응답하는 간단한 표현 기반 NodeJS 애플리케이션을 빌드합니다.

1. Cloud Shell에서 이름이 helloworld인 새 디렉터리를 만든 다음, 이 디렉터리로 뷰를 이동합니다.

mkdir helloworld && cd helloworld

2. 그런 다음 파일을 만들고 편집합니다. 파일을 편집하려면 vi, emac, nano를 사용하거나 Cloud Shell에서 편집기 열기 버튼을 클릭하여 Cloud Shell 코드 편집기를 사용합니다.

3. package.json 파일을 만든 다음, 아래의 내용을 추가합니다.

nano package.json { "name": "helloworld", "description": "Simple hello world sample in Node", "version": "1.0.0", "main": "index.js", "scripts": { "start": "node index.js" }, "author": "Google LLC", "license": "Apache-2.0", "dependencies": { "express": "^4.17.1" } }

가장 중요한 점은 위의 파일에 Express 웹 애플리케이션 프레임워크에 대한 종속 항목과 시작 스크립트 명령어가 포함되어 있다는 점입니다.

4. Ctrl+X를 누른 다음 Y를 눌러 package.json 파일을 저장합니다.

5. 이제 동일한 디렉터리에서 index.js 파일을 만든 후 이 파일에 다음을 복사하여 붙여넣습니다.

nano index.js const express = require('express'); const app = express(); const port = process.env.PORT || 8080; app.get('/', (req, res) => { const name = process.env.NAME || 'World'; res.send(`Hello ${name}!`); }); app.listen(port, () => { console.log(`helloworld: listening on port ${port}`); });

이 코드는 PORT 환경 변수로 정의한 포트를 리슨하는 기본 웹 서버를 생성합니다. 앱이 완성되었으며 이제 컨테이너화하여 Container Registry에 업로드할 준비가 되었습니다.

6. Ctrl+X를 누른 다음 Y를 눌러 index.js 파일을 저장합니다.

참고: 여러 다른 언어를 사용하여 Cloud Run을 시작할 수도 있습니다. 빠른 시작 가이드에서 Go, Python, Java, PHP, Ruby, Shell 스크립트 등에 관한 안내를 찾을 수 있습니다.

작업 3. 앱을 컨테이너화한 다음 Artifact Registry에 업로드

1. 샘플 앱을 컨테이너화하려면 소스 파일과 동일한 디렉터리에 Dockerfile이라는 새 파일을 만든 후 이 파일에 다음 콘텐츠를 추가합니다.

nano Dockerfile # 경량의 공식 Node.js 12 이미지를 사용합니다. # https://hub.docker.com/_/node FROM node:12-slim # 앱 디렉터리를 생성한 후 앱 디렉터리로 변경합니다. WORKDIR /usr/src/app # 애플리케이션 종속 항목 매니페스트를 컨테이너 이미지에 복사합니다. # package.json과 package-lock.json(사용할 수 있는 경우)이 모두 복사되도록 와일드 카드를 사용합니다. # 이것을 먼저 복사하면 코드가 변경될 때마다 npm install이 재실행되는 것을 피할 수 있습니다. COPY package*.json ./ # 프로덕션 종속 항목을 설치합니다. # package-lock.json을 추가하면 'npm ci'로 전환하여 빌드를 가속화할 수 있습니다. # RUN npm ci --only=production RUN npm install --only=production # 로컬 코드를 컨테이너 이미지에 복사합니다. COPY . ./ # 컨테이너 시작 시 웹 서비스를 실행합니다. CMD [ "npm", "start" ]

2. Ctrl+X를 누른 다음 Y를 눌러 Dockerfile 파일을 저장합니다.

3. Dockerfile이 포함되어 있는 디렉터리에서 다음 명령어를 실행하여 Cloud Build로 컨테이너 이미지를 빌드합니다. (참고로 명령어의 $GOOGLE_CLOUD_PROJECT 환경 변수에는 실습 프로젝트 ID가 포함됩니다.)

gcloud builds submit --tag gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

Cloud Build는 GCP에서 빌드를 실행하는 서비스입니다. Cloud Build는 일련의 빌드 단계를 실행합니다. 여기에서 각 빌드 단계는 Docker 컨테이너에서 실행되어 애플리케이션 컨테이너(또는 기타 아티팩트)를 생성하며 이를 Cloud Registry로 푸시합니다. 이러한 모든 과정이 하나의 명령어로 이루어집니다.

레지스트리로 푸시된 후에는 이미지 이름이 포함된 SUCCESS 메시지가 표시됩니다(gcr.io/[PROJECT-ID]/helloworld). 이미지는 Artifact Registry에 저장되며 원하는 경우 다시 사용할 수 있습니다.

4. 다음 명령어를 사용하여 현재 프로젝트에 연결된 컨테이너 이미지를 모두 나열합니다.

gcloud container images list

5. Cloud Shell에서 로컬 방식으로 애플리케이션을 실행하고 테스트하려면 다음과 같은 표준 docker 명령어를 사용하여 시작합니다.

docker run -d -p 8080:8080 gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

6. Cloud Shell 창에서 웹 미리보기를 클릭하고 포트 8080에서 미리보기를 선택합니다.

그러면 브라우저 창이 열리고 'Hello World!' 메시지가 표시됩니다. 간단히 curl localhost:8080을 사용해도 됩니다.

참고: docker 명령어로 원격 컨테이너 이미지를 가져올 수 없는 경우에는 gcloud auth configure-docker를 실행해 보세요.

작업 4. Cloud Run에 배포

1. 컨테이너화된 애플리케이션을 Cloud Run에 배포하려면 다음 명령어를 사용하여 프로젝트 ID를 추가해야 합니다.

gcloud run deploy --image gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld --allow-unauthenticated --region=$LOCATION

위 명령어의 allow-unauthenticated 플래그를 사용하면 내 서비스가 공개적으로 액세스 가능하게 됩니다.

2. 메시지가 표시되면 Enter 키를 눌러 service name을 확인합니다.

그런 다음 배포가 완료될 때까지 잠시 기다립니다.

성공하면 명령줄에 다음과 같은 서비스 URL이 표시됩니다.

Service [helloworld] revision [helloworld-00001-xit] has been deployed and is serving 100 percent of traffic. Service URL: https://helloworld-h6cp412q3a-uc.a.run.app

이제 브라우저 창에서 서비스 URL을 열어 배포된 컨테이너로 이동할 수 있습니다.

수고하셨습니다. 컨테이너 이미지로 패키징된 애플리케이션을 Cloud Run에 배포했습니다. Cloud Run은 수신된 요청을 처리하기 위해 컨테이너 이미지를 자동 및 수평 확장한 다음 수요가 감소하면 축소합니다. 자체 환경에서는 요청 처리 도중 소비한 CPU, 메모리, 네트워킹에 대해서만 비용을 지불합니다.

이 실습에서는 gcloud 명령줄을 사용했습니다. Cloud Run은 Cloud 콘솔을 통해서도 사용할 수 있습니다.

• 탐색 메뉴의 서버리스 섹션에서 Cloud Run을 클릭하면 목록에 있는 helloworld 서비스가 표시됩니다.

작업 5. 삭제

Cloud Run에서는 서비스를 사용하지 않을 때 비용이 청구되지 않지만 빌드된 컨테이너 이미지를 저장하는 데 요금이 부과될 수 있습니다.

1. GCP 프로젝트를 삭제하여 비용 발생을 피하거나(해당 프로젝트 내에서 사용된 모든 리소스에 대한 청구가 중단됨) 간단하게 다음 명령어를 사용하여 helloworld 이미지를 삭제할 수 있습니다.

gcloud container images delete gcr.io/$GOOGLE_CLOUD_PROJECT/helloworld

2. 메시지가 표시되면 Y를 입력하고 Enter 키를 누릅니다.

3. Cloud Run 서비스를 삭제하려면 다음 명령어를 사용합니다.

gcloud run services delete helloworld --region={{{ project_0.default_region| "Region" }}}

4. 메시지가 표시되면 Y를 입력하고 Enter 키를 누릅니다.

수고하셨습니다

실습을 완료했습니다.

Google Cloud Run과 AWS Fargate는 모두 개발자가 확장 가능하고 비용 효율적인 방식으로 컨테이너화된 애플리케이션을 실행할 수 있는 서버리스 컴퓨팅 서비스입니다. 그러나 이 두 서비스 사이에는 몇 가지 차이점이 있습니다.

몇 가지 주요 유사점과 차이점은 다음과 같습니다.

유사점:

• Google Cloud Run과 AWS Fargate는 모두 서버리스 컴퓨팅 서비스이므로 개발자는 기본 인프라를 신경 쓰지 않고 코드 작성에만 집중할 수 있습니다.
• 두 서비스 모두 컨테이너화를 통해 애플리케이션을 패키징하고 배포합니다.
• 두 서비스 모두 배포 형식으로 Docker 컨테이너를 지원합니다.
• 두 서비스 모두 수요에 따라 자동으로 수직 확장 또는 축소할 수 있습니다.

차이점:

• AWS Fargate에서는 사용자가 Kubernetes 같은 컨테이너 조정을 구성하고 관리해야 하지만, Google Cloud Run에서는 플랫폼이 컨테이너 조정을 관리합니다.
• Google Cloud Run은 독립형 서비스이지만, AWS Fargate는 컨테이너 서비스인 Amazon ECS 또는 Amazon EKS를 위한 프로비저닝 서비스입니다.
• AWS에서 컨테이너화된 서버리스 환경을 배포하려면 Amazon ECS 또는 Amazon EKS와 같은 조정 서비스와 AWS Fargate를 통합해야 합니다. Google Cloud에서는 Cloud Run만 사용하면 됩니다.

실습 종료하기

실습을 완료하면 실습 종료를 클릭합니다. Google Cloud Skills Boost에서 사용된 리소스를 자동으로 삭제하고 계정을 지웁니다.

실습 경험을 평가할 수 있습니다. 해당하는 별표 수를 선택하고 의견을 입력한 후 제출을 클릭합니다.

별점의 의미는 다음과 같습니다.

• 별표 1개 = 매우 불만족
• 별표 2개 = 불만족
• 별표 3개 = 중간
• 별표 4개 = 만족
• 별표 5개 = 매우 만족

의견을 제공하고 싶지 않다면 대화상자를 닫으면 됩니다.

의견이나 제안 또는 수정할 사항이 있다면 지원 탭을 사용하세요.

Copyright 2020 Google LLC All rights reserved. Google 및 Google 로고는 Google LLC의 상표입니다. 기타 모든 회사명 및 제품명은 해당 업체의 상표일 수 있습니다.