Catch up on everthing we announced at this year's Firebase Summit. Learn more

با Cloud Run محتوای پویا و ریز سرویس های میزبان را ارائه دهید

برای ایجاد و ارائه محتوای پویا یا ایجاد API های REST به عنوان سرویس های خرد ، جفت Cloud Run را با Firebase Hosting جفت کنید.

با استفاده از ابر اجرا ، شما می توانید یک برنامه کاربردی بسته بندی شده در یک تصویر ظرف استقرار. سپس ، با استفاده از Firebase Hosting ، می توانید درخواست های HTTPS را هدایت کنید تا برنامه محتویات شما فعال شود.

  • ابر اجرا از چندین زبان (از جمله برو، Node.js و، Python و جاوا)، به شما انعطاف پذیری به استفاده از زبان برنامه نویسی و چارچوب از انتخاب شما.
  • ابر اجرا به صورت خودکار و به صورت افقی ترازو تصویر ظرف خود را برای رسیدگی به درخواست های دریافت شده، پس از آن کفه ترازو پایین زمانی که تقاضا کاهش می یابد.
  • شما فقط پرداخت برای پردازنده، حافظه، و شبکه های در طول دست زدن به درخواست مصرف می شود.

برای موارد استفاده به عنوان مثال و نمونه برای ابر اجرا یکپارچه با Firebase میزبانی وب، ما مراجعه نمای کلی بدون سرور .


این راهنما به شما نشان می دهد که چگونه:

  1. یک برنامه ساده Hello World بنویسید
  2. یک برنامه را ذخیره کرده و آن را در رجیستری کانتینر بارگذاری کنید
  3. تصویر ظرف را در Cloud Run قرار دهید
  4. درخواست های میزبانی مستقیم به برنامه کانتینری شده شما

توجه داشته باشید که برای بهبود عملکرد خدمت محتوای پویا، شما می توانید به صورت اختیاری لحن خود را تنظیمات کش .

قبل از اینکه شروع کنی

قبل از استفاده از ابر اجرا، شما نیاز به تکمیل برخی از کارهای اولیه، از جمله راه اندازی یک حساب در صورتحساب ابر، امکان API ابر اجرا و نصب gcloud ابزار خط فرمان.

صورتحساب پروژه خود را تنظیم کنید

ابر اجرا ارائه می دهد سهمیه استفاده رایگان است، اما شما هنوز هم باید یک حساب ابر حسابداری مرتبط با پروژه فایربیس خود را به استفاده و یا سعی کنید ابر اجرا.

API را فعال کرده و SDK را نصب کنید

  1. API Cloud Run را در کنسول Google API فعال کنید:

    1. را باز صفحه API ابر اجرا در کنسول Google API استفاده کنید.

    2. وقتی از شما خواسته شد ، پروژه Firebase خود را انتخاب کنید.

    3. با کلیک بر روی صفحه API ابر اجرا را فعال کنید.

  2. نصب و مقداردهی اولیه ابر SDK.

  3. بررسی کنید که gcloud ابزار برای پروژه صحیح پیکربندی:

    gcloud config list

مرحله 1: نوشتن برنامه نمونه

توجه داشته باشید که ابر اجرا از بسیاری از زبان های دیگر علاوه بر زبان های نشان داده شده در نمونه زیر.

برو

  1. ایجاد یک پوشه جدید به نام helloworld-go ، پس از آن تغییر دایرکتوری به آن:

    mkdir helloworld-go
    cd helloworld-go
  2. ایجاد یک فایل به نام جدید 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))
    }
    

    این کد یک وب سرور اساسی است که گوش بر روی پورت تعریف شده توسط PORT متغیر محیط زیست است.

برنامه شما به پایان رسیده و آماده حمل و بارگیری در رجیستری کانتینر است.

Node.js

  1. ایجاد یک پوشه جدید به نام helloworld-nodejs ، تغییر دایرکتوری و سپس به آن:

    mkdir helloworld-nodejs
    cd helloworld-nodejs
  2. درست 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.16.4"
      }
    }
    
  3. ایجاد یک فایل جدید به نام 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);
    });
    

    این کد یک وب سرور اساسی است که گوش بر روی پورت تعریف شده توسط PORT متغیر محیط زیست است.

برنامه شما به پایان رسیده و آماده حمل و بارگیری در رجیستری کانتینر است.

پایتون

  1. ایجاد یک پوشه جدید به نام helloworld-python ، تغییر دایرکتوری و سپس به آن:

    mkdir helloworld-python
    cd helloworld-python
  2. ایجاد یک فایل جدید به نام 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)))
    

    این کد یک وب سرور اساسی است که گوش بر روی پورت تعریف شده توسط PORT متغیر محیط زیست است.

