عرض المحتوى الديناميكي واستضافة الخدمات الدقيقة باستخدام Cloud Run

يمكنك إقران Cloud Run مع استضافة Firebase لإنشاء المحتوى الديناميكي وعرضه، أو إنشاء واجهات برمجة تطبيقات REST كخدمات مصغَّرة.

باستخدام Cloud Run، يمكنك نشر تطبيق في حزمة في صورة حاوية. وبعد ذلك، يمكنك باستخدام "استضافة Firebase" توجيه طلبات HTTPS لتشغيل تطبيقك المُحوَّل إلى حاوية.

  • يدعم Cloud Run عدّة لغات (بما في ذلك Go وNode.js وPython وJava)، مما يمنحك المرونة لاستخدام لغة البرمجة وإطار العمل من اختيارك.
  • يعمل Cloud Run تلقائيًا وأفقيًا على ضبط صورة الحاوية لمعالجة الطلبات المُستلَمة، ثم يتم تقليصه عند انخفاض الطلب.
  • ما عليك سوى الدفع مقابل وحدة المعالجة المركزية والذاكرة والاتصال بالشبكات التي يتم استهلاكها أثناء معالجة الطلبات.

على سبيل المثال، حالات الاستخدام والعينات لنظام Cloud Run الذي تم دمجه مع "استضافة Firebase"، يمكنك الانتقال إلى نظرة عامة على المحتوى بدون خادم.


يوضّح لك هذا الدليل كيفية تنفيذ ما يلي:

  1. كتابة تطبيق Hello World بسيط
  2. إضافة تطبيق إلى Container Registry وتحميله إلى Container Registry
  3. نشر صورة الحاوية في Cloud Run
  4. طلبات الاستضافة المباشرة لتطبيقك المضمّن

لاحظ أنه لتحسين أداء عرض المحتوى الديناميكي، يمكنك ضبط إعدادات ذاكرة التخزين المؤقت اختياريًا.

قبل البدء

قبل استخدام Cloud Run، يجب إكمال بعض المهام الأولية، بما في ذلك إعداد حساب فوترة في السحابة الإلكترونية وتفعيل واجهة برمجة التطبيقات في Cloud Run وتثبيت أداة سطر الأوامر gcloud.

إعداد الفوترة لمشروعك

يوفّر Cloud Run حصة استخدام مجانية، ولكن يجب أن يكون لديك حساب فوترة في السحابة الإلكترونية مرتبط بمشروعك على Firebase حتى تتمكّن من استخدام Cloud Run أو تجربته.

تفعيل واجهة برمجة التطبيقات وتثبيت حزمة تطوير البرامج (SDK)

  1. تفعيل Cloud Run API في وحدة تحكُّم Google APIs:

    1. افتح صفحة Cloud Run API في وحدة تحكُّم Google APIs.

    2. اختَر مشروعك على Firebase عندما يُطلب منك ذلك.

    3. انقر على تفعيل في صفحة Cloud Run API.

  2. تثبيت وإعداد حزمة SDK للسحابة الإلكترونية

  3. تأكَّد من إعداد أداة gcloud للمشروع الصحيح:

    gcloud config list

الخطوة 1: كتابة نموذج التطبيق

تجدر الإشارة إلى أن Cloud Run يدعم العديد من اللغات الأخرى بالإضافة إلى اللغات المذكورة في النموذج التالي.

Go

  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.

تم الانتهاء من تطبيقك وأصبح جاهزًا للحاويات وتحميله إلى Container Registry.

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.19.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.

تم الانتهاء من تطبيقك وأصبح جاهزًا للحاويات وتحميله إلى Container Registry.

Python

  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.

تم الانتهاء من تطبيقك وأصبح جاهزًا للحاويات وتحميله إلى Container Registry.

Java

  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.

تم الانتهاء من تطبيقك وأصبح جاهزًا للحاويات وتحميله إلى Container Registry.

الخطوة 2: تحميل تطبيق إلى حاويات وتحميله إلى Container Registry

  1. ضمِّن نموذج التطبيق من خلال إنشاء ملف جديد باسم Dockerfile في الدليل نفسه كملفات المصدر. انسخ المحتوى التالي في ملفك.

    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. أنشئ صورة الحاوية باستخدام Cloud Build عن طريق تشغيل الأمر التالي من الدليل الذي يحتوي على Dockerfile:

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

    عند إتمام العملية بنجاح، ستظهر لك رسالة "تم بنجاح" تحتوي على اسم الصورة
    (gcr.io/PROJECT_ID/helloworld).

يتم الآن تخزين صورة الحاوية في Container Registry ويمكن إعادة استخدامها عند الرغبة في ذلك.

تجدر الإشارة إلى أنّه يمكنك استخدام إصدار مثبَّت محليًا من Docker بدلاً من Cloud Build من أجل إنشاء حاويتك محليًا.

الخطوة 3: نشر صورة الحاوية في Cloud Run

  1. النشر باستخدام الأمر التالي:

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

  2. عندما يُطلب منك ذلك:

للحصول على أفضل أداء، يمكنك تجميع خدمة Cloud Run مع ميزة "الاستضافة" باستخدام المناطق التالية:

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

تتوفر عمليات إعادة الكتابة إلى Cloud Run من "الاستضافة" في المناطق التالية:

  • 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. يُرجى الانتظار بضع لحظات حتى تكتمل عملية النشر. عند نجاح، يعرض سطر الأوامر عنوان URL للخدمة. مثلاً: https://helloworld-RANDOM_HASH-us-central1.a.run.app

  2. انتقِل إلى الحاوية المنشورة عن طريق فتح عنوان URL للخدمة في متصفّح ويب.

ستوضّح لك الخطوة التالية كيفية الوصول إلى هذا التطبيق المحاور من عنوان URL لاستضافة Firebase حتى يتمكّن من إنشاء محتوى ديناميكي لموقعك الإلكتروني الذي يستضيفه Firebase.

الخطوة 4: طلبات الاستضافة المباشرة لتطبيقك المضمّن

باستخدام قواعد إعادة الكتابة، يمكنك توجيه الطلبات التي تتطابق مع أنماط محددة إلى وجهة واحدة.

يوضِّح المثال التالي كيفية توجيه جميع الطلبات من صفحة /helloworld على الموقع الإلكتروني للاستضافة لبدء تشغيل مثيل حاوية helloworld وتشغيله.

  1. تأكَّد مما يلي:

    للحصول على تعليمات تفصيلية حول تثبيت واجهة سطر الأوامر وتهيئة الاستضافة، راجع دليل البدء للاستضافة.

  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 التالية:

  • نطاقاتك الفرعية في Firebase:
    PROJECT_ID.web.app/ و PROJECT_ID.firebaseapp.com/

  • أيّ نطاقات مخصّصة مرتبطة:
    CUSTOM_DOMAIN/

انتقِل إلى صفحة "ضبط الاستضافة" للاطّلاع على مزيد من التفاصيل حول قواعد إعادة الكتابة. يمكنك أيضًا التعرف على ترتيب أولويات الاستجابات لإعدادات الاستضافة المختلفة.

الاختبار محليًا

أثناء التطوير، يمكنك تشغيل صورة الحاوية واختبارها محليًا. للحصول على تعليمات تفصيلية، يُرجى الانتقال إلى مستندات Cloud Run.

الخطوات اللاحقة