개요

Cloud Run은 HTTP 요청으로 호출 가능한 스테이트리스(Stateless) 컨테이너를 실행하는 완전 관리형 컴퓨팅 플랫폼입니다. 컨테이너 이미지를 빌드할 경우 모든 프로그래밍 언어로 작성된 코드를 Cloud Run에 배포할 수 있습니다. Go, Node.js, Python, Java, .NET Core, Ruby로 애플리케이션을 개발할 때 컨테이너를 빌드하는 소스 기반 배포 옵션을 사용할 수 있습니다.

Cloud Run은 서버리스이며 Google의 확장 가능한 인프라에서 컨테이너를 실행합니다. Cloud Run은 Knative 기반으로 빌드되어 Cloud Run을 통한 완전 관리형으로 컨테이너를 실행하거나 GKE의 Cloud Run을 통한 Google Kubernetes Engine 클러스터에서 컨테이너를 실행할 수 있습니다.

Cloud Run은 Google Cloud의 다른 서비스와 잘 작동하므로 Cloud Run 서비스를 운영, 구성, 확장하는 데 너무 많은 시간을 들이지 않고도 완전한 기능을 갖춘 애플리케이션을 빌드할 수 있습니다.

목표

이 실습에서 학습할 내용은 다음과 같습니다.

• Cloud Build를 사용하여 애플리케이션의 Docker 컨테이너 이미지를 만듭니다.
• 컨테이너 이미지를 Cloud Run에 배포합니다.
• 컨테이너화된 애플리케이션을 실행하고 테스트합니다.

설정

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

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

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

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

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

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

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

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

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 개요 가이드를 참조하세요.

작업 1. 프로젝트 및 환경 구성

이 작업에서는 Cloud Shell 환경의 환경 변수를 설정하고 이 실습에서 사용할 관련 Google API를 사용 설정합니다.

1. 실습 사용자 인증 정보로 Google Cloud 콘솔에 로그인하고 Cloud Shell 터미널 창을 엽니다.

2. Cloud Shell에서 프로젝트 ID 및 리전 환경 변수를 설정하려면 다음 명령어를 실행합니다.

   PROJECT_ID=$(gcloud config get-value project) REGION={{{project_0.default_region|Region}}}

3. 관련 API를 사용 설정하려면 다음 명령어를 실행합니다.

   gcloud services enable artifactregistry.googleapis.com \ cloudbuild.googleapis.com \ run.googleapis.com

목표를 확인하려면 내 진행 상황 확인하기를 클릭합니다. 관련 API를 사용 설정합니다.

작업 2. 로컬로 애플리케이션 테스트

이 작업에서는 샘플 Node.js 애플리케이션을 복사합니다. 그런 다음 Cloud Shell 환경에서 로컬로 빌드하고 실행합니다.

애플리케이션 복사

1. app 디렉터리를 만들고 현재 작업 디렉터리로 설정합니다.

   mkdir app && cd app

2. Cloud Storage에서 앱을 복사하고 파일을 추출하려면 다음 명령어를 실행합니다.

   gsutil cp gs://cloud-training/CBL515/sample-apps/sample-node-app.zip . && unzip sample-node-app

애플리케이션 종속 항목 설치하기

1. 앱 디렉터리로 변경합니다.

   cd sample-node-app

2. 애플리케이션 소스 코드를 보려면 최상위 디렉터리에서 server.js 파일의 콘텐츠를 확인합니다.

   cat server.js 기본 애플리케이션 진입점입니다. 이 샘플 애플리케이션은 HTTP를 통해 애플리케이션에 요청이 이루어지면 제품 데이터를 반환하는 API를 제공하는 기본적인 소매 서비스입니다.

3. 앱의 종속 항목 모듈을 로컬로 설치하려면 다음 명령어를 실행합니다.

   npm install

애플리케이션 테스트

