शुरू करें: अपने पहले फ़ंक्शन लिखें, टेस्ट करें, और डिप्लॉय करें

2nd gen 1st gen

Cloud Functions का इस्तेमाल शुरू करने के लिए, इस ट्यूटोरियल को आज़माएं. इसमें, सेटअप से जुड़े ज़रूरी टास्क के साथ-साथ, दो मिलते-जुलते फ़ंक्शन बनाने, उनकी जांच करने, और उन्हें डिप्लॉय करने के बारे में बताया गया है:

• यह एक "मैसेज जोड़ें" फ़ंक्शन है, जो एक ऐसा यूआरएल दिखाता है जो टेक्स्ट वैल्यू स्वीकार करता है और उसे Cloud Firestore पर लिखता है.
• यह "अपरकेस बनाएं" फ़ंक्शन है, जो Cloud Firestore के लिखने पर ट्रिगर होता है और टेक्स्ट को अपरकेस में बदल देता है.

यहां फ़ंक्शन वाला पूरा सैंपल कोड दिया गया है:

Node.js

// The Cloud Functions for Firebase SDK to create Cloud Functions and triggers.
const {logger} = require("firebase-functions");
const {onRequest} = require("firebase-functions/v2/https");
const {onDocumentCreated} = require("firebase-functions/v2/firestore");

// The Firebase Admin SDK to access Firestore.
const {initializeApp} = require("firebase-admin/app");
const {getFirestore} = require("firebase-admin/firestore");

initializeApp();

// Take the text parameter passed to this HTTP endpoint and insert it into
// Firestore under the path /messages/:documentId/original
exports.addmessage = onRequest(async (req, res) => {
  // Grab the text parameter.
  const original = req.query.text;
  // Push the new message into Firestore using the Firebase Admin SDK.
  const writeResult = await getFirestore()
      .collection("messages")
      .add({original: original});
  // Send back a message that we've successfully written the message
  res.json({result: `Message with ID: ${writeResult.id} added.`});
});

// Listens for new messages added to /messages/:documentId/original
// and saves an uppercased version of the message
// to /messages/:documentId/uppercase
exports.makeuppercase = onDocumentCreated("/messages/{documentId}", (event) => {
  // Grab the current value of what was written to Firestore.
  const original = event.data.data().original;

  // Access the parameter `{documentId}` with `event.params`
  logger.log("Uppercasing", event.params.documentId, original);

  const uppercase = original.toUpperCase();

  // You must return a Promise when performing
  // asynchronous tasks inside a function
  // such as writing to Firestore.
  // Setting an 'uppercase' field in Firestore document returns a Promise.
  return event.data.ref.set({uppercase}, {merge: true});
});
index.js

Python

# The Cloud Functions for Firebase SDK to create Cloud Functions and set up triggers.
from firebase_functions import firestore_fn, https_fn

# The Firebase Admin SDK to access Cloud Firestore.
from firebase_admin import initialize_app, firestore
import google.cloud.firestore

app = initialize_app()


@https_fn.on_request()
def addmessage(req: https_fn.Request) -> https_fn.Response:
    """Take the text parameter passed to this HTTP endpoint and insert it into
    a new document in the messages collection."""
    # Grab the text parameter.
    original = req.args.get("text")
    if original is None:
        return https_fn.Response("No text parameter provided", status=400)

    firestore_client: google.cloud.firestore.Client = firestore.client()

    # Push the new message into Cloud Firestore using the Firebase Admin SDK.
    _, doc_ref = firestore_client.collection("messages").add({"original": original})

    # Send back a message that we've successfully written the message
    return https_fn.Response(f"Message with ID {doc_ref.id} added.")


