Cloud Run ile dinamik içerik sunun ve mikro hizmetleri barındırın

Dinamik içeriğinizi oluşturup sunmak veya REST API'lerini mikro hizmetler olarak oluşturmak için Cloud Run'ı Firebase Hosting ile eşleştirin.

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

  • Cloud Run çeşitli dilleri (Go, Node.js, Python ve Java dahil) destekleyerek size istediğiniz programlama dilini ve çerçeveyi kullanma esnekliği sunar.
  • Cloud Run, alınan istekleri işlemek için kapsayıcı görüntünüzü otomatik ve yatay olarak ölçeklendirir , ardından talep azaldığında ölçeği küçültür.
  • Yalnızca istek işleme sırasında tüketilen CPU, bellek ve ağ iletişimi için ödeme yaparsınız.

Örneğin, Firebase Hosting ile entegre Cloud Run için kullanım senaryoları ve örnekleri için sunucusuz genel bakış sayfamızı ziyaret edin.


Bu kılavuz size aşağıdakileri nasıl yapacağınızı gösterir:

  1. Basit bir Merhaba Dünya uygulaması yazın
  2. Bir uygulamayı kapsayıcıya alın ve Container Registry'ye yükleyin
  3. Container görüntüsünü Cloud Run'a dağıtın
  4. Barındırma isteklerini konteynerli uygulamanıza yönlendirin

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

Sen 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ırmayı ayarlayın

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

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

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

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

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

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

  2. Cloud SDK'yı yükleyin ve başlatın .

  3. gcloud aracının doğru proje için yapılandırıldığını kontrol edin:

    gcloud config list

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

Cloud Run'ın aşağıdaki örnekte gösterilen dillere ek olarak başka birçok dili de desteklediğini unutmayın.

Gitmek

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

    mkdir helloworld-go
    cd helloworld-go
  2. helloworld.go adında yeni bir dosya oluşturun ve 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))
    }
    

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

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

Node.js

  1. helloworld-nodejs adında yeni bir dizin oluşturun, ardından dizini bu dizinle değiştirin:

    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.18.2"
      }
    }
    
  3. index.js adında yeni bir dosya oluşturun ve 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);
    });
    

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

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

Python

  1. helloworld-python adında yeni bir dizin oluşturun, ardından dizini bu dizinle değiştirin:

    mkdir helloworld-python
    cd helloworld-python
  2. app.py adında yeni bir dosya oluşturun ve 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)))
    

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

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

Java

  1. Java SE 8 veya üzeri JDK 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 anlatılacak olan Dockerfile, tüm bağımlılıkları konteynere yükleyecektir.

  2. Konsoldan cURL'yi kullanarak yeni bir boş web projesi oluşturun ve ardından komutları 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 bir SpringBoot projesi oluşturur.

  3. / eşlemesini işlemek için bir @RestController ekleyerek ve ayrıca TARGET ortam değişkenini sağlamak için bir @Value alanı ekleyerek src / src/main/java/com/example/helloworld/HelloworldApplication.java 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);
      }
    }
    

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

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

Adım 2 : Bir uygulamayı kapsayıcıya alın ve Container Registry'ye yükleyin

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

    Gitmek

    # 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"]
    

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

    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
    

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

  2. Docker dosyanızı içeren dizinden aşağıdaki komutu çalıştırarak Cloud Build'i kullanarak konteyner görüntünüzü oluşturun:

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

    Başarı üzerine, resim adını içeren bir BAŞARI mesajı göreceksiniz
    ( gcr.io/ PROJECT_ID /helloworld ).

Kapsayıcı görüntüsü artık Container Registry'de depolanıyor ve istenirse yeniden kullanılabilir.

Kapsayıcınızı yerel olarak oluşturmak için Cloud Build yerine Docker'ın yerel olarak yüklenmiş bir 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 Barındırma ile birlikte konumlandırın:

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

Hosting'den Cloud Run'a 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ı durumunda komut satırı hizmet URL'sini görüntüler. Ö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ılan kapsayıcınızı ziyaret edin.

Bir sonraki adım, Firebase tarafından barındırılan siteniz için dinamik içerik oluşturabilmesi amacıyla, kapsayıcıya alınmış bu uygulamaya bir Firebase Barındırma URL'sinden nasıl erişeceğiniz konusunda size yol gösterir.

4. Adım: Barındırma isteklerini konteynerli uygulamanıza yönlendirin

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

Aşağıdaki örnek, helloworld konteyner ö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ğini gösterir.

  1. Emin olun:

    CLI'yi yükleme ve Barındırma'yı başlatma hakkında ayrıntılı talimatlar için Barındırma için Başlangıç ​​kılavuzuna bakın.

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

  3. hosting bölümünün 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ünden 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 aracılığıyla ulaşılabilir:

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

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

Yeniden yazma kuralları hakkında daha fazla ayrıntı için Barındırma yapılandırma sayfasını ziyaret edin. Ayrıca çeşitli Barındırma yapılandırmalarına yönelik yanıtların öncelik sırası hakkında da bilgi edinebilirsiniz.

Yerel olarak test edin

Geliştirme sırasında kapsayıcı görüntünüzü yerel olarak çalıştırabilir ve test edebilirsiniz. Ayrıntılı talimatlar için Cloud Run belgelerini ziyaret edin.

Sonraki adımlar