Cloud Run을 사용하여 동적 콘텐츠 제공 및 마이크로서비스 호스팅

Cloud Run을 Firebase 호스팅과 페어링하면 동적 콘텐츠를 생성하여 제공하거나 REST API를 마이크로서비스로 빌드할 수 있습니다.

Cloud Run을 사용해 컨테이너 이미지로 패키징된 애플리케이션을 배포합니다. 그런 다음 Firebase 호스팅을 사용해 HTTPS 요청을 전달하면 컨테이너화된 앱을 트리거할 수 있습니다.

Cloud Run은 여러 언어(Go, Node.js, Python, 자바 등)를 지원하므로 원하는 프로그래밍 언어와 프레임워크를 자유롭게 사용할 수 있습니다.
Cloud Run은 수신된 요청을 처리하기 위해 컨테이너 이미지를 자동 및 수평 확장한 다음 수요가 감소하면 축소합니다.
요청 처리 도중 소비한 CPU, 메모리, 네트워킹에 대해서만 비용을 지불하면 됩니다.

Firebase 호스팅과 통합된 Cloud Run의 사용 사례 및 샘플은 Google의 서버리스 개요를 참조하세요.

이 가이드에서는 다음을 수행하는 방법을 설명합니다.

간단한 Hello World 애플리케이션 작성
앱을 컨테이너화하여 Container Registry에 업로드
컨테이너 이미지를 Cloud Run에 배포
컨테이너화된 앱으로 호스팅 요청 전달

제공하는 동적 콘텐츠의 성능을 높이기 위해 필요에 따라 캐시 설정을 조정할 수 있습니다.

시작하기 전에

Cloud Run을 사용하기 전에 Cloud Billing 계정 설정, Cloud Run API 사용 설정, gcloud 명령줄 도구 설치 등 몇 가지 초기 작업을 먼저 완료해야 합니다.

프로젝트에 대한 결제 설정

Cloud Run은 무료 사용 할당량을 제공하지만 Firebase 프로젝트와 연결된 Cloud Billing 계정이 있어야 Cloud Run을 사용해 볼 수 있습니다.

API 사용 설정 및 SDK 설치

다음 단계에 따라 Google API 콘솔에서 Cloud Run API를 사용 설정합니다.
1. Google API 콘솔에서 Cloud Run API 페이지를 엽니다.
2. 메시지가 나타나면 Firebase 프로젝트를 선택합니다.
3. Cloud Run API 페이지에서 사용 설정을 클릭합니다.
Cloud SDK를 설치하고 초기화합니다.
gcloud 도구가 올바른 프로젝트에 구성되었는지 확인합니다.
```
gcloud config list
```

1단계: 샘플 애플리케이션 작성

Cloud Run은 다음 샘플에 나와 있는 언어 외에도 많은 다른 언어를 지원합니다.

Go

helloworld-go라는 새 디렉터리를 만든 후 이 위치로 디렉터리를 변경합니다.
```
mkdir helloworld-go
```
```
cd helloworld-go
```

helloworld.go라는 새 파일을 만든 후 다음 코드를 추가합니다.

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func handler(w http.ResponseWriter, r *http.Request) {
	log.Print("helloworld: received a request")
	target := os.Getenv("TARGET")
	if target == "" {
		target = "World"
	}
	fmt.Fprintf(w, "Hello %s!\n", target)
}

func main() {
	log.Print("helloworld: starting server...")

	http.HandleFunc("/", handler)

	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}

	log.Printf("helloworld: listening on port %s", port)
	log.Fatal(http.ListenAndServe(fmt.Sprintf(":%s", port), nil))
}
helloworld.go

이 코드는 PORT 환경 변수로 정의한 포트를 리슨하는 기본 웹 서버를 생성합니다.

앱이 완성되었으며 컨테이너화되어 Container Registry에 업로드될 수 있습니다.

Node.js

helloworld-nodejs라는 새 디렉터리를 만든 후 이 위치로 디렉터리를 변경합니다.
```
mkdir helloworld-nodejs
```
```
cd helloworld-nodejs
```

다음 콘텐츠로 package.json이라는 파일을 만듭니다.

