Cloud Run ile dinamik içerik sunma ve mikro hizmetler barındırma

Cloud Run ile Firebase Hosting'i eşleyerek kendi isteklerinizi oluşturup sunun veya REST API'lerini mikro hizmet olarak oluşturun.

Cloud Run'ı kullanarak şunları yapabilirsiniz: container görüntüsünde paketlenmiş bir uygulama dağıtma Daha sonra Firebase Hosting'i kullanıyorsanız, HTTPS isteklerini yönlendirmek için container mimarisine alınmış bir uygulamadır.

  • Cloud Run destekler çeşitli dillerde (Go, Node.js, Python ve Java dahil) size çok yönlü programlama dilini ve çerçevesini seçin.
  • Cloud Run otomatik ve yatay olarak ölçeklendirilir gelen istekleri işlemek için container görüntünüzü kullanabilir, daha sonra düştüğünü görebilirsiniz.
  • Yalnızca CPU için ödeme yaparsınız. bellek ve istek işleme sırasında tüketilen ağ miktarı.

Örnek: Cloud Run'ın entegre olduğu kullanım alanları ve örnekler Firebase Hosting hakkında bilgi için sunucusuz genel bakış.


. Bu kılavuzda aşağıdakilerin nasıl yapılacağı 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 Hosting istekleri

Dinamik içerik sunma performansını iyileştirmek için şunları yapabilirsiniz: İsterseniz önbellek ayarlarınızı düzenleyebilirsiniz.

Başlamadan önce

Cloud Run'ı kullanmadan önce bazı başlangıç görevlerini tamamlamanız gerekir. Cloud Run'ın etkinleştirilmesi dahil olmak üzere Cloud Faturalandırma hesabı oluşturma API'ye gidip gcloud komut satırı aracını yükleyin.

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

Cloud Run ücretsiz kullanım kotası sunar. Ancak yine de Cloud Faturalandırma hesabı Firebase projenizle ilişkilendirin.

ziyaret edin.

API'yi etkinleştirme ve SDK'yı yükleme

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

    1. Şunu açın: Cloud Run API sayfası yapılandırmalısınız.

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

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

  2. Yükleyin ve başlatın. Google Cloud SDK.

  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 şunları desteklediğini unutmayın: birçok dilde şu örnekte gösterilen dillere ek olarak.

Go

  1. helloworld-go adında yeni bir dizin oluşturun, ardından dizini şu şekilde değiştirin: şunları sağlar:

    mkdir helloworld-go
    cd helloworld-go

  2. helloworld.go adında yeni bir dosya oluşturun, ardından 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, API'nin tanımladığı bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur PORT ortam değişkeni

Uygulamanız tamamlandı ve container mimarisine alınmaya ve şuralara yüklenmeye hazır: Container Registry.

Node.js

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

    mkdir helloworld-nodejs
    cd helloworld-nodejs

  2. Aşağıdaki içeriklere sahip 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 adında yeni bir dosya oluşturun, ardından 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, API'nin tanımladığı bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur PORT ortam değişkeni

Uygulamanız tamamlandı ve container mimarisine alınmaya ve şuralara yüklenmeye hazır: Container Registry.

Python

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

    mkdir helloworld-python
    cd helloworld-python

  2. app.py adında yeni bir dosya oluşturun, ardından 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, API'nin tanımladığı bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur PORT ortam değişkeni

Uygulamanız tamamlandı ve container mimarisine alınmaya ve şuralara yüklenmeye hazır: Container Registry.

Java

  1. Yükle Java SE 8 veya sonraki bir JDK ve CURL.

    Bunu yalnızca şurada yeni web projesini oluşturmak için yapmamız gerektiğini unutmayın: bir sonraki adıma geçebiliriz. Daha sonra açıklanacak olan Dockerfile, container'a yansıtmanıza yardımcı olur.

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

    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. SpringBootApplication sınıfını güncelle src/main/java/com/example/helloworld/HelloworldApplication.java tarafından / eşlemesini işlemek için bir @RestController ekleyerek ve aynı zamanda bir TARGET ortam değişkenini sağlamak için @Value alanı:

    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, API'nin tanımladığı bağlantı noktasında dinleme yapan temel bir web sunucusu oluşturur PORT ortam değişkeni

Uygulamanız tamamlandı ve container mimarisine alınmaya ve şuralara yüklenmeye hazır: Container Registry.

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

  1. Şurada Dockerfile adlı yeni bir dosya oluşturarak örnek uygulamayı container mimarisine alın: kaynak dosyalarla aynı dizine sahip olur. Aşağıdaki içeriği kopyalayıp dosyası olarak kaydedebilirsiniz.

    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. Aşağıdaki komutu çalıştırarak Cloud Build kullanarak container görüntünüzü derleyin. komutunu çalıştırın:

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

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

Container görüntüsü artık Container Registry'de saklanıyor ve aşağıdaki durumlarda yeniden kullanılabilir: gerekir.

Cloud Build yerine yerel olarak yüklenmiş bir sürümü kullanabileceğinizi unutmayın için Docker'ı kapsayıcınızı yerel olarak derleyin.

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

  1. Şu komutu kullanarak dağıtın:

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

  2. İstendiğinde:

    ziyaret edin.

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

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

Hosting'den Cloud Run'a yeniden yazma işlemleri şu bölgelerde:

  • 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ı olursa, komut satırı hizmet URL'sini görüntüler. Örnek: 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.

Sonraki adımda, container mimarisine alınmış bu uygulamaya bir Firebase Barındırma URL'si Firebase tarafından barındırılan site.

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

Entegre yeniden yazma kurallarını kullanıyorsanız istekleri belirli kalıplar tek bir hedefle eşleştiren

Aşağıdaki örnekte, sayfadan gelen tüm isteklerin nasıl yönlendirileceği gösterilmektedir /helloworld başlatılmasını ve çalıştırılmasını tetiklemek için helloworld container örneğiniz.

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

    KSA'yı yükleme ve başlatma hakkında ayrıntılı talimatlar için Barındırma bilgileri Barındırma Başlangıç Kılavuzu.

  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. Aşağıdaki kodu çalıştırarak barındırma yapılandırmanızı sitenize dağıtın komutunu çalıştırın:

    firebase deploy --only hosting

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

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

  • Bağlı tüm özel alanlar:
    CUSTOM_DOMAIN/

ziyaret edin.

Hosting yapılandırma sayfasını ziyaret edin: yeniden yazma kuralları hakkında daha fazla bilgi edinin. Şunları yapabilirsiniz: şu konularda da bilgi edinebilirsiniz: yanıtların öncelik sırası barındırmaktadır.

Yerel olarak test et

Geliştirme sırasında container görüntünüzü yerel olarak çalıştırıp test edebilirsiniz. Örneğin, daha ayrıntılı talimatlar için Cloud Run belgeleri.

Sonraki adımlar