Cloud Run ile dinamik içerikler sunun ve mikro hizmetler barındırın

Dinamik içeriğinizi oluşturmak ve yayınlamak için Cloud Run'ı Firebase Hosting ile eşleştirin veya mikro hizmet olarak REST API'ler oluşturun.

Cloud Run'ı kullanarak, container görüntüsünde paketlenmiş bir uygulamayı dağıtabilirsiniz. Ardından Firebase Hosting'i kullanarak HTTPS isteklerini, container mimarisine alınmış uygulamanızı tetiklemeleri için yönlendirebilirsiniz.

  • Cloud Run, birkaç dili (Go, Node.js, Python ve Java dahil) destekler. Böylece, istediğiniz programlama dilini ve çerçeveyi kullanma esnekliğine sahip olursunuz.
  • Cloud Run, alınan istekleri işlemek için container görüntünüzü otomatik ve yatay olarak ölçeklendirir ve talep azaldıkça ölçeği düşürür.
  • Yalnızca isteklerin işlenmesi sırasında harcanan CPU, bellek ve ağ iletişimi için ödeme yaparsınız.

Firebase Hosting ile entegre Cloud Run için kullanım alanları ve örnekler için sunucusuz genel bakış sayfamızı ziyaret edin.


Bu kılavuzda aşağıdaki işlemleri nasıl yapacağınız gösterilmektedir:

  1. Basit bir Hello World uygulaması yazma
  2. Bir uygulamayı container mimarisine alma ve Container Registry'ye yükleme
  3. Container görüntüsünü Cloud Run'a dağıtma
  4. Container mimarisine alınmış uygulamanıza doğrudan barındırma istekleri

Dinamik içerik sunma performansını iyileştirmek için isteğe bağlı olarak önbellek ayarlarınızı ayarlayabileceğinizi unutmayın.

Başlamadan önce

Cloud Run'ı kullanmadan önce Cloud Billing hesabı oluşturma, Cloud Run API'yi etkinleştirme ve gcloud komut satırı aracını yükleme gibi bazı başlangıç görevlerini tamamlamanız gerekir.

Projeniz için faturalandırma ayarlarını yapın

Cloud Run ücretsiz kullanım kotası sunar ancak Cloud Run'ı kullanmak veya denemek için yine de Firebase projenizle ilişkilendirilmiş bir Cloud Billing hesabınızın olması gerekir.

API'yi etkinleştirin ve SDK'yı yükleyin

  1. Google API'leri konsolunda Cloud Run API'yi etkinleştirin:

    1. Google API'leri konsolunda Cloud Run API sayfasını açın.

    2. İstendiğinde Firebase projenizi seçin.

    3. Cloud Run API sayfasında Etkinleştir'i tıklayın.

  2. Google Cloud SDK'yı yükleyip başlatın.

  3. gcloud aracının doğru proje için yapılandırıldığından emin olun:

    gcloud config list

1. Adım: Örnek uygulamayı yazın

Cloud Run'ın aşağıdaki örnekte gösterilen dillerin yanı sıra birçok başka dili de desteklediğini unutmayın.

Go

  1. helloworld-go adlı yeni bir dizin oluşturun ve ardından dizini bu dizinle değiştirin:

    mkdir helloworld-go
    cd helloworld-go

  2. helloworld.go adlı yeni bir dosya oluşturun ve sonra aşağıdaki kodu ekleyin:

    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

    Bu kod, PORT ortam değişkeni tarafından tanımlanan bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur.

Uygulamanız tamamlandı, container mimarisine alınmaya ve Container Registry'ye yüklenmeye hazır.

Node.js

  1. helloworld-nodejs adlı yeni bir dizin oluşturun ve ardından bu dizini değiştirin:

    mkdir helloworld-nodejs
    cd helloworld-nodejs

  2. Aşağıdaki içeriklerle bir package.json dosyası oluşturun:

    {
  "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.19.2"
  }
}

    package.json

  3. index.js adlı yeni bir dosya oluşturun ve sonra aşağıdaki kodu ekleyin:

    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

    Bu kod, PORT ortam değişkeni tarafından tanımlanan bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur.

Uygulamanız tamamlandı, container mimarisine alınmaya ve Container Registry'ye yüklenmeye hazır.

Python

  1. helloworld-python adlı yeni bir dizin oluşturun ve ardından bu dizini değiştirin:

    mkdir helloworld-python
    cd helloworld-python

  2. app.py adlı yeni bir dosya oluşturun ve sonra aşağıdaki kodu ekleyin:

    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

    Bu kod, PORT ortam değişkeni tarafından tanımlanan bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur.

Uygulamanız tamamlandı, container mimarisine alınmaya ve Container Registry'ye yüklenmeye hazır.

Java

  1. Java SE 8 veya üzeri JDK'yı ve CURL'yi yükleyin.

    Bunu yalnızca bir sonraki adımda yeni web projesini oluşturmak için yapmamız gerektiğini unutmayın. Daha sonra açıklanacak olan Dockerfile, tüm bağımlılıkları container'a yükler.

  2. Konsoldan cURL'yi kullanarak yeni bir boş web projesi oluşturun, ardından sıkıştırma komutlarını açın:

    curl https://start.spring.io/starter.zip \
    -d dependencies=web \
    -d name=helloworld \
    -d artifactId=helloworld \
    -o helloworld.zip
    unzip helloworld.zip

    Bu işlem bir SpringBoot projesi oluşturur.

  3. / eşlemesini işlemek için @RestController ve TARGET ortam değişkenini sağlamak üzere @Value alanı ekleyerek src/main/java/com/example/helloworld/HelloworldApplication.java içinde SpringBootApplication sınıfını güncelleyin:

    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

    Bu kod, PORT ortam değişkeni tarafından tanımlanan bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur.

