Cloud Run की मदद से डाइनैमिक कॉन्टेंट उपलब्ध कराएं और माइक्रोसर्विस होस्ट करें

डाइनैमिक कॉन्टेंट जनरेट करने और उसे दिखाने के लिए, Cloud Run को Firebase Hosting के साथ जोड़ें या REST API को माइक्रोसर्विस के तौर पर बनाएं.

Cloud Run का इस्तेमाल करके, कंटेनर इमेज में पैकेज किए गए ऐप्लिकेशन को डिप्लॉय किया जा सकता है. इसके बाद, Firebase Hosting का इस्तेमाल करके, अपने कंटेनर वाले ऐप्लिकेशन को ट्रिगर करने के लिए एचटीटीपीएस अनुरोध भेजे जा सकते हैं.

  • Cloud Run कई भाषाओं के साथ काम करता है. इनमें Go, Node.js, Python, और Java शामिल हैं. इससे आपको अपनी पसंद की प्रोग्रामिंग भाषा और फ़्रेमवर्क इस्तेमाल करने की सुविधा मिलती है.
  • Cloud Run अपने-आप और हॉरिज़ॉन्टल तौर पर स्केल करता है आपकी कंटेनर इमेज, मिले अनुरोधों को मैनेज करने के लिए. इसके बाद, मांग कम होने पर स्केल कम कर देता है.
  • अनुरोध को प्रोसेस करने के दौरान, सीपीयू, स्मृति, और नेटवर्किंग के इस्तेमाल के लिए ही पैसे चुकाए जाते हैं.

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 Run का इस्तेमाल करने या उसे आज़माने के लिए, आपके पास अपने Firebase प्रोजेक्ट से जुड़ा Cloud Billing खाता होना चाहिए.

एपीआई चालू करना और SDK टूल इंस्टॉल करना

  1. Google API कंसोल में Cloud Run एपीआई चालू करें:

    1. Google API कंसोल में, Cloud Run एपीआई पेज खोलें.

    2. जब कहा जाए, तब अपना Firebase प्रोजेक्ट चुनें.

    3. Cloud Run एपीआई पेज पर, चालू करें पर क्लिक करें.

  2. Cloud SDK टूल को इंस्टॉल और शुरू करें.

  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 एनवायरमेंट वैरिएबल से तय किए गए पोर्ट पर सुनता है.

आपका ऐप्लिकेशन तैयार हो गया है और उसे कंटेनर में डालकर 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"
      }
    }
    
  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 एनवायरमेंट वैरिएबल से तय किए गए पोर्ट पर सुनता है.

आपका ऐप्लिकेशन तैयार हो गया है और उसे कंटेनर में डालकर 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)))
    

    यह कोड एक बुनियादी वेब सर्वर बनाता है, जो PORT एनवायरमेंट वैरिएबल से तय किए गए पोर्ट पर सुनता है.

आपका ऐप्लिकेशन तैयार है और कंटेनर बनाया जाने के लिए तैयार है. साथ ही, इसे Container Registry पर अपलोड किया जा सकता है.

Java

  1. Java SE 8 या इसके बाद के वर्शन वाला JDK और CURL इंस्टॉल करें.

    ध्यान दें कि अगले चरण में नया वेब प्रोजेक्ट बनाने के लिए, हमें सिर्फ़ यह करना होगा. Dockerfile, कंटेनर में सभी डिपेंडेंसी लोड करेगा. इस फ़ाइल के बारे में बाद में बताया जाएगा.

  2. कंसोल से, cURL का इस्तेमाल करके एक नया खाली वेब प्रोजेक्ट बनाएं. इसके बाद, unzip कमांड का इस्तेमाल करें:

    curl https://start.spring.io/starter.zip \
        -d dependencies=web \
        -d name=helloworld \
        -d artifactId=helloworld \
        -o helloworld.zip
    unzip helloworld.zip

    यह एक SpringBoot प्रोजेक्ट बनाता है.

  3. / मैपिंग को मैनेज करने के लिए, @RestController जोड़कर src/main/java/com/example/helloworld/HelloworldApplication.java में SpringBootApplication क्लास को अपडेट करें. साथ ही, 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 एनवायरमेंट वैरिएबल से तय किए गए पोर्ट पर सुनता है.