1. 애플리케이션을 로컬로 실행하려면 다음 명령어를 실행합니다.

   npm start

   다음과 같은 출력이 표시됩니다.

   > sample-node-app@1.0.0 start > node server.js Sample-node-app listening on port 8080!

2. 두 번째 Cloud Shell 터미널 창을 열려면 Cloud Shell 탐색 메뉴에서 ()를 클릭합니다.

3. 애플리케이션에 몇 가지 HTTP 요청을 보내 샘플 API를 테스트합니다.

   curl http://localhost:8080/service/products | jq 명령줄 도구 jq를 사용하여 애플리케이션의 JSON 응답을 파싱하고 형식을 지정합니다.

   애플리케이션은 제품 목록으로 응답해야 합니다.

   [ { "id": "1YMWWN1N4O", "name": "Home Barista Kit", "description": "Always wanted to brew coffee with Chemex and Aeropress at home?", "picture": "static/img/products/barista-kit.jpg", "cost": 124, "categories": [ "cookware" ] }, { "id": "L9ECAV7KIM", "name": "Terrarium", "description": "This terrarium will look great in your white painted living room.", "picture": "static/img/products/terrarium.jpg", "cost": 36.45, "categories": [ "gardening" ] }, { "id": "2ZYFJ3GM2N", "name": "Film Camera", "description": "This camera looks like it's a film camera, but it's actually digital.", "picture": "static/img/products/film-camera.jpg", "cost": 2245, "categories": [ "photography", "vintage" ] }, { "id": "LS4PSXUNUM", "name": "Metal Camping Mug", "description": "You probably don't go camping that often but this is better than plastic cups.", "picture": "static/img/products/camp-mug.jpg", "cost": 24.33, "categories": [ "cookware" ] }, { "id": "9SIQT8TOJO", "name": "City Bike", "description": "This single-gear bike probably cannot climb the hills of San Francisco.", "picture": "static/img/products/city-bike.jpg", "cost": 789.5, "categories": [ "cycling" ] }, { "id": "6E92ZMYYFZ", "name": "Air Plant", "description": "Have you ever wondered whether air plants need water? Buy one and figure out.", "picture": "static/img/products/air-plant.jpg", "cost": 12.3, "categories": [ "gardening" ] } ]

4. ID로 특정 제품을 가져오기 위해 두 번째 API 요청을 합니다.

   curl http://localhost:8080/service/products/1YMWWN1N4O | jq

   애플리케이션은 특정 제품에 대한 세부정보로 응답해야 합니다.

   { "id": "1YMWWN1N4O", "name": "Home Barista Kit", "description": "Always wanted to brew coffee with Chemex and Aeropress at home?", "picture": "static/img/products/barista-kit.jpg", "cost": 124, "categories": [ "cookware" ] }

5. 애플리케이션을 종료하려면 첫 번째 Cloud Shell 터미널 창에서 Ctrl+C를 입력합니다.

작업 3. Cloud Build로 애플리케이션 컨테이너화

Cloud Build는 Google Cloud에서 빌드를 실행하는 서비스입니다. Cloud Build를 사용하면 지속적 통합 및 배포(CI/CD) 파이프라인을 사용하여 애플리케이션을 지속적으로 빌드, 테스트, 배포할 수 있습니다.

Cloud Build에 지침을 제공하려면 일련의 작업이 포함된 빌드 구성 파일을 만들어야 합니다. 이러한 안내는 종속 항목을 가져오고, 단위 테스트 및 통합 테스트를 실행하고, 정적 분석을 수행하고, docker, gradle, maven 등의 빌드 도구로 아티팩트를 만들도록 빌드를 구성할 수 있습니다.

이 작업에서는 Cloud Build를 사용하여 애플리케이션의 Docker 컨테이너를 빌드하고 결과 컨테이너 이미지를 Artifact Registry의 저장소에 푸시합니다.

저장소 만들기

1. Google Cloud 콘솔 제목 표시줄의 검색 필드에 Artifact Registry를 입력하고 검색을 클릭한 다음 Artifact Registry를 클릭합니다.