{
  "name": "knative-serving-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.18.2"
  }
}
package.json

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}!\n`);
});

const port = process.env.PORT || 8080;
app.listen(port, () => {
  console.log('Hello world listening on port', port);
});
index.js

이 코드는 PORT 환경 변수로 정의한 포트를 리슨하는 기본 웹 서버를 생성합니다.

앱이 완성되었으며 컨테이너화되어 Container Registry에 업로드될 수 있습니다.

Python

helloworld-python라는 새 디렉터리를 만든 후 이 위치로 디렉터리를 변경합니다.
```
mkdir helloworld-python
```
```
cd helloworld-python
```

app.py라는 새 파일을 만든 후 다음 코드를 추가합니다.

import os

from flask import Flask

app = Flask(__name__)

@app.route('/')
def hello_world():
    target = os.environ.get('TARGET', 'World')
    return 'Hello {}!\n'.format(target)

if __name__ == "__main__":
    app.run(debug=True,host='0.0.0.0',port=int(os.environ.get('PORT', 8080)))
app.py

이 코드는 PORT 환경 변수로 정의한 포트를 리슨하는 기본 웹 서버를 생성합니다.

앱이 완성되었으며 컨테이너화되어 Container Registry에 업로드될 수 있습니다.

자바

자바 SE 8 이상 JDK 및 CURL을 설치합니다.

다음 단계에서 새 웹 프로젝트를 만들려면 이 작업만 수행하면 됩니다. 나중에 설명하게 될 Dockerfile은 컨테이너에 모든 종속 항목을 로드합니다.
콘솔에서 cURL과 unzip 명령어를 차례로 사용하여 새로운 빈 웹 프로젝트를 만듭니다.
```
curl https://start.spring.io/starter.zip \
    -d dependencies=web \
    -d name=helloworld \
    -d artifactId=helloworld \
    -o helloworld.zip