@firestore_fn.on_document_created(document="messages/{pushId}")
def makeuppercase(event: firestore_fn.Event[firestore_fn.DocumentSnapshot | None]) -> None:
    """Listens for new documents to be added to /messages. If the document has
    an "original" field, creates an "uppercase" field containg the contents of
    "original" in upper case."""

    # Get the value of "original" if it exists.
    if event.data is None:
        return
    try:
        original = event.data.get("original")
    except KeyError:
        # No "original" field, so do nothing.
        return

    # Set the "uppercase" field.
    print(f"Uppercasing {event.params['pushId']}: {original}")
    upper = original.upper()
    event.data.reference.update({"uppercase": upper})
main.py

इस ट्यूटोरियल के बारे में जानकारी

हमने इस सैंपल के लिए Cloud Firestore और एचटीटीपी से ट्रिगर होने वाले फ़ंक्शन को इसलिए चुना है, क्योंकि इन बैकग्राउंड ट्रिगर की जांच Firebase Local Emulator Suite की मदद से पूरी तरह से की जा सकती है. यह टूलसेट, Realtime Database, Cloud Storage, PubSub, Auth, और एचटीटीपी कॉल किए जा सकने वाले ट्रिगर के साथ भी काम करता है. दूसरे तरह के बैकग्राउंड ट्रिगर, जैसे कि Remote Config और TestLab ट्रिगर की जांच इंटरैक्शन से की जा सकती है. इसके लिए, उन टूलसेट का इस्तेमाल किया जाता है जिनके बारे में इस पेज पर नहीं बताया गया है.

ध्यान दें: किसी भी Firebase प्रोजेक्ट में फ़ंक्शन को एमुलेट किया जा सकता है. हालांकि, फ़ंक्शन को डिप्लॉय करने के लिए, आपके प्रोजेक्ट का इस्तेमाल Blaze की कीमत वाले प्लान के साथ किया जाना चाहिए. Cloud Functions कीमत देखें.

इस ट्यूटोरियल के नीचे दिए गए सेक्शन में, सैंपल बनाने, उसकी जांच करने, और उसे डिप्लॉय करने के बारे में बताया गया है.

Firebase प्रोजेक्ट बनाना

1. Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें.

   • मौजूदा Google Cloud प्रोजेक्ट में Firebase संसाधन जोड़ने के लिए, प्रोजेक्ट का नाम डालें या ड्रॉपडाउन मेन्यू से चुनें.

   • नया प्रोजेक्ट बनाने के लिए, प्रोजेक्ट का नाम डालें. आपके पास प्रोजेक्ट के नाम के नीचे दिख रहे प्रोजेक्ट आईडी में भी बदलाव करने का विकल्प है. हालांकि, ऐसा करना ज़रूरी नहीं है.

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

2. अगर कहा जाए, तो Firebase की शर्तें पढ़ें और उन्हें स्वीकार करें.

3. जारी रखें पर क्लिक करें.

4. (ज़रूरी नहीं) अपने प्रोजेक्ट के लिए Google Analytics सेट अप करें. इससे, आपको यहां दिए गए Firebase प्रॉडक्ट में से किसी का भी इस्तेमाल करने का बेहतर अनुभव मिलता है:

   Firebase Crashlytics Firebase Cloud Messaging

   Firebase In-App Messaging Firebase Remote Config

   Remote Config उपयोगकर्ताओं के हिसाब से कॉन्टेंट दिखाना Firebase A/B Testing

   कोई मौजूदा Google Analytics खाता चुनें या नया खाता बनाएं.

   नया खाता बनाने पर, अपनी Analytics रिपोर्टिंग की जगह चुनें. इसके बाद, अपने प्रोजेक्ट के लिए, डेटा शेयर करने की सेटिंग और Google Analytics की शर्तें स्वीकार करें.

   अपने प्रोजेक्ट सेटिंग के इंटिग्रेशन टैब में जाकर, Google Analytics को बाद में कभी भी सेट अप किया जा सकता है.

5. प्रोजेक्ट बनाएं पर क्लिक करें या अगर किसी मौजूदा Google Cloud प्रोजेक्ट का इस्तेमाल किया जा रहा है, तो Firebase जोड़ें पर क्लिक करें.

