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

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

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

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

للاطّلاع على أمثلة لحالات الاستخدام ونماذج لتطبيق Cloud Run المدمج مع Firebase Hosting، يُرجى الانتقال إلى نظرة عامة حول تكنولوجيا السحابة غير المزوّدة بخادم.


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

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

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

قبل البدء

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

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

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

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

  1. فعِّل واجهة برمجة التطبيقات Cloud Run في وحدة تحكّم Google APIs:

    1. افتح صفحة واجهة برمجة التطبيقات Cloud Run في وحدة تحكم واجهات برمجة التطبيقات في Google.

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

    3. انقر على تفعيل في صفحة واجهة برمجة التطبيقات Cloud Run.

  2. ثبِّت حزمة تطوير البرامج (SDK) لـ Cloud وفعِّلها.

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

    gcloud config list

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

يُرجى العِلم أنّ 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.

اكتمل تطبيقك وأصبح جاهزًا لنقله إلى حاويات وتحميله إلى 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.21.1"
  }
}

    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.

جافا

  1. ثبِّت Java SE 8 أو إصدار أحدث من JDK وCURL.

    يُرجى العِلم أنّنا نحتاج فقط إلى إجراء ذلك لإنشاء مشروع الويب الجديد في الخطوة التالية. سيقوم الملف الشامل، الموصوف لاحقًا، بتحميل جميع التبعيات في الحاوية.

  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 في الدليل نفسه مثل الملفات المصدر. انسخ المحتوى التالي في ملفك.

    انتقال

    # 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

    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

    جافا

    # 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

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

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

ملاحظة: بدلاً من Cloud Build، يمكنك استخدام إصدار مثبَّت محليًا من Docker للقيام بإنشاء الحاوية محليًا.

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

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

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

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

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

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

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

  • 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 Hosting حتى يتمكّن من إنشاء محتوى ديناميكي ل موقعك الإلكتروني المستضاف على Firebase.

الخطوة 4: توجيه طلبات الاستضافة إلى تطبيقك المُنشئ في حاوية

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

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

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

    للحصول على تعليمات مفصّلة حول تثبيت واجهة برمجة التطبيقات وبدء استخدام 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 التالية:

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

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

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

الاختبار على الجهاز

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

الخطوات التالية