Cloud Run으로 웹사이트 배포

가상 머신 (VM) 인스턴스, 클러스터, 포드, 서비스 등을 만들고 관리하는 데 드는 모든 오버헤드로 인해 웹사이트를 실행하기가 어려울 수 있습니다. 대규모 다층 앱에는 문제가 없지만 웹사이트를 배포하고 눈에 띄게 만들고자 한다면 많은 오버헤드입니다.

Knative의 Google Cloud 구현인 Cloud Run을 사용하면 VM 또는 Kubernetes 기반 배포에 필요한 오버헤드 없이 웹사이트를 관리하고 배포할 수 있습니다. 이는 관리 관점에서 보면 더 간단한 접근 방식일 뿐만 아니라 웹사이트에 들어오는 요청이 없을 때 0으로 축소할 수 있는 기능도 제공합니다.

Cloud Run은 서버리스 개발을 컨테이너에 제공할 뿐만 아니라 자체 Google Kubernetes Engine (GKE) 클러스터에서 실행하거나 Cloud Run에서 제공하는 완전 관리형 플랫폼 (PaaS) 솔루션에서 실행할 수도 있습니다. 이 Codelab에서 후자의 시나리오를 테스트합니다.

다음 다이어그램은 배포 및 Cloud Run 호스팅의 흐름을 보여줍니다. Cloud Shell에서 트리거하는 Cloud Build를 통해 생성된 Docker 이미지로 시작합니다. 그런 다음 Cloud Shell의 명령어로 Cloud Run에 이미지를 배포합니다.

기본 요건

학습할 내용

  • Cloud Build로 Docker 이미지를 빌드하고 gcr.io에 업로드하는 방법
  • Cloud Run에 Docker 이미지를 배포하는 방법
  • Cloud Run 배포 관리 방법
  • Cloud Run에서 앱의 엔드포인트를 설정하는 방법

빌드할 항목

  • Docker 컨테이너 내에서 실행되는 정적 웹사이트
  • 이 컨테이너의 버전은 Container Registry에 있습니다.
  • 정적 웹사이트용 Cloud Run 배포

필요한 항목

  • 프로젝트를 만들 수 있는 관리 액세스 권한이 있는 Google 계정 또는 프로젝트 소유자 역할이 있는 프로젝트

자습형 환경 설정

아직 Google 계정이 없다면 계정을 만들어야 합니다. 그런 다음 Google Cloud Console에 로그인하고 프로젝트 및 프로젝트 만들기를 클릭합니다.

프로젝트 ID는 프로젝트 이름 아래에 자동으로 채워져 있습니다. 프로젝트 ID는 모든 Google Cloud 프로젝트에서 고유한 이름이므로 스크린샷에 사용된 이름은 이미 사용 중이며 사용할 수 없습니다. 이 이름은 나중에 PROJECT_ID라고 합니다.

그런 다음 Cloud Console에서 결제를 사용 설정하여 Google Cloud 리소스를 사용하고 Cloud Run API를 사용 설정해야 합니다.

Cloud Run API 사용 설정

탐색 메뉴 ☰ > API 및 AMP 서비스 > 대시보드> API 및 서비스 사용 설정을 클릭합니다. .

'Cloud Run API'를 검색한 다음 Cloud Run API를 클릭하고 사용 설정을 클릭합니다.

이 Codelab을 통해 실행하는 비용은 $29를 넘지 않지만 더 많은 리소스를 사용하기로 결정하거나 계속 실행하는 경우 비용이 더 많이 들 수 있습니다 (마지막에 정리 참고). 자세한 내용은 가격 책정을 참조하세요.

Google Cloud 신규 사용자는 $300 무료 체험판을 사용할 수 있습니다.

Cloud Shell

노트북에서 Cloud Run을 원격으로 운영할 수 있지만 Google Cloud에서 실행되는 명령줄 환경인 Cloud Shell을 사용할 예정이므로 환경은 필요한 모든 클라이언트 라이브러리와 프레임워크로 미리 구성되어 있습니다.

이 Debian 기반 가상 머신에는 필요한 모든 개발 도구가 로드되어 있습니다. 영구적인 5GB 홈 디렉토리를 제공하고 Google Cloud에서 실행되므로 네트워크 성능과 인증이 크게 개선됩니다. 즉, 이 Codelab에 필요한 것은 브라우저뿐입니다(Chromebook에서도 작동 가능).

Google Cloud Shell을 활성화하려면 개발자 콘솔에서 오른쪽 상단의 버튼을 클릭하면 됩니다. 환경을 프로비저닝하고 연결하는 데는 몇 분 정도만 소요됩니다.