आपका ऐप्लिकेशन तैयार हो गया है और उसे कंटेनर में डालकर Container Registry पर अपलोड किया जा सकता है.

दूसरा चरण: किसी ऐप्लिकेशन को कंटेनर में डालना और उसे 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"]
    

    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" ]
    

    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
    

    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"]
    

  2. Cloud Build का इस्तेमाल करके अपनी कंटेनर इमेज बनाएं. इसके लिए, Dockerfile वाली डायरेक्ट्री में जाकर, यह कमांड चलाएं:

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

    सफल होने के बाद, आपको इमेज के नाम
    (gcr.io/PROJECT_ID/helloworld) के साथ 'हो गया' मैसेज दिखेगा.

कंटेनर इमेज अब Container Registry में सेव हो जाती है और ज़रूरत पड़ने पर उसका फिर से इस्तेमाल किया जा सकता है.

ध्यान दें कि Cloud Build के बजाय, अपने कंप्यूटर पर कंटेनर बनाने के लिए, Docker के स्थानीय तौर पर इंस्टॉल किए गए वर्शन का इस्तेमाल किया जा सकता है.

तीसरा चरण: कंटेनर इमेज को 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

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. डिप्लॉय होने की प्रोसेस पूरी होने तक इंतज़ार करें. निर्देश पूरा होने पर, कमांड लाइन में सेवा का यूआरएल दिखता है. उदाहरण के लिए: https://helloworld-RANDOM_HASH-us-central1.a.run.app

  2. वेब ब्राउज़र में सेवा का यूआरएल खोलकर, डिप्लॉय किए गए कंटेनर पर जाएं.

अगले चरण में, Firebase Hosting यूआरएल से इस कंटेनर वाले ऐप्लिकेशन को ऐक्सेस करने का तरीका बताया गया है, ताकि यह आपकी Firebase होस्ट की गई साइट के लिए डाइनैमिक कॉन्टेंट जनरेट कर सके.

चौथा चरण: होस्टिंग के अनुरोधों को अपने कंटेनर वाले ऐप्लिकेशन पर भेजना

फिर से लिखने के नियमों की मदद से, किसी खास पैटर्न से मैच करने वाले अनुरोधों को एक ही डेस्टिनेशन पर भेजा जा सकता है.

यहां दिए गए उदाहरण में, Hosting साइट पर मौजूद /helloworld पेज से सभी अनुरोधों को अपने helloworld कंटेनर इंस्टेंस के स्टार्टअप और उसे चलाने के लिए ट्रिगर करने का तरीका बताया गया है.

  1. पक्का करें कि:

    सीएलआई इंस्टॉल करने और 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

आपके कंटेनर को अब इन यूआरएल से ऐक्सेस किया जा सकता है:

  • आपके Firebase सबडोमेन:
    PROJECT_ID.web.app/ और PROJECT_ID.firebaseapp.com/

  • कनेक्ट किए गए किसी भी कस्टम डोमेन:
    CUSTOM_DOMAIN/

रीराइट नियमों के बारे में ज़्यादा जानकारी के लिए, Hosting कॉन्फ़िगरेशन पेज पर जाएं. अलग-अलग Hosting कॉन्फ़िगरेशन के लिए, जवाबों के प्राथमिकता क्रम के बारे में भी जाना जा सकता है.

स्थानीय तौर पर जांच करना

डेवलपमेंट के दौरान, अपनी कंटेनर इमेज को स्थानीय तौर पर चलाया और जांचा जा सकता है. ज़्यादा जानकारी के लिए, Cloud Run दस्तावेज़ पर जाएं.

अगले चरण