Firebase, आपके Firebase प्रोजेक्ट के लिए संसाधनों को अपने-आप उपलब्ध कराता है. प्रोसेस पूरी होने के बाद, आपको Firebase कंसोल में अपने Firebase प्रोजेक्ट के होम पेज पर ले जाया जाएगा.

अपना एनवायरमेंट और Firebase CLI सेट अप करना

Node.js

फ़ंक्शन लिखने के लिए, आपको Node.js एनवायरमेंट की ज़रूरत होगी. साथ ही, Cloud Functions रनटाइम में फ़ंक्शन डिप्लॉय करने के लिए, आपको Firebase सीएलआई की ज़रूरत होगी. Node.js और npm इंस्टॉल करने के लिए, Node Version Manager का इस्तेमाल करने का सुझाव दिया जाता है.

अहम जानकारी: Cloud Functions और Firebase सीएलआई, Node.js के 18 और 20 वर्शन के साथ पूरी तरह काम करते हैं. साथ ही, वर्शन 22 के लिए, झलक के लेवल पर काम करते हैं. वर्शन 14 और 16 का इस्तेमाल नहीं किया जा सकता. इन्हें साल 2025 की शुरुआत में बंद कर दिया जाएगा. फ़िलहाल, इन वर्शन के साथ डिप्लॉयमेंट की सुविधा बंद है. Node.js के इन वर्शन के साथ काम करने से जुड़ी ज़रूरी जानकारी पाने के लिए, रनटाइम के विकल्प सेट करना लेख पढ़ें.

Node.js और npm इंस्टॉल करने के बाद, अपने पसंदीदा तरीके से Firebase CLI इंस्टॉल करें. npm की मदद से CLI इंस्टॉल करने के लिए, इनका इस्तेमाल करें:

npm install -g firebase-tools

इससे, दुनिया भर में उपलब्ध Firebase कमांड इंस्टॉल हो जाता है. अगर निर्देश काम नहीं करता, तो आपको npm अनुमतियां बदलनी पड़ सकती हैं. firebase-tools के नए वर्शन पर अपडेट करने के लिए, वही कमांड फिर से चलाएं.

कई मामलों में, नई सुविधाएं और गड़बड़ी ठीक करने की सुविधाएं, सिर्फ़ Firebase CLI और firebase-functions SDK टूल के सबसे नए वर्शन के साथ उपलब्ध होती हैं. अपने Firebase प्रोजेक्ट के functions फ़ोल्डर में, इन निर्देशों का इस्तेमाल करके Firebase CLI और SDK टूल, दोनों को बार-बार अपडेट करना एक अच्छा तरीका है:

npm install firebase-functions@latest firebase-admin@latest --save
npm install -g firebase-tools

Python

फ़ंक्शन लिखने के लिए, आपको Python एनवायरमेंट की ज़रूरत होगी. साथ ही, Cloud Functions रनटाइम पर फ़ंक्शन डिप्लॉय करने के लिए, आपको Firebase सीएलआई की ज़रूरत होगी. हमारा सुझाव है कि डिपेंडेंसी को अलग करने के लिए, venv का इस्तेमाल करें. Python के 3.10 और 3.11 वर्शन का इस्तेमाल किया जा सकता है.

Python इंस्टॉल करने के बाद, अपने पसंदीदा तरीके से Firebase CLI इंस्टॉल करें.

कई मामलों में, नई सुविधाएं और गड़बड़ी ठीक करने की सुविधाएं, सिर्फ़ Firebase CLI और firebase-functions SDK टूल के सबसे नए वर्शन के साथ उपलब्ध होती हैं. अपने Firebase प्रोजेक्ट के functions फ़ोल्डर में, Firebase CLI और SDK टूल, दोनों को समय-समय पर अपडेट करना एक अच्छा तरीका है.

अपना प्रोजेक्ट शुरू करना

