Cloud Run-এর মাধ্যমে পরিবর্তনশীল কন্টেন্ট পরিবেশন ও মাইক্রোসার্ভিস হোস্ট করা

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

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

  • Cloud Run-এ একাধিক ভাষা (Go, Node.js, Python ও Java সহ) কাজ করে, যার ফলে আপনি নিজের পছন্দমতো প্রোগ্রামিং ল্যাঙ্গুয়েজ ও ফ্রেমওয়ার্ক ব্যবহার করার সুবিধা পান।
  • Cloud Run প্রাপ্ত অনুরোধ ম্যানেজ করার জন্য আপনার কন্টেনার ইমেজ অটোমেটিক ও অনুভূমিকভাবে স্কেল করে, তারপর চাহিদা কমে গেলে স্কেল ডাউন করে।
  • অনুরোধ ম্যানেজ করার সময় ব্যবহৃত CPU, মেমরি ও নেটওয়ার্কিংয়ের জন্য আপনাকে শুধু পেমেন্ট করতে হয়।

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 ব্যবহার বা পরীক্ষা করে দেখার জন্য আপনার Firebase প্রোজেক্টের সাথে Cloud Billing অ্যাকাউন্ট অবশ্যই যুক্ত থাকতে হবে।

API চালু ও SDK ইনস্টল করুন

  1. Google APIs কনসোলে Cloud Run API চালু করুন:

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

    2. প্রম্পট করা হলে, আপনার Firebase প্রোজেক্ট বেছে নিন।

    3. Cloud Run API পৃষ্ঠায় চালু করুন বিকল্পে ক্লিক করুন।

  2. Cloud SDK ইনস্টল ও ইনিশিয়ালাইজ করুন।

  3. gcloud টুলটি সঠিক প্রোজেক্টের জন্য কনফিগার করা হয়েছে কিনা তা চেক করুন:

    gcloud config list

ধাপ ১: স্যাম্পেল অ্যাপ্লিকেশন লিখুন

মনে রাখবেন, নিম্নলিখিত স্যাম্পেলে দেখানো ভাষা ছাড়াও Cloud Run অন্যান্য অনেক ভাষা সাপোর্ট করে।

Go

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

    mkdir helloworld-go
     
    cd helloworld-go
    1. 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-এ আপলোড করার জন্য রেডি।

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",
    "check": "node --check index.js"
  },
  "engines": {
    "node": ">=24"
  },
  "author": "",
  "license": "Apache-2.0",
  "dependencies": {
    "express": "^5.3.0"
  }
}

  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-এ আপলোড করার জন্য রেডি।

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 f"Hello {target}!\n"


if __name__ == "__main__":
    app.run(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 নামের নতুন ফাইল তৈরি করে স্যাম্পেল অ্যাপটি কন্টেনারাইজ করুন। আপনার ফাইলে নিম্নলিখিত কন্টেন্ট কপি করুন।

    Go

    # Use the official Golang image to create a build artifact.
# Use the supported Go 1.27 release track.
FROM golang:1.27 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.24
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"]

    Node.js

    # Use the official lightweight Node.js 24 LTS image.
# https://hub.docker.com/_/node
FROM node:25-bookworm-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 ci on every code change.
COPY package*.json ./

# Install production dependencies.
RUN npm ci --omit=dev

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

# Run the web service on container startup.
CMD [ "node", "index.js" ]

    Python

    # Use the official lightweight Python image.
# https://hub.docker.com/_/python
FROM python:3.15.0-slim-trixie

# Allow statements and log messages to immediately appear in the Knative logs
ENV PYTHONUNBUFFERED=1

# Knative supplies PORT; default to 8080 for local runs.
ENV PORT=8080
WORKDIR /app

# Install pinned production dependencies before copying application code.
COPY requirements.txt ./
RUN python -m pip install --no-cache-dir -r requirements.txt

COPY app.py ./

# 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 ["sh", "-c", "exec gunicorn --bind \"0.0.0.0:${PORT:-8080}\" --workers 1 --threads 8 --timeout 0 app:app"]

    জাভা

    # Use the official Maven/Java 25 LTS image to build: https://hub.docker.com/_/maven
FROM maven:3.9-eclipse-temurin-26 AS builder

# Copy local code to the container image.
WORKDIR /app
COPY pom.xml .
COPY src ./src

# Build the executable jar.
RUN mvn --batch-mode --no-transfer-progress package

# Use the Eclipse Temurin Java 25 LTS runtime for the production stage.
# https://hub.docker.com/_/eclipse-temurin
# https://docs.docker.com/develop/develop-images/multistage-build/#use-multi-stage-builds
FROM eclipse-temurin:25-jre-noble

# 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", "-jar", "/helloworld.jar"]

  2. আপনার Dockerfile আছে এমন ডিরেক্টরি থেকে নিম্নলিখিত কমান্ড রান করিয়ে Cloud Build ব্যবহার করে আপনার কন্টেনার ইমেজ তৈরি করুন:

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

    সফল হলে, আপনি একটি 'সফল' মেসেজ দেখতে পাবেন যাতে ছবির নাম
    (gcr.io/PROJECT_ID/helloworld) থাকবে।

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

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

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

  1. এই কমান্ড ব্যবহার করে ডিপ্লয় করুন:

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

  2. প্রম্পট করা হলে:

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

  4. ওয়েব ব্রাউজারে পরিষেবার URL খুলে আপনার ডিপ্লয় করা কন্টেনার দেখুন।

পরবর্তী ধাপে আপনি জানতে পারবেন যে কীভাবে এই কন্টেনারাইজড অ্যাপটি একটি 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-এর মাধ্যমে অ্যাক্সেস করা যাবে:

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

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

Hosting কনফিগারেশন পৃষ্ঠা দেখুন রিরাইট সংক্রান্ত নিয়ম সম্পর্কে আরও জানতে। এছাড়াও, আপনি বিভিন্ন Hosting কনফিগারেশনের জন্য উত্তরের অগ্রাধিকারের ক্রম সম্পর্কে জানতে পারবেন।

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

ডেভেলপমেন্টের সময়, আপনি লোকালি কন্টেনার ইমেজ রান ও টেস্ট করতে পারবেন। বিস্তারিত নির্দেশাবলীর জন্য, Cloud Run ডকুমেন্টেশন দেখুন।

পরবর্তী ধাপ