Uygulamanız tamamlandı, container mimarisine alınmaya ve Container Registry'ye yüklenmeye hazır.

2. Adım: Bir uygulamayı container mimarisine alın ve Container Registry'ye yükleyin

  1. Kaynak dosyalarla aynı dizinde Dockerfile adlı yeni bir dosya oluşturarak örnek uygulamayı container mimarisine alın. Aşağıdaki içeriği dosyanıza kopyalayın.

    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

    Java

    # 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

  2. Dockerfile'ınızı içeren dizinden aşağıdaki komutu çalıştırarak Cloud Build'i kullanarak container görüntünüzü derleyin:

    gcloud builds submit --tag gcr.io/PROJECT_ID/helloworld

    İşlem başarılı olduğunda resim adını içeren bir BAŞARILI mesajı görürsünüz
    (gcr.io/PROJECT_ID/helloworld).

Container görüntüsü artık Container Registry'de depolanmaktadır ve istendiğinde yeniden kullanılabilir.

Container'ınızı yerel olarak oluşturmak için Cloud Build yerine Docker'ın yerel olarak yüklenmiş sürümünü kullanabileceğinizi unutmayın.

3. Adım: Container görüntüsünü Cloud Run'a dağıtın

  1. Aşağıdaki komutu kullanarak dağıtın:

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

  2. İstendiğinde:

En iyi performansı elde etmek için aşağıdaki bölgeleri kullanarak Cloud Run hizmetinizi Hosting ile ortak kullanın:

  • us-west1
  • us-central1
  • us-east1
  • europe-west1
  • asia-east1

Hosting'den Cloud Run'a yapılan yeniden yazma işlemleri aşağıdaki bölgelerde desteklenir:

  • asia-east1
  • asia-east2
  • asia-northeast1
  • asia-northeast2
  • asia-northeast3
  • asia-south1
  • asia-south2
  • asia-southeast1
  • asia-southeast2
  • australia-southeast1
  • australia-southeast2
  • europe-central2
  • europe-north1
  • europe-southwest1
  • europe-west1
  • europe-west12
  • europe-west2
  • europe-west3
  • europe-west4
  • europe-west6
  • europe-west8
  • europe-west9
  • me-central1
  • me-west1
  • northamerica-northeast1
  • northamerica-northeast2
  • southamerica-east1
  • southamerica-west1
  • us-central1
  • us-east1
  • us-east4
  • us-east5
  • us-south1
  • us-west1
  • us-west2
  • us-west3
  • us-west4
  • us-west1
  • us-central1
  • us-east1
  • europe-west1
  • asia-east1

  1. Dağıtımın tamamlanması için birkaç dakika bekleyin. Başarılı olduğunda, komut satırında hizmet URL'si görüntülenir. Örneğin: https://helloworld-RANDOM_HASH-us-central1.a.run.app

  2. Hizmet URL'sini bir web tarayıcısında açarak dağıtılmış kapsayıcınızı ziyaret edin.

Bir sonraki adımda, Firebase tarafından barındırılan siteniz için dinamik içerik oluşturabilmesi amacıyla bu container mimarisine alınmış uygulamaya bir Firebase Hosting URL'sinden nasıl erişeceğiniz açıklanmaktadır.

4. Adım: Barındırma isteklerini container mimarisine alınmış uygulamanıza yönlendirin

Yeniden yazma kuralları sayesinde, belirli kalıplarla eşleşen istekleri tek bir hedefe yönlendirebilirsiniz.

Aşağıdaki örnekte, helloworld kapsayıcı örneğinizin başlatılmasını ve çalıştırılmasını tetiklemek için Hosting sitenizdeki /helloworld sayfasından gelen tüm isteklerin nasıl yönlendirileceği gösterilmektedir.

  1. Aşağıdaki koşulların karşılandığından emin olun:

    CLI yükleme ve Barındırma'yı başlatma hakkında ayrıntılı talimatlar için Hosting için Başlangıç Kılavuzu'na bakın.

  2. firebase.json dosyanızı açın.

  3. hosting bölümü altına aşağıdaki rewrite yapılandırmasını ekleyin:

    "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)
    }
  } ]
}

  4. Proje dizininizin kök dizininden aşağıdaki komutu çalıştırarak barındırma yapılandırmanızı sitenize dağıtın:

    firebase deploy --only hosting

Kapsayıcınıza artık aşağıdaki URL'ler üzerinden erişilebilir:

  • Firebase alt alanlarınız:
    PROJECT_ID.web.app/ ve PROJECT_ID.firebaseapp.com/

  • Bağlı özel alanlar:
    CUSTOM_DOMAIN/

Yeniden yazma kuralları hakkında daha fazla bilgi için Hosting yapılandırma sayfasını ziyaret edin. Çeşitli Hosting yapılandırmaları için yanıtların öncelik sırası hakkında da bilgi edinebilirsiniz.

Yerel olarak test et

Geliştirme sırasında container görüntünüzü yerel olarak çalıştırıp test edebilirsiniz. Ayrıntılı talimatlar için Cloud Run belgelerini inceleyin.

Sonraki adımlar