2. Artifact Registry 옆에 있는 ( 고정)을 클릭합니다.

3. 저장소 만들기를 클릭합니다.

4. 저장소 만들기 페이지에서 다음 정보를 제공하고 나머지 설정은 기본값으로 둡니다.

   이름	my-repo
   형식	Docker
   위치 유형	리전
   리전

5. 만들기를 클릭하고 저장소가 생성될 때까지 기다립니다.

저장소를 사용하기 위해 Docker 인증

이미지를 저장소로 푸시하려면 먼저 Artifact Registry의 저장소에 대한 요청을 인증하도록 Docker를 구성해야 합니다.

1. 리전의 Docker 저장소에 인증을 설정하려면 Cloud Shell에서 다음 명령어를 실행합니다.

   gcloud auth configure-docker ${REGION}-docker.pkg.dev

2. 메시지가 표시되면 Y를 입력합니다.

빌드 구성 파일 만들기

Cloud Build에 지침을 제공하려면 일련의 작업이 포함된 빌드 구성 파일을 만들어야 합니다. 이러한 안내는 종속 항목을 가져오고, 단위 테스트와 통합 테스트를 실행하고, 정적 분석을 수행하고, docker, gradle, maven 등의 빌더로 아티팩트를 만들도록 빌드를 구성할 수 있습니다.

1. 저장소 이름의 환경 변수를 설정합니다.

   REPO=${REGION}-docker.pkg.dev/${PROJECT_ID}/my-repo

2. 빌드 구성 파일을 만듭니다.

   cat > cloudbuild.yaml <<EOF steps: - name: 'gcr.io/cloud-builders/docker' args: [ 'build', '-t', '${REPO}/sample-node-app-image', '.' ] images: - '${REPO}/sample-node-app-image' EOF

3. cloudbuild.yaml 파일을 봅니다.

   cat cloudbuild.yaml 빌드 단계는 현재 디렉터리에 있는 소스 코드와 Dockerfile에서 docker 빌더를 사용하여 컨테이너 이미지를 빌드합니다. 빌드된 이미지는 Artifact Registry의 저장소로 푸시됩니다.

컨테이너 빌드

1. Cloud Build로 컨테이너를 빌드하려면 다음 명령어를 실행합니다.

   gcloud builds submit --region=$REGION --config=cloudbuild.yaml

   다음은 명령어의 유사한 (부분) 출력입니다.

   ... ... b3389e626b47: Pushed 38610c0cfc18: Pushed latest: digest: sha256:b6007afa5e8fb05d8ac617ddf5fee8d58cc6ba8901038c97f8e360520c5fdbf4 size: 3051 DONE ---------------------------------------------------------------------------------------------------------------------------------------- ID: f803a828-dc50-41cb-bc94-71dfb8c83648 CREATE_TIME: 2023-02-28T18:28:41+00:00 DURATION: 1M23S SOURCE: gs://qwiklabs-gcp-02-26de4317fac8_cloudbuild/source/1677608919.352478-c157fa4ae8544b3dbba23b5f29145286.tgz IMAGES: asia-east1-docker.pkg.dev/qwiklabs-gcp-02-26de4317fac8/my-repo/sample-node-app-image (+1 more) STATUS: SUCCESS

   Cloud Build는 먼저 지정된 디렉터리에서 애플리케이션 소스 코드와 기타 파일을 Cloud Storage에 업로드합니다. 그런 다음 빌드 구성과 Dockerfile에 지정된 안내에 따라 애플리케이션이 포함된 컨테이너 이미지를 빌드하고, 지정된 이미지 이름으로 이미지를 태그하고, Artifact Registry의 저장소에 이미지를 푸시합니다.

빌드 기록 보기

1. Google Cloud 콘솔 제목 표시줄의 검색 필드에 Cloud Build를 입력하고 검색을 클릭한 다음 Cloud Build를 클릭합니다.