برنامه شما به پایان رسیده و آماده حمل و بارگیری در رجیستری کانتینر است.

جاوا

  1. نصب جاوا SE 8 و یا بعد از JDK و CURL .

    توجه داشته باشید که ما فقط باید این کار را انجام دهیم تا پروژه وب جدید را در مرحله بعدی ایجاد کنیم. Dockerfile ، که بعداً توضیح داده شد ، تمام وابستگی ها را در ظرف بارگذاری می کند.

  2. از طریق کنسول ، یک پروژه وب خالی جدید با استفاده از cURL ایجاد کرده و دستورات را از حالت فشرده خارج کنید:

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

    این یک پروژه SpringBoot ایجاد می کند.

  3. به روز رسانی SpringBootApplication کلاس در src/main/java/com/example/helloworld/HelloworldApplication.java با اضافه کردن یک @RestController که مسئولیت رسیدگی به / نقشه برداری و همچنین یک اضافه @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);
      }
    }
    

    این کد یک وب سرور اساسی است که گوش بر روی پورت تعریف شده توسط PORT متغیر محیط زیست است.

برنامه شما به پایان رسیده و آماده حمل و بارگیری در رجیستری کانتینر است.

مرحله 2: Containerize برنامه و ارسال آن به رجیستری کانتینر

  1. Containerize برنامه نمونه با ایجاد یک فایل جدید به نام Dockerfile در همان دایرکتوری که فایل های منبع. مطالب زیر را در فایل خود کپی کنید.

    برو

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

    پایتون

    # 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
    

    جاوا

    # 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 ، تصویر ظرف خود را با استفاده از Cloud Build بسازید:

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

    پس از موفقیت ، یک پیام SUCCESS حاوی نام تصویر را مشاهده خواهید کرد
    ( gcr.io/ PROJECT_ID /helloworld ).

تصویر ظرف در حال حاضر در رجیستری کانتینر ذخیره می شود و در صورت تمایل می توان دوباره از آن استفاده کرد.

توجه داشته باشید که، به جای ابر ساخت، شما می توانید یک نسخه به صورت محلی نصب شده از کارگر بارانداز به استفاده از ساخت ظرف خود را به صورت محلی .

مرحله 3: استقرار تصویر ظرف به ابر اجرا

  1. با استفاده از دستور زیر استقرار دهید:

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

  2. هنگام درخواست:

  3. چند لحظه منتظر بمانید تا استقرار کامل شود. در صورت موفقیت ، خط فرمان آدرس سرویس را نمایش می دهد. به عنوان مثال: https://helloworld- RANDOM_HASH -us-central1.a.run.app

  4. با باز کردن آدرس سرویس در مرورگر وب ، از ظرف مستقر خود دیدن کنید.

گام بعدی شما از طریق پیاده چگونه برای دسترسی به این برنامه کانتینری از میزبانی URL فایربیس طوری که می تواند محتوای پویا برای سایت فایربیس میزبانی خود را تولید کند.

گام 4: درخواست میزبانی مستقیم به برنامه کانتینری خود را

با قوانین بازنویسی ، شما می توانید درخواست های که مطابقت الگوهای خاص برای یک مقصد واحد به طور مستقیم.

به عنوان مثال نشان می دهد زیر چگونه برای هدایت تمام درخواست ها از صفحه /helloworld در سایت میزبانی وب خود را به ماشه راه اندازی و در حال اجرا از خود را helloworld به عنوان مثال ظرف.

  1. مطمئن شوید که:

    برای راهنمایی بیشتر در مورد نصب CLI و مقدار دهی اولیه میزبانی وب، را ببینید مطلع راهنمای شروع برای میزبانی .

  2. خود را باز firebase.json فایل .

  3. اضافه کردن زیر rewrite پیکربندی تحت hosting بخش:

    "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. با اجرای دستور زیر از ریشه فهرست پروژه خود ، پیکربندی میزبانی خود را در سایت خود قرار دهید:

    firebase deploy

در حال حاضر از طریق آدرس های اینترنتی زیر به ظرف شما دسترسی دارید:

  • زیر دامنه های Firebase شما:
    PROJECT_ID .web.app/ و PROJECT_ID .firebaseapp.com/

  • هر متصل دامنههای سفارشی :
    CUSTOM_DOMAIN /

برای بازدید از صفحه تنظیمات میزبانی جزئیات بیشتر در مورد قوانین بازنویسی . شما همچنین می توانید در مورد یادگیری به ترتیب اولویت پاسخ از پیکربندی های مختلف میزبانی وب.

به صورت محلی آزمایش کنید

در حین توسعه ، می توانید تصویر ظرف خود را به صورت محلی اجرا و آزمایش کنید. برای راهنمایی بیشتر، بازدید از اسناد و مدارک ابر اجرا .

مراحل بعدی