Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

Kullanımı Bulut Çalıştır , bir konteyner görüntüde paketlenmiş bir uygulama dağıtabilir. Ardından, Firebase Hosting'i kullanarak kapsayıcılı uygulamanızı tetiklemek için HTTPS isteklerini yönlendirebilirsiniz.

  • Bulut Run destekler birçok dil size istediğiniz programlama dilini ve çerçevesini kullanma esnekliği tanıyan, (Go, node.js, Python ve Java dahil).
  • Bulut çalıştırın otomatik ve yatay olarak ölçekler sonra, alınan istekleri işlemek için konteyner görüntü talebi azaldığında aşağı ölçekler.
  • Yalnızca ödeme işlemci, bellek için ve istek işleme sırasında tüketilen ilişki ağlarını.

Firebase Hosting ile entegre Bulut Koşusu için örnek kullanım durumları ve numuneler için, bizim ziyaret Sunucusuz bakış .


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

  1. Basit bir Merhaba Dünya uygulaması yazın
  2. Bir uygulamayı container mimarisine alın ve Container Registry'ye yükleyin
  3. Kapsayıcı görüntüsünü Cloud Run'a dağıtın
  4. Kapsayıcılı uygulamanıza doğrudan Barındırma istekleri

Yapabilirsiniz isteğe ayar dinamik içerik sunan performansını artırmak için Not önbellek ayarları .

Sen başlamadan önce

Bulut Çalıştır kullanmadan önce, bir bulut Fatura hesap oluştururken Bulut Run API sağlayan ve yükleme gibi bazı ilk görevleri tamamlamak için gereken gcloud komut satırı aracı.

Projeniz için faturalandırmayı ayarlayın

Bulut Run sunmaktadır ücretsiz kullanım kotasını , ama yine de bir olmalıdır Bulut Fatura hesabı şekilde kullanmak için Firebase projeyle ilişkili veya Cloud Run deneyin.

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

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

    1. Bulut Run API sayfasını Google API konsolunda.

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

    3. Tıklayın Bulut Run API sayfasına etkinleştirin.

  2. Yükleme ve başlatmak Bulut SDK.

  3. Kontrol edin gcloud aracı doğru proje için yapılandırılır:

    gcloud config list

Adım 1: Örnek uygulamayı yaz

Bulut Run desteklediğini Not birçok dili aşağıdaki örnekte gösterildiği dillere ek olarak.

Gitmek

  1. Yeni bir dizin adında oluşturun helloworld-go içine, o zaman değişim dizini:

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

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

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

Node.js

  1. Adlı yeni bir dizin oluşturun helloworld-nodejs içine, ardından değişim dizini:

    mkdir helloworld-nodejs
    cd helloworld-nodejs
  2. Bir oluşturun package.json aşağıdaki içeriği ile dosyayı:

    {
      "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.16.4"
      }
    }
    
  3. Adlı yeni bir dosya oluşturun index.js , 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);
    });
    

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

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

piton

  1. Yeni bir dizin adında oluşturun helloworld-python içine, ardından değişim dizini:

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

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

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

Java

  1. Yükleme Java SE 8 veya daha yeni JDK ve CURL .

    Bunu yalnızca bir sonraki adımda yeni web projesini oluşturmak için yapmamız gerektiğini unutmayın. Daha sonra açıklanan Dockerfile, tüm bağımlılıkları kapsayıcıya yükleyecektir.

  2. Konsoldan, cURL 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. Güncelleme SpringBootApplication sınıfı src/main/java/com/example/helloworld/HelloworldApplication.java bir ekleyerek @RestController işlemek için / haritalama ve ayrıca eklemek @Value sağlamak üzere alanını TARGET ortam değişkeni:

    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 bağlantı noktasında dinler tarafından tanımlanan bu temel bir web sunucusu oluşturur PORT ortam değişkeni.

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

2. Adım: ambalajlamasını bir uygulama ve Konteyner Sicil yükleyin

  1. Adlı yeni bir dosya oluşturarak örnek uygulamayı ambalajlamasını Dockerfile kaynak dosyaları ile aynı dizinde. 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:1.13 as builder
    
    # 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=linux 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" ]
    

    piton

    # 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. Dockerfile dosyanızı içeren dizinden aşağıdaki komutu çalıştırarak Cloud Build'i kullanarak kapsayıcı görüntünüzü oluşturun:

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

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

Konteyner görüntüsü artık Container Registry'de saklanmaktadır ve istenirse yeniden kullanılabilir.

Yerine Bulut Build yapmanız Docker bir yerel olarak yüklü sürümünü kullanabilirsiniz, unutmayın yerel Kapsayıcınızı inşa .

3. Adım: Bulut Çalıştır konteyner görüntü dağıtma

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

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

  2. İstendiğinde:

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

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

Bir sonraki adım sizin Firebase barındırılan site için dinamik içerik oluşturmak, böylece bir Firebase Hosting URL'den bu konteynerle uygulamaya erişmek için size yol gösterir.

4. Adım: konteynerle app doğrudan barındırma istekleri

İle , yeniden yazma kuralları , tek bir hedefe belirli kalıplarla eşleşen istekleri yönlendirebilir.

Sayfa tüm isteklerini yönlendirmek için nasıl Aşağıdaki örnek gösterir /helloworld senin Hosting sitesinde başlangıç tetikleyebilir ve koşu için helloworld konteyner örneği.

  1. Emin olun:

    CLI yükleme ve Barındırma başlatılıyor hakkında ayrıntılı talimatlar için bkz Hosting için Başlayın kılavuzuna .

  2. Senin açın firebase.json dosyasını .

  3. Aşağıdaki ekleyin rewrite altında yapılandırmayı hosting bölümünde:

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

Kapsayıcınıza artık aşağıdaki URL'ler aracılığıyla erişilebilir:

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

  • Herhangi bağlı özel alanlar :
    CUSTOM_DOMAIN /

İçin barındırma yapılandırma sayfasını ziyaret edin yeniden yazma kuralları hakkında daha fazla ayrıntı . Ayrıca öğrenebilir yanıtların öncelik sırasına çeşitli Barındırma yapılandırmalar için.

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, ziyaret Bulut Run belgelerine .

Sonraki adımlar