ক্লাউড রানের সাথে ডায়নামিক কন্টেন্ট এবং হোস্ট মাইক্রোসার্ভিস পরিবেশন করুন

আপনার গতিশীল সামগ্রী তৈরি এবং পরিবেশন করতে বা মাইক্রোসার্ভিস হিসাবে REST API তৈরি করতে Firebase Hosting সাথে Cloud Run ৷

Cloud Run ব্যবহার করে, আপনি একটি ধারক ছবিতে প্যাকেজযুক্ত একটি অ্যাপ্লিকেশন স্থাপন করতে পারেন। তারপরে, Firebase Hosting ব্যবহার করে, আপনি আপনার ধারক অ্যাপ্লিকেশনটিকে ট্রিগার করতে HTTPS অনুরোধগুলি পরিচালনা করতে পারেন।

উদাহরণস্বরূপ Firebase Hosting সাথে একীভূত Cloud Run জন্য কেস এবং নমুনাগুলি ব্যবহার করুন, আমাদের সার্ভারলেস ওভারভিউটি দেখুন।


এই গাইড আপনাকে কীভাবে দেখায়:

  1. একটি সাধারণ হ্যালো ওয়ার্ল্ড অ্যাপ্লিকেশন লিখুন
  2. একটি অ্যাপ্লিকেশন ধারক এবং এটি Container Registry আপলোড করুন
  3. Cloud Run কন্টেইনার ইমেজ স্থাপন করুন
  4. আপনার কন্টেইনারাইজড অ্যাপে সরাসরি Hosting অনুরোধ

মনে রাখবেন যে গতিশীল সামগ্রী পরিবেশন করার কর্মক্ষমতা উন্নত করতে, আপনি ঐচ্ছিকভাবে আপনার ক্যাশে সেটিংস টিউন করতে পারেন৷

আপনি শুরু করার আগে

Cloud Run ব্যবহার করার আগে, আপনাকে একটি Cloud Billing অ্যাকাউন্ট সেট আপ করা, Cloud Run API সক্ষম করা এবং gcloud কমান্ড লাইন টুল ইনস্টল করা সহ কিছু প্রাথমিক কাজ সম্পন্ন করতে হবে।

আপনার প্রকল্পের জন্য বিলিং সেট আপ করুন

Cloud Run offers free usage quota , but you still must have a Cloud Billing account associated with your Firebase project to use or try out Cloud Run .

API সক্ষম করুন এবং SDK ইনস্টল করুন

  1. গুগল এপিআইএস কনসোলে Cloud Run এপিআই সক্ষম করুন:

    1. গুগল এপিআইএস কনসোলে Cloud Run এপিআই পৃষ্ঠা খুলুন।

    2. যখন অনুরোধ করা হয়, আপনার ফায়ারবেস প্রকল্পটি নির্বাচন করুন।

    3. Cloud Run এপিআই পৃষ্ঠায় সক্ষম করুন ক্লিক করুন।

  2. ক্লাউড এসডিকে ইনস্টল করুন এবং আরম্ভ করুন ।

  3. সঠিক প্রকল্পের জন্য gcloud সরঞ্জামটি কনফিগার করা আছে কিনা তা পরীক্ষা করুন:

    gcloud config list

পদক্ষেপ 1 : নমুনা অ্যাপ্লিকেশন লিখুন

Note that Cloud Run supports many other languages in addition to the languages shown in the following sample.

যাও

  1. Create a new directory named helloworld-go , then change directory into it:

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

    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 আপলোড করার জন্য প্রস্তুত।