activateCloudShell.png

'Cloud Shell 시작' 버튼을 클릭합니다.

Screen Shot 2017-06-14 at 10.13.43 PM.png

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를 확인하거나 콘솔 대시보드에서 찾아보세요.

프로젝트 ID

중요: 마지막으로 기본 영역 및 프로젝트 구성을 설정합니다.

gcloud config set compute/zone us-central1-f

다양한 영역을 선택할 수 있습니다. 리전 및 영역 영역 문서에서 자세히 알아보세요.

기존 웹사이트를 다시 배포하고 있으므로 저장소에서 소스를 클론하기만 하면 Docker 이미지를 만들고 Cloud Run에 배포할 수 있습니다.

다음 명령어를 실행하여 Cloud Shell 인스턴스로 저장소를 클론하고 적절한 디렉터리로 변경합니다. 또한 배포 전에 앱을 테스트할 수 있도록 Node.js 종속 항목을 설치합니다.

cd ~
git clone https://github.com/googlecodelabs/monolith-to-microservices.git
cd ~/monolith-to-microservices
./setup.sh

저장소를 클론하고 디렉터리로 변경하며 앱을 로컬에서 실행하는 데 필요한 종속 항목을 설치합니다. 스크립트를 실행하는 데 몇 분 정도 걸릴 수 있습니다.

실사를 실시하고 앱을 테스트하세요. 다음 명령어를 실행하여 웹 서버를 시작하세요.

cd ~/monolith-to-microservices/monolith
npm start

출력:

Monolith listening on port 8080!

웹 미리보기 를 클릭하고 포트 8080에서 미리보기를 선택하여 앱을 미리 볼 수 있습니다.

그러면 팬시 스토어가 작동하는 모습을 볼 수 있는 새 창이 열립니다.

웹사이트를 본 후 이 창을 닫아도 됩니다. 웹 서버 프로세스를 중지하려면 터미널 창에서 CONTROL+C(Macintosh의 경우 Command+C)을 누릅니다.

이제 소스 파일을 사용할 준비가 되었으므로 앱을 Docker화할 차례입니다.

일반적으로 Docker 컨테이너를 빌드하고 GKE로 가져올 이미지를 저장하기 위해 레지스트리로 푸시하는 2단계 접근 방식을 사용해야 합니다. 하지만 Cloud Build를 사용하면 Docker 컨테이너를 빌드하고 Container Registry에 단일 명령어로 이미지를 배치함으로써 작업을 더 쉽게 수행할 수 있습니다. Dockerfile을 만들어 푸시하는 수동 프로세스를 보려면 Container Registry 빠른 시작을 참조하세요.

Cloud Build는 디렉터리의 파일을 압축하여 Cloud Storage 버킷으로 이동합니다. 빌드 프로세스는 버킷의 모든 파일을 가져와서 Docker 빌드 프로세스를 실행하는 데 동일한 디렉터리에 있는 Dockerfile을 사용합니다. Docker 이미지에 대해 호스트를 gcr.io로 지정하여 --tag 플래그를 지정했다면 결과 Docker 이미지가 Container Registry로 푸시됩니다.

먼저 Cloud Build API를 사용 설정해야 합니다. 다음 명령어를 실행하여 사용 설정합니다.

gcloud services enable cloudbuild.googleapis.com

API를 사용 설정한 후 Cloud Shell에서 다음 명령어를 실행하여 빌드 프로세스를 시작합니다.

gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 .

이 프로세스는 몇 분 정도 소요되지만 완료되면 터미널에 다음과 유사한 출력이 표시됩니다.

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
ID                                    CREATE_TIME                DURATION  SOURCE                                                                                  IMAGES                              STATUS
1ae295d9-63cb-482c-959b-bc52e9644d53  2019-08-29T01:56:35+00:00  33S       gs://<PROJECT_ID>_cloudbuild/source/1567043793.94-abfd382011724422bf49af1558b894aa.tgz  gcr.io/<PROJECT_ID>/monolith:1.0.0  SUCCESS

빌드 기록을 보거나 프로세스를 실시간으로 보려면 Cloud Console로 이동한 다음 탐색 메뉴 ☰ > Cloud Build > 기록을 클릭합니다. 이전 빌드의 목록만 볼 수 있지만 생성한 빌드만 표시됩니다.

빌드 ID를 클릭하면 로그 출력을 포함해 해당 빌드에 관한 모든 세부정보를 볼 수 있습니다. 이미지 옆의 링크를 클릭하여 생성된 컨테이너 이미지를 볼 수 있습니다.