2. 리전에서 리전을 선택합니다.

3. 목록 상단에서 빌드의 빌드 ID를 클릭합니다.

   빌드 로그를 비롯한 빌드 세부정보가 표시됩니다.

Artifact Registry에서 컨테이너 이미지 보기

1. 빌드 명령어가 완료되면 Google Cloud 콘솔의 탐색 메뉴()에서 Artifact Registry > 저장소를 클릭합니다.

2. my-repo 저장소를 클릭하여 sample-node-app-image 컨테이너 이미지를 표시합니다.

목표를 확인하려면 내 진행 상황 확인하기를 클릭합니다. Cloud Build로 컨테이너 이미지를 빌드합니다.

작업 4. Cloud Run에 컨테이너 배포하기

컨테이너 이미지가 빌드되었으므로 이제 Cloud Run에 배포할 수 있습니다. Cloud Run에 배포하는 방법에는 두 가지가 있습니다.

• 관리형 Cloud Run: 전체 컨테이너 수명 주기가 Cloud Run에 의해 관리되는 완전 관리형 서비스 모델입니다. 이 실습에서는 이 접근 방식을 사용합니다.

• Anthos의 Cloud Run: 제어 계층이 추가된 Cloud Run으로, GKE에서 자체 클러스터와 포드를 가져올 수 있습니다.

이 작업에서는 컨테이너 이미지를 Google Cloud의 완전 관리형 Cloud Run 서비스에 배포합니다.

1. 컨테이너 이미지를 배포하려면 Cloud Shell에서 다음 명령어를 실행합니다.

   gcloud run deploy sample-node-app --image ${REPO}/sample-node-app-image --region $REGION --allow-unauthenticated allow-unauthenticated 옵션을 사용하면 인증 없이 서비스에 액세스할 수 있습니다.

2. 명령어가 완료되면 Google Cloud 콘솔의 탐색 메뉴()에서 Cloud Run을 클릭합니다.

3. Cloud Run 서비스의 세부정보를 표시하려면 sample-node-app 서비스 이름을 클릭합니다.

목표를 확인하려면 내 진행 상황 확인하기를 클릭합니다. 컨테이너 이미지를 Cloud Run에 배포합니다.

작업 5. Cloud Run에서 애플리케이션 테스트

1. 서비스가 실행 중이고 요청을 수락할 수 있는지 확인하려면 Cloud Shell에서 다음 명령어를 실행합니다.

   gcloud run services list

   이 명령어 출력은 다음과 비슷합니다.

   ✔ SERVICE: sample-node-app REGION: asia-east1 URL: https://sample-node-app-dduno3adrq-uc.a.run.app LAST DEPLOYED BY: student-04-329a97f025fd@qwiklabs.net LAST DEPLOYED AT: 2023-02-28T22:21:04.803928Z

2. 명령어 출력에서 URL 값을 복사하고 표시된 대로 URL 끝에 service/products를 추가하여 curl 명령어에 붙여넣습니다. 출력을 jq 명령어에 파이핑하고 Enter 키를 누릅니다.

   curl https://sample-node-app-dduno3adrq-uc.a.run.app/service/products | jq

   출력은 이전 작업에서 로컬로 실행했을 때 애플리케이션에서 받은 출력과 비슷해야 합니다.

목표를 확인하려면 내 진행 상황 확인하기를 클릭합니다. Cloud Run에 배포된 애플리케이션을 테스트합니다.

수고하셨습니다

이 실습에서 학습할 내용은 다음과 같습니다.

• Cloud Build를 사용하여 애플리케이션의 Docker 컨테이너 이미지를 만들고 컨테이너 이미지를 Cloud Run에 배포했습니다.
• 또한 애플리케이션을 로컬과 Cloud Run에서 테스트하여 예상대로 작동하는지 확인했습니다.

다음 단계/자세히 알아보기

자세한 내용은 다음 문서를 참고하세요.

• Cloud Build
• Cloud Run

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