Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

क्लाउड रन के साथ गतिशील सामग्री परोसें और माइक्रोसर्विसेज की मेजबानी करें

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

क्लाउड रन को फायरबेस होस्टिंग के साथ पेयर करें ताकि आपकी डायनेमिक कंटेंट जेनरेट और सर्व हो सके या माइक्रोसर्विसेज के रूप में आरईएसटी एपीआई का निर्माण हो सके।

क्लाउड रन का उपयोग करके, आप एक कंटेनर छवि में पैक किए गए एप्लिकेशन को परिनियोजित कर सकते हैं। फिर, फायरबेस होस्टिंग का उपयोग करके, आप अपने कंटेनरीकृत ऐप को ट्रिगर करने के लिए HTTPS अनुरोधों को निर्देशित कर सकते हैं।

  • क्लाउड रन कई भाषाओं (Go, Node.js, Python और Java सहित) का समर्थन करता है, जिससे आपको अपनी पसंद की प्रोग्रामिंग भाषा और फ्रेमवर्क का उपयोग करने की सुविधा मिलती है।
  • क्लाउड रन स्वचालित रूप से और क्षैतिज रूप से प्राप्त अनुरोधों को संभालने के लिए आपकी कंटेनर छवि को मापता है, फिर मांग कम होने पर नीचे की ओर बढ़ता है।
  • आप केवल अनुरोध प्रबंधन के दौरान खपत किए गए CPU, मेमोरी और नेटवर्किंग के लिए भुगतान करते हैं।

उदाहरण के लिए फायरबेस होस्टिंग के साथ एकीकृत क्लाउड रन के मामलों और नमूनों का उपयोग करें, हमारे सर्वर रहित अवलोकन पर जाएं।


यह मार्गदर्शिका आपको दिखाती है कि कैसे:

  1. एक साधारण हैलो वर्ल्ड एप्लिकेशन लिखें
  2. किसी ऐप को कंटेनरीकृत करें और उसे कंटेनर रजिस्ट्री में अपलोड करें
  3. कंटेनर छवि को क्लाउड रन पर तैनात करें
  4. आपके कंटेनरीकृत ऐप के लिए सीधे होस्टिंग अनुरोध

ध्यान दें कि गतिशील सामग्री परोसने के प्रदर्शन को बेहतर बनाने के लिए, आप वैकल्पिक रूप से अपनी कैश सेटिंग्स को ट्यून कर सकते हैं।

शुरू करने से पहले

क्लाउड रन का उपयोग करने से पहले, आपको कुछ प्रारंभिक कार्यों को पूरा करना होगा, जिसमें क्लाउड बिलिंग खाता स्थापित करना, क्लाउड रन एपीआई सक्षम करना और gcloud कमांड लाइन टूल इंस्टॉल करना शामिल है।

अपने प्रोजेक्ट के लिए बिलिंग सेट करें

क्लाउड रन मुफ्त उपयोग कोटा प्रदान करता है, लेकिन क्लाउड रन का उपयोग करने या इसे आज़माने के लिए आपके पास अभी भी आपके फायरबेस प्रोजेक्ट से जुड़ा एक क्लाउड बिलिंग खाता होना चाहिए।

एपीआई सक्षम करें और एसडीके स्थापित करें

  1. Google API कंसोल में क्लाउड रन API सक्षम करें:

    1. Google API कंसोल में क्लाउड रन API पृष्ठ खोलें।

    2. संकेत मिलने पर, अपना Firebase प्रोजेक्ट चुनें.

    3. क्लाउड रन एपीआई पेज पर सक्षम करें पर क्लिक करें।

  2. क्लाउड एसडीके स्थापित करें और आरंभ करें

  3. जांचें कि gcloud टूल सही प्रोजेक्ट के लिए कॉन्फ़िगर किया गया है:

    gcloud config list

चरण 1 : नमूना आवेदन लिखें

ध्यान दें कि क्लाउड रन निम्नलिखित नमूने में दिखाई गई भाषाओं के अलावा कई अन्य भाषाओं का समर्थन करता है।

जाओ

  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 पर्यावरण चर द्वारा परिभाषित पोर्ट पर सुनता है।

आपका ऐप तैयार है और कंटेनरीकृत होने और कंटेनर रजिस्ट्री पर अपलोड करने के लिए तैयार है।

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.16.4"
      }
    }
    
  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 पर्यावरण चर द्वारा परिभाषित पोर्ट पर सुनता है।

आपका ऐप तैयार है और कंटेनरीकृत होने और कंटेनर रजिस्ट्री पर अपलोड करने के लिए तैयार है।