웹사이트를 컨테이너화하여 Container Registry로 푸시했으므로 이제 Cloud Run에 배포할 차례입니다.

Cloud Run에 배포하는 방법에는 두 가지가 있습니다.

  • Cloud Run (완전 관리형)은 전체 컨테이너 수명 주기가 관리되는 PaaS 모델입니다. 이 Codelab에서는 이 접근 방식을 사용합니다.
  • Cloud Run for Anthos는 GKE에서 클러스터와 포드를 가져올 수 있는 추가 제어 레이어를 갖춘 Cloud Run입니다. 자세한 내용은 Cloud Run for Anthos on Google Cloud 설정을 참조하세요.

명령줄 예제는 이전에 설정한 환경 변수를 사용하여 Cloud Shell에 있습니다.

명령줄

다음 명령어를 실행하여 앱을 배포합니다.

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed

어떤 리전을 실행할 것인지 묻는 메시지가 표시됩니다. 가장 가까운 리전을 선택한 다음 기본 추천 서비스 이름 (모놀리식)을 수락합니다.

테스트를 위해 인증되지 않은 요청을 앱에 허용합니다. 프롬프트에 y을 입력합니다.

배포 확인

배포가 성공적으로 생성되었는지 확인하려면 다음 명령어를 실행합니다. Pod status이 Running이 되기까지 몇 분 정도 걸릴 수 있습니다.

gcloud run services list

[1] Cloud Run (완전 관리형)을 선택합니다.

출력:

SERVICE   REGION    URL  LAST DEPLOYED BY          LAST DEPLOYED AT
✔  monolith  us-east1 <your url>  <your email>  2019-09-16T21:07:38.267Z

출력에 몇 가지 항목이 표시됩니다. 배포, 이메일 배포 사용자, 앱에 액세스할 때 사용할 수 있는 URL을 확인할 수 있습니다. 모든 것이 성공적으로 만들어진 것 같습니다.

웹브라우저의 서비스 목록에 제공된 URL을 열면 로컬에서 미리 본 것과 동일한 웹사이트가 표시됩니다.

이제 앱을 다시 배포하지만 이번에는 매개변수 중 하나를 조정합니다.

기본적으로 Cloud Run 앱의 동시 실행 값은 80이며, 각 컨테이너 인스턴스는 한 번에 최대 80개의 요청을 제공합니다. 즉, 인스턴스당 한 개의 요청을 처리하는 서비스로서의 함수 (FaaS) 모델이 크게 벗어나게 됩니다.

동시 실행 값이 1인 동일한 컨테이너 이미지를 다시 배포하고 (테스트용으로만) 다시 살펴봅니다. 

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 1

처음에 했던 것처럼 다음 질문에 답합니다. 명령어가 성공하면 Cloud Console에서 결과를 확인합니다.

Cloud Run 대시보드에서 모놀리식 서비스를 클릭하여 세부정보를 확인합니다.

버전 탭을 클릭합니다. 생성된 버전 2개가 표시됩니다. monolith-00002를 클릭하고 세부정보를 검토합니다. 동시 실행 값이 1로 감소하는 것을 확인할 수 있습니다.

]

이 구성으로 충분히 테스트할 수 있지만 대부분의 프로덕션 시나리오에서는 여러 개의 동시 요청을 지원하는 컨테이너가 있습니다.

이제 재배포하지 않고 원래 동시 실행을 복원합니다. 동시 실행 값을 기본값 80이나 0으로 설정하면 동시 실행 제한이 모두 삭제되고 기본값인 80으로 설정됩니다 (이 블로그를 작성하는 시점에 80이 됨).

Cloud Shell에서 다음 명령어를 실행하여 현재 버전을 업데이트합니다.

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --platform managed --concurrency 80

다른 버전이 생성되어 트래픽이 리디렉션되었으며 동시 실행이 80으로 돌아갑니다.

마케팅팀에서 회사 웹사이트의 홈페이지 변경을 요청했습니다. 회사가 무엇을 판매하는지, 판매하는 것이 무엇인지에 대해 더욱 많은 정보를 제공할 것이라고 생각합니다. 이 섹션에서는 마케팅팀의 만족도를 높이기 위해 홈페이지에 텍스트를 추가합니다.

개발자 중 한 명이 이미 파일 이름을 index.js.new(으)로 변경한 것으로 보입니다. 해당 파일을 index.js에 복사하기만 하면 변경사항이 반영됩니다. 안내에 따라 적절하게 변경합니다.