Cloud Functions के लिए Firebase SDK टूल को शुरू करने पर, एक खाली प्रोजेक्ट बनता है. इसमें डिपेंडेंसी और कुछ कम से कम सैंपल कोड होते हैं. अगर Node.js का इस्तेमाल किया जा रहा है, तो फ़ंक्शन लिखने के लिए टाइपस्क्रिप्ट या JavaScript चुनें. इस ट्यूटोरियल के लिए, आपको Cloud Firestore शुरू भी करना होगा.

अपना प्रोजेक्ट शुरू करने के लिए:

1. ब्राउज़र से लॉग इन करने और Firebase के सीएलआई की पुष्टि करने के लिए, firebase login चलाएं.
2. अपने Firebase प्रोजेक्ट की डायरेक्ट्री पर जाएं.
3. firebase init firestore चलाएं. इस ट्यूटोरियल के लिए, Firestore के नियमों और इंडेक्स फ़ाइलों के लिए निर्देश मिलने पर, डिफ़ॉल्ट वैल्यू स्वीकार की जा सकती हैं. अगर आपने इस प्रोजेक्ट में अब तक Cloud Firestore का इस्तेमाल नहीं किया है, तो आपको Firestore के लिए शुरुआती मोड और जगह भी चुननी होगी. Cloud Firestore का इस्तेमाल शुरू करने का तरीका सेक्शन में बताया गया है.
4. firebase init functions चलाएं. सीएलआई, आपको कोई मौजूदा कोडबेस चुनने या नया कोडबेस शुरू करने और उसका नाम रखने के लिए कहता है. शुरुआत में, डिफ़ॉल्ट जगह पर एक कोडबेस होना ही काफ़ी है. बाद में, जब आपका कोडबेस बड़ा हो जाएगा, तो हो सकता है कि आप कोडबेस में फ़ंक्शन व्यवस्थित करना चाहें.

5. सीएलआई में, भाषा से जुड़ी सहायता के लिए ये विकल्प मिलते हैं:

   • JavaScript
   • TypeScript
   • Python

   इस ट्यूटोरियल के लिए, JavaScript या Python चुनें. TypeScript में लिखने के लिए, TypeScript की मदद से फ़ंक्शन लिखना लेख पढ़ें.

6. सीएलआई की मदद से, डिपेंडेंसी इंस्टॉल की जा सकती हैं. अगर आपको डिपेंडेंसी को किसी दूसरे तरीके से मैनेज करना है, तो इसे अस्वीकार करना सुरक्षित है.

इन निर्देशों के पूरा होने के बाद, आपके प्रोजेक्ट का स्ट्रक्चर कुछ ऐसा दिखेगा:

Node.js

myproject
+- .firebaserc    # Hidden file that helps you quickly switch between
|                 # projects with `firebase use`
|
+- firebase.json  # Describes properties for your project
|
+- functions/     # Directory containing all your functions code
      |
      +- .eslintrc.json  # Optional file containing rules for JavaScript linting.
      |
      +- package.json  # npm package file describing your Cloud Functions code
      |
      +- index.js      # Main source file for your Cloud Functions code
      |
      +- node_modules/ # Directory where your dependencies (declared in
                        # package.json) are installed

Node.js के लिए, शुरू करने के दौरान बनाई गई package.json फ़ाइल में एक अहम बटन होता है: "engines": {"node": "18"}. इससे, फ़ंक्शन लिखने और डिप्लॉय करने के लिए, आपके Node.js वर्शन के बारे में पता चलता है. इस्तेमाल किए जा सकने वाले अन्य वर्शन चुने जा सकते हैं.

Python

myproject
+- .firebaserc    # Hidden file that helps you quickly switch between
|                 # projects with `firebase use`
|
+- firebase.json  # Describes properties for your project
|
+- functions/     # Directory containing all your functions code
      |
      +- main.py      # Main source file for your Cloud Functions code
      |
      +- requirements.txt  #  List of the project's modules and packages 
      |
      +- venv/ # Directory where your dependencies are installed