अजगर

  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 पर्यावरण चर द्वारा परिभाषित पोर्ट पर सुनता है।

आपका ऐप तैयार है और कंटेनरीकृत होने और कंटेनर रजिस्ट्री पर अपलोड करने के लिए तैयार है।

जावा

  1. जावा एसई 8 या बाद में जेडीके और कर्ल स्थापित करें।

    ध्यान दें कि हमें केवल अगले चरण में नया वेब प्रोजेक्ट बनाने के लिए ऐसा करने की आवश्यकता है। Dockerfile, जिसे बाद में वर्णित किया गया है, सभी निर्भरताओं को कंटेनर में लोड करेगा।

  2. कंसोल से, कर्ल का उपयोग करके एक नया खाली वेब प्रोजेक्ट बनाएं और फिर कमांड को अनज़िप करें:

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

    यह एक स्प्रिंगबूट प्रोजेक्ट बनाता है।

  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 पर्यावरण चर द्वारा परिभाषित पोर्ट पर सुनता है।

आपका ऐप तैयार है और कंटेनरीकृत होने और कंटेनर रजिस्ट्री पर अपलोड करने के लिए तैयार है।

चरण 2 : किसी ऐप को कंटेनरीकृत करें और उसे कंटेनर रजिस्ट्री पर अपलोड करें

  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:1.13 as builder
    
    # 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=linux 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" ]
    

    अजगर

    # 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 युक्त निर्देशिका से निम्न आदेश चलाकर क्लाउड बिल्ड का उपयोग करके अपनी कंटेनर छवि बनाएं:

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

    सफल होने पर, आपको एक SUCCESS संदेश दिखाई देगा जिसमें छवि का नाम होगा
    ( gcr.io/ PROJECT_ID /helloworld )।

कंटेनर छवि अब कंटेनर रजिस्ट्री में संग्रहीत है और यदि वांछित है तो इसका पुन: उपयोग किया जा सकता है।

ध्यान दें कि, क्लाउड बिल्ड के बजाय, आप अपने कंटेनर को स्थानीय रूप से बनाने के लिए डॉकर के स्थानीय रूप से स्थापित संस्करण का उपयोग कर सकते हैं।

चरण 3 : कंटेनर छवि को क्लाउड रन पर तैनात करें

  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 होस्टिंग URL से एक्सेस किया जाए ताकि यह आपकी Firebase-होस्ट की गई साइट के लिए गतिशील सामग्री उत्पन्न कर सके।

चरण 4: अपने कंटेनरीकृत ऐप पर सीधे होस्टिंग अनुरोध

नियमों को फिर से लिखने के साथ, आप विशिष्ट पैटर्न से मेल खाने वाले अनुरोधों को एक ही गंतव्य पर निर्देशित कर सकते हैं।

निम्नलिखित उदाहरण दिखाता है कि आपके helloworld कंटेनर इंस्टेंस के स्टार्टअप और रनिंग को ट्रिगर करने के लिए आपकी होस्टिंग साइट पर पेज /helloworld से सभी अनुरोधों को कैसे निर्देशित किया जाए।

  1. निश्चित करें कि:

    सीएलआई स्थापित करने और होस्टिंग आरंभ करने के बारे में विस्तृत निर्देशों के लिए, होस्टिंग के लिए आरंभ करें मार्गदर्शिका देखें।

  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)
        }
      } ]
    }
    
  4. अपनी प्रोजेक्ट निर्देशिका के मूल से निम्न आदेश चलाकर अपनी साइट पर अपने होस्टिंग कॉन्फ़िगरेशन को परिनियोजित करें:

    firebase deploy

आपका कंटेनर अब निम्न URL के माध्यम से उपलब्ध है:

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

  • कोई भी जुड़ा हुआ कस्टम डोमेन :
    CUSTOM_DOMAIN /

नियमों को फिर से लिखने के बारे में अधिक जानकारी के लिए होस्टिंग कॉन्फ़िगरेशन पृष्ठ पर जाएं। आप विभिन्न होस्टिंग कॉन्फ़िगरेशन के लिए प्रतिक्रियाओं के प्राथमिकता क्रम के बारे में भी जान सकते हैं।

स्थानीय स्तर पर परीक्षण करें

विकास के दौरान, आप स्थानीय रूप से अपनी कंटेनर छवि को चला सकते हैं और उसका परीक्षण कर सकते हैं। विस्तृत निर्देशों के लिए, क्लाउड रन दस्तावेज़ीकरण पर जाएँ।

अगले कदम