다음 명령어를 실행하고 업데이트된 파일을 올바른 파일 이름으로 복사한 다음 콘텐츠를 인쇄하여 변경사항을 확인합니다.

cd ~/monolith-to-microservices/react-app/src/pages/Home
mv index.js.new index.js
cat ~/monolith-to-microservices/react-app/src/pages/Home/index.js

결과 코드는 다음과 같습니다.

/*
Copyright 2019 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

import React from "react";
import { makeStyles } from "@material-ui/core/styles";
import Paper from "@material-ui/core/Paper";
import Typography from "@material-ui/core/Typography";
const useStyles = makeStyles(theme => ({
  root: {
    flexGrow: 1
  },
  paper: {
    width: "800px",
    margin: "0 auto",
    padding: theme.spacing(3, 2)
  }
}));
export default function Home() {
  const classes = useStyles();
  return (
    <div className={classes.root}>
      <Paper className={classes.paper}>
        <Typography variant="h5">
          Fancy Fashion &amp; Style Online
        </Typography>
        <br />
        <Typography variant="body1">
          Tired of mainstream fashion ideas, popular trends and societal norms?
          This line of lifestyle products will help you catch up with the Fancy trend and express your personal style.
          Start shopping Fancy items now!
        </Typography>
      </Paper>
    </div>
  );
}

React 구성요소를 업데이트했지만 React 앱을 빌드하여 정적 파일을 생성해야 합니다. 다음 명령어를 실행하여 React 앱을 빌드하고 모놀리식 공개 디렉터리에 복사합니다.

cd ~/monolith-to-microservices/react-app
npm run build:monolith

이제 코드가 업데이트되었으므로 Docker 컨테이너를 다시 빌드하고 Container Registry에 게시해야 합니다. 이전과 동일한 명령어를 사용할 수 있습니다. 단, 이번에는 버전 라벨을 업데이트합니다.

다음 명령어를 실행하여 업데이트된 이미지 버전 2.0.0의 새 Cloud Build를 트리거합니다.

cd ~/monolith-to-microservices/monolith

#Feel free to test your application
npm start

gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 .

다음 섹션에서는 이 이미지를 사용해 다운타임 없이 앱을 업데이트합니다.

변경이 완료되었으며 마케팅팀에서 업데이트에 만족합니다. 사용자를 방해하지 않고 웹사이트를 업데이트할 때입니다.

Cloud Run은 각 배포를 새 버전으로 처리하여 온라인 상태로 전환한 후 트래픽을 리디렉션합니다.

다음 안내를 따라 웹사이트를 업데이트합니다.

명령줄

다음 서비스를 사용하여 이미지를 새 버전으로 업데이트하는 서비스를 명령줄에서 다시 배포할 수 있습니다.

gcloud run deploy --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --platform managed

배포 확인

다음 명령어를 실행하여 배포 업데이트의 유효성을 검사합니다.

gcloud run services describe monolith --platform managed

출력 형식은 다음과 같습니다.

apiVersion: serving.knative.dev/v1alpha1
kind: Service
metadata:
  annotations:
    client.knative.dev/user-image: gcr.io/my-cloudrun-codelab/monolith:2.0.0
...

이제 서비스가 새 버전에 배포된 최신 버전의 이미지를 사용하고 있는 것을 확인할 수 있습니다.

변경사항을 확인하려면 Cloud Run 서비스의 외부 URL로 다시 이동하여 앱 제목이 업데이트되었는지 확인합니다.

다음 명령어를 실행하여 서비스를 나열하고 IP 주소를 잊어버린 경우 IP 주소를 확인합니다.

gcloud run services list

이제 홈페이지 구성요소에 추가한 텍스트가 웹사이트에 표시됩니다.

Container Registry 이미지 삭제하기

# Delete the container image for version 1.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:1.0.0 --quiet

# Delete the container image for version 2.0.0 of our monolith
gcloud container images delete gcr.io/${GOOGLE_CLOUD_PROJECT}/monolith:2.0.0 --quiet

Cloud Storage에서 Cloud Build 아티팩트 삭제

# The following command will take all source archives from all builds and delete them from cloud storage

# Run this command to print all sources:
# gcloud builds list | awk 'NR > 1 {print $4}' 

gcloud builds list | awk 'NR > 1 {print $4}' | while read line; do gsutil rm $line; done

Cloud Run 서비스 삭제

gcloud run services delete monolith --platform managed

Cloud Run을 통해 웹사이트를 배포, 확장, 업데이트했습니다.

자세히 알아보기