ज़रूरी मॉड्यूल इंपोर्ट करना और ऐप्लिकेशन को शुरू करना

सेटअप के टास्क पूरे करने के बाद, सोर्स डायरेक्ट्री खोली जा सकती है और नीचे दिए गए सेक्शन में बताए गए तरीके से कोड जोड़ा जा सकता है. इस सैंपल के लिए, आपके प्रोजेक्ट को Cloud Functions और एडमिन SDK मॉड्यूल इंपोर्ट करने होंगे. अपनी सोर्स फ़ाइल में, इस तरह की लाइनें जोड़ें:

Node.js

// The Cloud Functions for Firebase SDK to create Cloud Functions and triggers.
const {logger} = require("firebase-functions");
const {onRequest} = require("firebase-functions/v2/https");
const {onDocumentCreated} = require("firebase-functions/v2/firestore");

// The Firebase Admin SDK to access Firestore.
const {initializeApp} = require("firebase-admin/app");
const {getFirestore} = require("firebase-admin/firestore");

initializeApp();
index.js

Python

# The Cloud Functions for Firebase SDK to create Cloud Functions and set up triggers.
from firebase_functions import firestore_fn, https_fn

# The Firebase Admin SDK to access Cloud Firestore.
from firebase_admin import initialize_app, firestore
import google.cloud.firestore

app = initialize_app()
main.py

ये लाइनें ज़रूरी मॉड्यूल लोड करती हैं और admin ऐप्लिकेशन इंस्टेंस को शुरू करती हैं. इस इंस्टेंस से Cloud Firestore बदलाव किए जा सकते हैं. जहां भी एडमिन SDK के साथ काम करने की सुविधा उपलब्ध होती है, वहां यह Cloud Functions का इस्तेमाल करके Firebase को इंटिग्रेट करने का एक बेहतर तरीका उपलब्ध कराती है. हालांकि, यह सुविधा FCM, Authentication, और Firebase Realtime Database के लिए उपलब्ध है.

प्रोजेक्ट शुरू करने पर, Firebase CLI, Cloud Functions मॉड्यूल के लिए Firebase Admin SDK टूल और Firebase SDK टूल को अपने-आप इंस्टॉल कर देता है. अपने प्रोजेक्ट में तीसरे पक्ष की लाइब्रेरी जोड़ने के बारे में ज़्यादा जानने के लिए, डिपेंडेंसी मैनेज करना लेख पढ़ें.

"मैसेज जोड़ें" फ़ंक्शन जोड़ें

"मैसेज जोड़ें" फ़ंक्शन के लिए, अपनी सोर्स फ़ाइल में ये लाइनें जोड़ें:

Node.js

// Take the text parameter passed to this HTTP endpoint and insert it into
// Firestore under the path /messages/:documentId/original
exports.addmessage = onRequest(async (req, res) => {
  // Grab the text parameter.
  const original = req.query.text;
  // Push the new message into Firestore using the Firebase Admin SDK.
  const writeResult = await getFirestore()
      .collection("messages")
      .add({original: original});
  // Send back a message that we've successfully written the message
  res.json({result: `Message with ID: ${writeResult.id} added.`});
});
index.js

Python

@https_fn.on_request()
def addmessage(req: https_fn.Request) -> https_fn.Response:
    """Take the text parameter passed to this HTTP endpoint and insert it into
    a new document in the messages collection."""
    # Grab the text parameter.
    original = req.args.get("text")
    if original is None:
        return https_fn.Response("No text parameter provided", status=400)

    firestore_client: google.cloud.firestore.Client = firestore.client()

    # Push the new message into Cloud Firestore using the Firebase Admin SDK.
    _, doc_ref = firestore_client.collection("messages").add({"original": original})

    # Send back a message that we've successfully written the message
    return https_fn.Response(f"Message with ID {doc_ref.id} added.")
main.py