পাইথন

  1. helloworld-python নামে একটি নতুন ডিরেক্টরি তৈরি করুন, তারপরে এটিতে ডিরেক্টরি পরিবর্তন করুন:

    mkdir helloworld-python
    cd helloworld-python

  2. Create a new file named app.py , then add the following code: 

    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 https://start.spring.io/starter.zip \
    -d dependencies=web \
    -d name=helloworld \
    -d artifactId=helloworld \
    -o helloworld.zip
    unzip helloworld.zip

    এটি একটি স্প্রিংবুট প্রকল্প তৈরি করে।

  3. Update the SpringBootApplication class in src/main/java/com/example/helloworld/HelloworldApplication.java by adding a @RestController to handle the / mapping and also add a @Value field to provide the TARGET environment variable: 

    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. Containerize the sample app by creating a new file named Dockerfile in the same directory as the source files. আপনার ফাইলে নিম্নলিখিত সামগ্রীটি অনুলিপি করুন।

    যাও 

    # 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

    পাইথন 

    # 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. Build your container image using Cloud Build by running the following command from the directory containing your Dockerfile: 

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

    Upon success, you will see a SUCCESS message containing the image name
    ( gcr.io/ PROJECT_ID /helloworld )।

ধারক চিত্রটি এখন Container Registry সংরক্ষণ করা হয়েছে এবং যদি ইচ্ছা হয় তবে পুনরায় ব্যবহার করা যেতে পারে।

মনে রাখবেন, Cloud Build এর পরিবর্তে, আপনি স্থানীয়ভাবে আপনার কন্টেইনার তৈরি করতে Docker-এর স্থানীয়ভাবে ইনস্টল করা সংস্করণ ব্যবহার করতে পারেন।

ধাপ 3 : Cloud Run কন্টেইনার ইমেজ স্থাপন করুন

  1. নিম্নলিখিত কমান্ড ব্যবহার করে স্থাপন করুন: 

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

  2. যখন অনুরোধ করা হয়:

সেরা পারফরম্যান্সের জন্য, নিম্নলিখিত অঞ্চলগুলি ব্যবহার করে Hosting সাথে আপনার Cloud Run পরিষেবাটি সংযোজন করুন:

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

Hosting থেকে 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. ওয়েব ব্রাউজারে পরিষেবা ইউআরএল খোলার মাধ্যমে আপনার মোতায়েন ধারকটি দেখুন।

পরবর্তী পদক্ষেপটি আপনাকে Firebase Hosting ইউআরএল থেকে কীভাবে এই ধারক অ্যাপ্লিকেশনটি অ্যাক্সেস করতে পারে তার মাধ্যমে আপনাকে হাঁটতে পারে যাতে এটি আপনার ফায়ারবেস-হোস্টেড সাইটের জন্য গতিশীল সামগ্রী তৈরি করতে পারে।

ধাপ 4: আপনার কন্টেইনারাইজড অ্যাপে সরাসরি হোস্টিং অনুরোধ

With rewrite rules , you can direct requests that match specific patterns to a single destination.

নিম্নলিখিত উদাহরণটি দেখায় যে কীভাবে আপনার Hosting সাইটে পৃষ্ঠা /helloworld থেকে সমস্ত অনুরোধগুলি আপনার helloworld ধারক উদাহরণটি শুরু এবং চলমান ট্রিগার করতে কীভাবে নির্দেশনা দেয়।

  1. Make sure that:

    CLI ইনস্টল করা এবং Hosting শুরু করার বিষয়ে বিস্তারিত নির্দেশাবলীর জন্য, Hosting জন্য শুরু করুন গাইড দেখুন।

  2. আপনার firebase.json ফাইলটি খুলুন।

  3. Add the following rewrite configuration under the hosting section: 

    "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

আপনার ধারকটি এখন নিম্নলিখিত ইউআরএলগুলির মাধ্যমে পৌঁছনীয়:

  • আপনার ফায়ারবেস সাবডোমেনস:
    PROJECT_ID .web.app/ এবং PROJECT_ID .firebaseapp.com/

  • কোনও সংযুক্ত কাস্টম ডোমেন :
    CUSTOM_DOMAIN /

Visit the Hosting configuration page for more details about rewrite rules . You can also learn about the priority order of responses for various Hosting configurations.

স্থানীয়ভাবে পরীক্ষা করুন

During development, you can run and test your container image locally. বিস্তারিত নির্দেশাবলীর জন্য, Cloud Run ডকুমেন্টেশন দেখুন।

পরবর্তী পদক্ষেপ