```
```
unzip helloworld.zip
```
이렇게 하면 SpringBoot 프로젝트가 만들어집니다.

/ 매핑을 처리하기 위해 @RestController를 추가하여 src/main/java/com/example/helloworld/HelloworldApplication.java에서 SpringBootApplication 클래스를 업데이트하고 @Value 필드도 추가하여 TARGET 환경 변수를 제공합니다.

package com.example.helloworld;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
public class HelloworldApplication {

  @Value("${TARGET:World}")
  String target;

  @RestController
  class HelloworldController {
    @GetMapping("/")
    String hello() {
      return "Hello " + target + "!";
    }
  }

  public static void main(String[] args) {
    SpringApplication.run(HelloworldApplication.class, args);
  }
}
HelloworldApplication.java

이 코드는 PORT 환경 변수로 정의한 포트를 리슨하는 기본 웹 서버를 생성합니다.

앱이 완성되었으며 컨테이너화되어 Container Registry에 업로드될 수 있습니다.

2단계: 앱을 컨테이너화하여 Container Registry에 업로드

소스 파일과 동일한 디렉터리에 Dockerfile이라는 새 파일을 만들어 샘플 앱을 컨테이너화합니다. 다음 콘텐츠를 파일에 복사합니다.

Go

# Use the official Golang image to create a build artifact.
# This is based on Debian and sets the GOPATH to /go.
FROM golang:latest as builder

ARG TARGETOS
ARG TARGETARCH

# Create and change to the app directory.
WORKDIR /app

# Retrieve application dependencies using go modules.
# Allows container builds to reuse downloaded dependencies.
COPY go.* ./
RUN go mod download

# Copy local code to the container image.
COPY . ./

# Build the binary.
# -mod=readonly ensures immutable go.mod and go.sum in container builds.
RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} go build -mod=readonly -v -o server

# Use the official Alpine image for a lean production container.
# https://hub.docker.com/_/alpine
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM alpine:3
RUN apk add --no-cache ca-certificates

# Copy the binary to the production image from the builder stage.
COPY --from=builder /app/server /server

# Run the web service on container startup.
CMD ["/server"]
Dockerfile

Node.js

# 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

Python

# Use the official lightweight Python image.
# https://hub.docker.com/_/python
FROM python:3.7-slim

# Allow statements and log messages to immediately appear in the Knative logs
ENV PYTHONUNBUFFERED True

# Copy local code to the container image.
ENV APP_HOME /app
WORKDIR $APP_HOME
COPY . ./

# Install production dependencies.
RUN pip install Flask gunicorn

# Run the web service on container startup. Here we use the gunicorn
# webserver, with one worker process and 8 threads.
# For environments with multiple CPU cores, increase the number of workers
# to be equal to the cores available.
CMD exec gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 app:app
Dockerfile

자바

# Use the official maven/Java 8 image to create a build artifact: https://hub.docker.com/_/maven
FROM maven:3.5-jdk-8-alpine as builder

# Copy local code to the container image.
WORKDIR /app
COPY pom.xml .
COPY src ./src

# Build a release artifact.
RUN mvn package -DskipTests

# Use the Official OpenJDK image for a lean production stage of our multi-stage build.
# https://hub.docker.com/_/openjdk
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM openjdk:8-jre-alpine

# Copy the jar to the production image from the builder stage.
COPY --from=builder /app/target/helloworld-*.jar /helloworld.jar

# Run the web service on container startup.
CMD ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/helloworld.jar"]
Dockerfile

Dockerfile이 포함되어 있는 디렉터리에서 다음 명령어를 실행하여 Cloud Build로 컨테이너 이미지를 빌드합니다.
```
gcloud builds submit --tag gcr.io/PROJECT_ID/helloworld
```
성공하면 다음 이미지 이름이 포함된 성공 메시지가 표시됩니다.
(gcr.io/PROJECT_ID/helloworld)

이제 컨테이너 이미지가 Container Registry에 저장되고 원하는 경우 다시 사용할 수 있습니다.

Cloud Build 대신 로컬에 설치된 Docker 버전을 사용하여 로컬에서 컨테이너를 빌드할 수 있습니다.

3단계: Cloud Run에 컨테이너 이미지 배포

다음 명령어를 사용하여 배포합니다.

gcloud run deploy --image gcr.io/PROJECT_ID/helloworld

메시지가 표시되면 다음 단계를 수행합니다.
- 리전을 선택합니다(예: us-central1).
- 서비스 이름을 확인합니다(예: helloworld).
- Y로 응답하여 인증되지 않은 호출을 허용합니다.
중요: 나중에 firebase.json 재작성 규칙에서 region 및 serviceID를 각각 정의할 때 이 값을 사용할 수 있도록 리전 및 서비스 이름을 기억해 두세요.
배포가 완료될 때까지 잠시 기다립니다. 성공하면 명령줄에 서비스 URL이 표시됩니다. 예를 들면 다음과 같습니다. https://helloworld-RANDOM_HASH-us-central1.a.run.app
웹브라우저에서 서비스 URL을 열고 배포한 컨테이너로 이동합니다.

다음 단계에서는 Firebase가 호스팅하는 사이트에 동적 콘텐츠를 생성할 수 있도록 Firebase 호스팅 URL에서 이 컨테이너화된 앱에 액세스하는 방법을 설명합니다.

4단계: 컨테이너화된 앱으로 호스팅 요청 전달

재작성 규칙을 사용하면 특정 패턴과 일치하는 요청을 단일 대상으로 전달할 수 있습니다.

다음 예시에서는 호스팅 사이트의 /helloworld 페이지에서 보내는 모든 요청을 전달하여 helloworld 컨테이너 인스턴스의 시작 및 실행을 트리거하는 방법을 보여줍니다.

다음 사항을 확인하세요.
- 최신 버전의 Firebase CLI 보유 여부
- Firebase 호스팅 초기화 여부
CLI 설치 및 호스팅 초기화에 관한 자세한 내용은 호스팅 시작 가이드를 참조하세요.
firebase.json 파일을 엽니다.

hosting 섹션 아래에 다음 rewrite 구성을 추가합니다.

"hosting": {
  // ...

  // Add the "rewrites" attribute within "hosting"
  "rewrites": [ {
    "source": "/helloworld",
    "run": {
      "serviceId": "helloworld",  // "service name" (from when you deployed the container image)
      "region": "us-central1"     // optional (if omitted, default is us-central1)
      "pinTag": true              // optional (see note below)
    }
  } ]
}

프로젝트 디렉터리의 루트에서 다음 명령어를 실행하여 호스팅 구성을 사이트에 배포합니다.
```
firebase deploy --only hosting
```

run 블록 내에서 pinTag의 작동 방식

이 기능을 사용하면 사이트의 동적 콘텐츠를 생성하는 Cloud Run 서비스의 버전이 정적 호스팅 리소스 및 호스팅 구성과 동기화된 상태로 유지되도록 할 수 있습니다. 또한 이 기능을 사용하면 호스팅 미리보기 채널에서 Cloud Run에 재작성된 내용을 미리 볼 수 있습니다.

hosting.rewrites 구성의 run 블록에 "pingTag": true를 추가하면 정적 호스팅 리소스 및 구성이 배포 시 Cloud Run 서비스의 최신 버전에 고정됩니다. 사이트의 한 버전을 롤백하면 '고정된' Cloud Run 서비스의 버전도 롤백됩니다.

이 기능은 서비스당 태그 1,000개, 리전당 태그 2,000개로 제한되는 Cloud Run 태그를 사용합니다. 즉, 수백 번 배포한 후에는 가장 오래된 버전의 사이트가 작동을 멈출 수 있습니다.

이제 다음 URL을 통해 컨테이너에 연결할 수 있습니다.

Firebase 하위 도메인:
PROJECT_ID.web.app/ 및 PROJECT_ID.firebaseapp.com/
연결된 모든 커스텀 도메인:
CUSTOM_DOMAIN/

재작성 규칙에 대한 자세한 내용은 호스팅 구성 페이지를 참조하세요. 또한 다양한 호스팅 구성에 관한 응답 우선순위에 대해서도 알아볼 수 있습니다.

로컬에서 테스트

개발 단계에서는 컨테이너 이미지를 로컬에서 실행하고 테스트할 수 있습니다. 자세한 안내는 Cloud Run 문서를 참조하세요.

다음 단계

글로벌 CDN에서 동적 콘텐츠의 캐싱 설정
Firebase Admin SDK를 사용하여 다른 Firebase 서비스와 상호작용
컨테이너 설정, 관리, 구성에 대한 자세한 안내 가이드를 비롯하여 Cloud Run에 대해 자세히 알아보기
Cloud Run의 가격 책정과 할당량 및 한도 검토