"मैसेज जोड़ें" फ़ंक्शन, एचटीटीपी एंडपॉइंट है. एंडपॉइंट पर किए गए किसी भी अनुरोध के नतीजे के तौर पर, अनुरोध और रिस्पॉन्स ऑब्जेक्ट, आपके प्लैटफ़ॉर्म (onRequest() या on_request) के अनुरोध हैंडलर को भेजे जाते हैं.

एचटीटीपी फ़ंक्शन, सिंक्रोनस होते हैं (यह कॉल करने वाले फ़ंक्शन की तरह होता है). इसलिए, आपको जल्द से जल्द जवाब भेजना चाहिए और Cloud Firestore का इस्तेमाल करके, काम को रोकना चाहिए. "मैसेज जोड़ें" एचटीटीपी फ़ंक्शन, एचटीटीपी एंडपॉइंट को टेक्स्ट वैल्यू भेजता है और उसे /messages/:documentId/original पाथ के तहत डेटाबेस में डालता है.

"बड़े अक्षरों में बदलें" फ़ंक्शन जोड़ना

"बड़े अक्षरों में बदलें" फ़ंक्शन के लिए, अपनी सोर्स फ़ाइल में ये लाइनें जोड़ें:

Node.js

// Listens for new messages added to /messages/:documentId/original
// and saves an uppercased version of the message
// to /messages/:documentId/uppercase
exports.makeuppercase = onDocumentCreated("/messages/{documentId}", (event) => {
  // Grab the current value of what was written to Firestore.
  const original = event.data.data().original;

  // Access the parameter `{documentId}` with `event.params`
  logger.log("Uppercasing", event.params.documentId, original);

  const uppercase = original.toUpperCase();

  // You must return a Promise when performing
  // asynchronous tasks inside a function
  // such as writing to Firestore.
  // Setting an 'uppercase' field in Firestore document returns a Promise.
  return event.data.ref.set({uppercase}, {merge: true});
});
index.js

Python

@firestore_fn.on_document_created(document="messages/{pushId}")
def makeuppercase(event: firestore_fn.Event[firestore_fn.DocumentSnapshot | None]) -> None:
    """Listens for new documents to be added to /messages. If the document has
    an "original" field, creates an "uppercase" field containg the contents of
    "original" in upper case."""

    # Get the value of "original" if it exists.
    if event.data is None:
        return
    try:
        original = event.data.get("original")
    except KeyError:
        # No "original" field, so do nothing.
        return

    # Set the "uppercase" field.
    print(f"Uppercasing {event.params['pushId']}: {original}")
    upper = original.upper()
    event.data.reference.update({"uppercase": upper})
main.py

"बड़े अक्षरों में बदलें" फ़ंक्शन तब काम करता है, जब Cloud Firestore को लिखा जाता है. इससे, सुनने के लिए दस्तावेज़ तय होता है. परफ़ॉर्मेंस की वजहों से, आपको ज़्यादा से ज़्यादा सटीक जानकारी देनी चाहिए.

ब्रैकेट, "पैरामीटर" और वाइल्डकार्ड को घेरते हैं. उदाहरण के लिए, {documentId}. ये ब्रैकेट, कॉलबैक में मैच होने वाले डेटा को दिखाते हैं. Cloud Firestore, नए मैसेज जोड़े जाने पर कॉलबैक को ट्रिगर करता है.

चेतावनी: ऐसी किसी भी स्थिति से बचें जिसमें फ़ंक्शन के नतीजे, फ़ंक्शन को फिर से ट्रिगर करते हुए एक अनंत लूप बनाते हैं. उदाहरण के लिए, किसी खास Cloud Firestore दस्तावेज़ से ट्रिगर होने वाला फ़ंक्शन, जो उसी पाथ पर लिखकर खत्म हो जाता है. साथ ही, यह भी पक्का करें कि फ़ंक्शन को idempoent तरीके से लिखा गया हो, ताकि किसी एक इवेंट के लिए कई बार चलाने पर एक ही नतीजा मिले.

