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

আপনার ডাইনামিক কন্টেন্ট তৈরি ও পরিবেশন করতে অথবা মাইক্রোসার্ভিস হিসেবে REST API তৈরি করতে Cloud Run এর সাথে Firebase Hosting যুক্ত করুন।

Cloud Run ব্যবহার করে, আপনি একটি কন্টেইনার ইমেজে প্যাকেজ করা অ্যাপ্লিকেশন ডেপ্লয় করতে পারেন। তারপর, Firebase Hosting ব্যবহার করে, আপনি আপনার কন্টেইনারাইজড অ্যাপটি চালু করার জন্য HTTPS রিকোয়েস্ট পাঠাতে পারেন।

  • Cloud Run বিভিন্ন ভাষা (গো, নোড.জেএস, পাইথন এবং জাভা সহ) সমর্থন করে, যা আপনাকে আপনার পছন্দের প্রোগ্রামিং ভাষা এবং ফ্রেমওয়ার্ক ব্যবহার করার সুবিধা দেয়।
  • Cloud Run প্রাপ্ত অনুরোধগুলি সামাল দিতে আপনার কন্টেইনার ইমেজকে স্বয়ংক্রিয়ভাবে এবং পর্যায়ক্রমে স্কেল করে , এবং চাহিদা কমে গেলে স্কেল ডাউন করে।
  • অনুরোধ প্রক্রিয়াকরণের সময় ব্যবহৃত সিপিইউ, মেমরি এবং নেটওয়ার্কিং খরচের জন্যই আপনাকে কেবল অর্থ প্রদান করতে হয়

Firebase Hosting সাথে সমন্বিত Cloud Run ব্যবহারিক ক্ষেত্র ও নমুনার জন্য, আমাদের সার্ভারলেস ওভারভিউ দেখুন।


এই নির্দেশিকাটি আপনাকে দেখাবে কীভাবে:

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

মনে রাখবেন যে, ডাইনামিক কন্টেন্ট পরিবেশনের পারফরম্যান্স উন্নত করতে আপনি ঐচ্ছিকভাবে আপনার ক্যাশ সেটিংস পরিবর্তন করতে পারেন।

শুরু করার আগে

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

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

Cloud Run বিনামূল্যে ব্যবহারের কোটা প্রদান করে, কিন্তু Cloud Run ব্যবহার বা পরখ করে দেখার জন্য আপনার ফায়ারবেস প্রজেক্টের সাথে যুক্ত একটি Cloud Billing অ্যাকাউন্ট অবশ্যই থাকতে হবে।

API সক্রিয় করুন এবং SDK ইনস্টল করুন।

  1. Google APIs কনসোলে Cloud Run API সক্রিয় করুন:

    1. Google APIs কনসোলে Cloud Run API পৃষ্ঠাটি খুলুন।

    2. নির্দেশিত হলে আপনার ফায়ারবেস প্রজেক্টটি নির্বাচন করুন।

    3. Cloud Run API পেজে Enable- এ ক্লিক করুন।

  2. ক্লাউড এসডিকে ইনস্টল এবং চালু করুন

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

    এই কোডটি একটি সাধারণ ওয়েব সার্ভার তৈরি করে, যা 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.22.1"
      }
    }
    
  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 এনভায়রনমেন্ট ভেরিয়েবল দ্বারা নির্ধারিত পোর্টে কাজ করে।

আপনার অ্যাপটি তৈরি হয়ে গেছে এবং এটি কন্টেইনারাইজ করে 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)))
    

    এই কোডটি একটি সাধারণ ওয়েব সার্ভার তৈরি করে, যা 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. src/main/java/com/example/helloworld/HelloworldApplication.java তে থাকা SpringBootApplication ক্লাসটি আপডেট করুন। এর জন্য / ম্যাপিং পরিচালনা করতে একটি @RestController যোগ করুন এবং TARGET এনভায়রনমেন্ট ভেরিয়েবল সরবরাহ করার জন্য একটি @Value ফিল্ডও যোগ করুন।

    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 এনভায়রনমেন্ট ভেরিয়েবল দ্বারা নির্ধারিত পোর্টে কাজ করে।

আপনার অ্যাপটি তৈরি হয়ে গেছে এবং এটি কন্টেইনারাইজ করে 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"]
    

    নোড.জেএস

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

কন্টেইনার ইমেজটি এখন Artifact Registry তে সংরক্ষিত আছে এবং চাইলে এটি পুনরায় ব্যবহার করা যেতে পারে।

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

ধাপ ৩ : কন্টেইনার ইমেজটি Cloud Run ডেপ্লয় করুন

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

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

  2. জিজ্ঞাসা করা হলে:

  3. ডিপ্লয়মেন্ট সম্পূর্ণ হওয়ার জন্য কিছুক্ষণ অপেক্ষা করুন। সফল হলে, কমান্ড লাইনে সার্ভিস ইউআরএলটি প্রদর্শিত হবে। উদাহরণস্বরূপ https://helloworld- RANDOM_HASH -us-central1.a.run.app

  4. ওয়েব ব্রাউজারে সার্ভিস ইউআরএলটি খুলে আপনার ডেপ্লয় করা কন্টেইনারটি ভিজিট করুন।

পরবর্তী ধাপে দেখানো হবে কীভাবে একটি Firebase Hosting URL থেকে এই কন্টেইনারাইজড অ্যাপটি অ্যাক্সেস করতে হয়, যাতে এটি আপনার Firebase-হোস্টেড সাইটের জন্য ডাইনামিক কন্টেন্ট তৈরি করতে পারে।

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

রিরাইট রুল ব্যবহার করে, আপনি নির্দিষ্ট প্যাটার্নের সাথে মিলে যাওয়া রিকোয়েস্টগুলোকে একটিমাত্র গন্তব্যে পাঠাতে পারেন।

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

  1. নিশ্চিত করুন যে:

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

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

  3. hosting সেকশনের অধীনে নিম্নলিখিত rewrite কনফিগারেশনটি যোগ করুন:

    "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 ডকুমেন্টেশন দেখুন।

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