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

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

با استفاده از Cloud Run ، می‌توانید یک برنامه را که در یک تصویر کانتینر بسته‌بندی شده است، مستقر کنید. سپس، با استفاده از Firebase Hosting ، می‌توانید درخواست‌های HTTPS را برای راه‌اندازی برنامه کانتینر شده خود هدایت کنید.

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


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

  1. یک برنامه ساده Hello World بنویسید
  2. یک برنامه را کانتینرایز کنید و آن را در Artifact Registry آپلود کنید
  3. تصویر کانتینر را در Cloud Run مستقر کنید
  4. درخواست‌های Hosting مستقیم به برنامه کانتینر شده شما

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

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

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

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

Cloud Run سهمیه استفاده رایگان ارائه می‌دهد، اما برای استفاده یا امتحان کردن Cloud Run ، همچنان باید یک حساب Cloud Billing مرتبط با پروژه Firebase خود داشته باشید.

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

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

    1. صفحه Cloud Run API را در کنسول Google APIs باز کنید.

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

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

  2. Cloud SDK را نصب و راه‌اندازی کنید .

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

    gcloud config list

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

توجه داشته باشید که Cloud Run علاوه بر زبان‌های نشان داده شده در نمونه زیر، از بسیاری از زبان‌های دیگر نیز پشتیبانی می‌کند.

برو

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

    helloworld.go

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

برنامه شما تکمیل شده و آماده کانتینر شدن و آپلود در Artifact Registry است.

نود جی اس

  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.21.2"
  }
}

    package.json

  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);
});

    index.js

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

برنامه شما تکمیل شده و آماده کانتینر شدن و آپلود در Artifact Registry است.

پایتون

  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)))

    app.py

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

برنامه شما تکمیل شده و آماده کانتینر شدن و آپلود در Artifact Registry است.

جاوا

  1. Java 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);
  }
}

    HelloworldApplication.java

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

برنامه شما تکمیل شده و آماده کانتینر شدن و آپلود در Artifact Registry است.

مرحله ۲ : یک برنامه را کانتینرایز کنید و آن را در Artifact Registry آپلود کنید

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

    برو 

    # 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

# Copy local code to the container image.
COPY . ./

# Install dependencies and tidy up the go.mod and go.sum files.
RUN go mod tidy

# 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

    نود جی اس 

    # 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

    پایتون 

    # 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

    جاوا 

    # 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. با اجرای دستور زیر از دایرکتوری حاوی فایل داکر خود، تصویر کانتینر خود را با استفاده از Cloud Build بسازید: 

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

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

تصویر کانتینر اکنون در Artifact Registry ذخیره شده است و در صورت تمایل می‌توان دوباره از آن استفاده کرد.

توجه داشته باشید که به جای Cloud Build ، می‌توانید از یک نسخه محلی نصب شده Docker برای ساخت کانتینر خود به صورت محلی استفاده کنید.

مرحله 3 : تصویر کانتینر را در Cloud Run مستقر کنید

  1. با استفاده از دستور زیر، آن را مستقر کنید: 

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

  2. وقتی از شما خواسته شد:

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

  4. با باز کردن URL سرویس در یک مرورگر وب، از کانتینر مستقر شده خود بازدید کنید.

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

مرحله ۴: درخواست‌های میزبانی را مستقیماً به برنامه کانتینر شده خود هدایت کنید

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

مثال زیر نحوه هدایت تمام درخواست‌ها از صفحه /helloworld در سایت Hosting شما را برای راه‌اندازی و اجرای نمونه کانتینر helloworld نشان می‌دهد.

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

    برای دستورالعمل‌های دقیق در مورد نصب CLI و مقداردهی اولیه Hosting ، به راهنمای شروع به کار Hosting مراجعه کنید.

  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)
      "pinTag": true              // optional (see note below)
    }
  } ]
}

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

    firebase deploy --only hosting

اکنون کانتینر شما از طریق URL های زیر قابل دسترسی است:

  • زیر دامنه‌های فایربیس شما:
    PROJECT_ID .web.app/ و PROJECT_ID .firebaseapp.com/

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

برای جزئیات بیشتر در مورد قوانین بازنویسی، به صفحه پیکربندی Hosting مراجعه کنید. همچنین می‌توانید در مورد ترتیب اولویت پاسخ‌ها برای پیکربندی‌های مختلف Hosting اطلاعات کسب کنید.

تست به صورت محلی

در طول توسعه، می‌توانید تصویر کانتینر خود را به صورت محلی اجرا و آزمایش کنید. برای دستورالعمل‌های دقیق، به مستندات Cloud Run مراجعه کنید.

مراحل بعدی