Node.js में, Cloud Firestore इवेंट जैसे इवेंट-ड्रिवन फ़ंक्शन, एक साथ काम नहीं करते. कॉलबैक फ़ंक्शन को null, ऑब्जेक्ट या Promise में से कोई एक वैल्यू दिखानी चाहिए. अगर कोई वैल्यू नहीं दी जाती है, तो फ़ंक्शन टाइम आउट हो जाता है और गड़बड़ी का सिग्नल भेजता है. इसके बाद, फ़ंक्शन को फिर से आज़माया जाता है. सिंक करना, एक साथ काम नहीं करने वाली प्रोसेस, और प्रॉमिस देखें.

अपने फ़ंक्शन के एक्ज़ीक्यूशन को एम्युलेट करें

Firebase Local Emulator Suite की मदद से, Firebase प्रोजेक्ट में डिप्लॉय करने के बजाय, अपने लोकल डिवाइस (कंप्यूटर) पर ऐप्लिकेशन बनाए और टेस्ट किए जा सकते हैं. डेवलपमेंट के दौरान लोकल टेस्टिंग का सुझाव दिया जाता है. ऐसा इसलिए, क्योंकि इससे कोडिंग से जुड़ी गड़बड़ियों का जोखिम कम हो जाता है. इन गड़बड़ियों की वजह से, प्रोडक्शन एनवायरमेंट में लागत बढ़ सकती है. उदाहरण के लिए, अनलिमिटेड लूप.

अपने फ़ंक्शन को एमुलेट करने के लिए:

1. firebase emulators:start चलाएं और Emulator Suite UI के यूआरएल के लिए आउटपुट देखें. यह डिफ़ॉल्ट रूप से localhost:4000 पर होस्ट होता है. हालांकि, इसे आपकी मशीन पर किसी दूसरे पोर्ट पर भी होस्ट किया जा सकता है. Emulator Suite UI खोलने के लिए, अपने ब्राउज़र में वह यूआरएल डालें.

2. एचटीटीपी फ़ंक्शन के यूआरएल के लिए, firebase emulators:start कमांड का आउटपुट देखें. यह http://localhost:5001/MY_PROJECT/us-central1/addMessage जैसा ही दिखेगा. हालांकि, इसमें ये अंतर होंगे:

   1. MY_PROJECT की जगह आपका प्रोजेक्ट आईडी डाला जाएगा.
   2. आपकी लोकल मशीन पर पोर्ट अलग हो सकता है.

3. फ़ंक्शन के यूआरएल के आखिर में ?text=uppercaseme क्वेरी स्ट्रिंग जोड़ें. यह कुछ ऐसा दिखेगा: http://localhost:5001/MY_PROJECT/us-central1/addMessage?text=uppercaseme. इसके अलावा, "uppercaseme" मैसेज को अपनी पसंद के मुताबिक मैसेज में बदला जा सकता है.

4. अपने ब्राउज़र में यूआरएल को नए टैब में खोलकर, नया मैसेज बनाएं.

5. Emulator Suite UI में फ़ंक्शन के असर देखें:

   1. लॉग टैब में, आपको नए लॉग दिखेंगे. इनसे पता चलेगा कि आपके एचटीटीपी फ़ंक्शन सही तरीके से काम कर रहे हैं:

      i functions: Beginning execution of "addMessage"

      i functions: Beginning execution of "makeUppercase"

   2. Firestore टैब में, आपको एक दस्तावेज़ दिखेगा. इसमें आपका मूल मैसेज और बड़े अक्षरों में लिखा गया मैसेज दिखेगा. अगर मूल मैसेज "uppercaseme" था, तो आपको "UPPERCASEME" दिखेगा.

प्रोडक्शन एनवायरमेंट में फ़ंक्शन डिप्लॉय करना

जब आपके फ़ंक्शन, एमुलेटर में उम्मीद के मुताबिक काम करने लगें, तब उन्हें प्रोडक्शन एनवायरमेंट में डिप्लॉय, टेस्ट, और चलाया जा सकता है. ध्यान रखें कि प्रोडक्शन में डिप्लॉय करने के लिए, आपका प्रोजेक्ट Blaze के प्लान पर होना चाहिए. Cloud Functions कीमत देखें.

ट्यूटोरियल पूरा करने के लिए, अपने फ़ंक्शन डिप्लॉय करें और फिर उन्हें लागू करें.

1. अपने फ़ंक्शन डिप्लॉय करने के लिए, यह कमांड चलाएं:

    firebase deploy --only functions
    

   यह कमांड चलाने के बाद, Firebase सीएलआई किसी भी एचटीटीपी फ़ंक्शन एंडपॉइंट के लिए यूआरएल दिखाता है. आपको अपने टर्मिनल में, इस तरह की लाइन दिखेगी:

   Function URL (addMessage): https://us-central1-MY_PROJECT.cloudfunctions.net/addMessage
   

   यूआरएल में आपका प्रोजेक्ट आईडी और एचटीटीपी फ़ंक्शन के लिए कोई क्षेत्र शामिल होता है. हालांकि, आपको अभी इस बारे में चिंता करने की ज़रूरत नहीं है, लेकिन नेटवर्क के इंतज़ार का समय कम करने के लिए, कुछ प्रोडक्शन एचटीटीपी फ़ंक्शन में जगह की जानकारी देनी चाहिए.

   अगर आपको ऐक्सेस में होने वाली गड़बड़ियां मिलती हैं, जैसे कि "प्रोजेक्ट का ऐक्सेस नहीं दिया जा सका," तो अपने प्रोजेक्ट एलियासिंग की जांच करें.

2. सीएलआई से मिले यूआरएल आउटपुट का इस्तेमाल करके, टेक्स्ट क्वेरी पैरामीटर जोड़ें और उसे ब्राउज़र में खोलें:

   https://us-central1-MY_PROJECT.cloudfunctions.net/addMessage?text=uppercasemetoo
   

   यह फ़ंक्शन, ब्राउज़र को डेटाबेस की उस जगह पर मौजूद Firebase कंसोल पर रीडायरेक्ट करता है जहां टेक्स्ट स्ट्रिंग सेव की गई है. यह लिखने का इवेंट, "बड़े अक्षरों में लिखें" फ़ंक्शन को ट्रिगर करता है. यह फ़ंक्शन, स्ट्रिंग को बड़े अक्षरों में लिखता है.

फ़ंक्शन को डिप्लॉय और लागू करने के बाद, Google Cloud कंसोल में लॉग देखे जा सकते हैं. अगर आपको डेवलपमेंट या प्रोडक्शन में फ़ंक्शन मिटाने हैं, तो Firebase सीएलआई का इस्तेमाल करें.

प्रोडक्शन में, आपको फ़ंक्शन की परफ़ॉर्मेंस को ऑप्टिमाइज़ करने और लागत को कंट्रोल करने के लिए, इंस्टेंस की कम से कम और ज़्यादा से ज़्यादा संख्या सेट करनी पड़ सकती है. रनटाइम के इन विकल्पों के बारे में ज़्यादा जानने के लिए, स्केलिंग के व्यवहार को कंट्रोल करना देखें.

ध्यान दें: Firebase सीएलआई से फ़ंक्शन डिप्लॉय करने की दर सीमित होती है. Firebase सीएलआई डिप्लॉयमेंट के लिए कोटा की सीमाएं देखें.

अगले चरण

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

Cloud Functions के बारे में ज़्यादा जानने के लिए, ये काम भी किए जा सकते हैं:

• Cloud Functions के इस्तेमाल के उदाहरणों के बारे में पढ़ें.
• Cloud Functions कोडलैब आज़माएं.
• GitHub पर कोड सैंपल की समीक्षा करना और उन्हें चलाना