আপনার এনভায়রনমেন্ট (ফার্স্ট জেনারেশন) কনফিগার করা

প্রায়ই আপনার ফাংশনের জন্য অতিরিক্ত কনফিগারেশনের প্রয়োজন হবে, যেমন থার্ড-পার্টি API কী বা টিউন করা যায় এমন সেটিংস। Cloud Functions-এর জন্য Firebase SDK-তে বিল্ট-ইন এনভায়রনমেন্ট কনফিগারেশন আছে, যার সাহায্যে আপনার প্রোজেক্টের জন্য এই ধরনের ডেটা সহজে স্টোর ও রিট্রিভ করা যায়।

আপনি এইসব বিকল্পের মধ্যে থেকে বেছে নিতে পারবেন:

  • প্যারামিটারাইজড কনফিগারেশন (বেশিরভাগ পরিস্থিতির জন্য সাজেস্ট করা হয়)। এটি প্যারামিটার সহ স্ট্রংলি-টাইপড এনভায়রনমেন্ট কনফিগারেশন প্রদান করে যা ডিপ্লয় করার সময় যাচাই করা হয়। এর ফলে, সমস্যা প্রতিরোধ করা যায় এবং ডিবাগিং সহজ হয়।
  • এনভায়রনমেন্ট ভেরিয়েবেল-এর ফাইল-ভিত্তিক কনফিগারেশন। এই পদ্ধতিতে, আপনি ম্যানুয়ালি একটি dotenv ফাইল তৈরি করেন, যাতে এনভায়রনমেন্ট ভেরিয়েবল লোড করা যায়।

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

প্যারামিটারাইজড কনফিগারেশন

Cloud Functions for Firebase আপনার কোডবেসের মধ্যে ডিক্লেরেটিভভাবে কনফিগারেশন প্যারামিটার সংজ্ঞায়িত করার জন্য একটি ইন্টারফেস প্রদান করে। এইসব প্যারামিটারের ভ্যালু ফাংশন ডিপ্লয়মেন্টের সময়, ডিপ্লয়মেন্ট ও রানটাইম বিকল্প সেট করার সময় এবং এক্সিকিউশনের সময় উপলভ্য থাকে। এর অর্থ হল, সব প্যারামিটারের সঠিক ভ্যালু না থাকলে, CLI ডিপ্লয়মেন্ট ব্লক করবে।

আপনার কোডে প্যারামিটার নির্ধারণ করতে, এই মডেলটি অনুসরণ করুন:

const functions = require('firebase-functions/v1');
const { defineInt, defineString } = require('firebase-functions/params');

// Define some parameters
const minInstancesConfig = defineInt('HELLO_WORLD_MININSTANCES');
const welcomeMessage = defineString('WELCOME_MESSAGE');

// To use configured parameters inside the config for a function, provide them
// directly. To use them at runtime, call .value() on them.
export const helloWorld = functions.runWith({ minInstances: minInstancesConfig}).https.onRequest(
  (req, res) => {
    res.send(`${welcomeMessage.value()}! I am a function.`);
  }
);

প্যারামিটারাইজড কনফিগারেশন ভেরিয়েবল সহ কোনও ফাংশন ডিপ্লয় করার সময়, Firebase CLI প্রথমে স্থানীয় .env ফাইল থেকে সেগুলির ভ্যালু লোড করার চেষ্টা করে। সেগুলি যদি সেইসব ফাইলে না থাকে এবং কোনও default সেট করা না থাকে, তাহলে CLI ডিপ্লয়মেন্টের সময় ভ্যালুর জন্য প্রম্পট করবে এবং তারপর অটোমেটিক সেগুলির ভ্যালু আপনার functions/ ডিরেক্টরিতে .env.<project_ID> নামের একটি .env ফাইলে সেভ করবে:

$ firebase deploy
i  functions: preparing codebase default for deployment
? Enter a string value for ENVIRONMENT: prod
i  functions: Writing new parameter values to disk: .env.projectId
…
$ firebase deploy
i  functions: Loaded environment variables from .env.projectId

আপনার ডেভেলপমেন্ট ওয়ার্কফ্লোর উপর নির্ভর করে, ভার্সন কন্ট্রোলে জেনারেট করা .env.<project_ID> ফাইল যোগ করা উপযোগী হতে পারে।

গ্লোবাল স্কোপে প্যারামিটার ব্যবহার করা হচ্ছে

ডেপ্লয়মেন্টের সময়, আপনার প্যারামিটারে প্রকৃত ভ্যালু থাকার আগে আপনার ফাংশন কোড লোড ও পরীক্ষা করা হয়। এর অর্থ হল গ্লোবাল স্কোপের সময় প্যারামিটার ভ্যালু ফেচ করার ফলে ডিপ্লয়মেন্ট ব্যর্থ হয়। যেসব ক্ষেত্রে আপনি গ্লোবাল ভ্যালু ইনিশিয়ালাইজ করার জন্য প্যারামিটার ব্যবহার করতে চান, সেখানে ইনিশিয়ালাইজেশন কলব্যাক onInit() ব্যবহার করুন। প্রোডাকশনে কোনও ফাংশন রান করার আগে এই কলব্যাক রান করে, তবে ডিপ্লয় করার সময় এটি কল করা হয় না, তাই এটি প্যারামিটারের ভ্যালু অ্যাক্সেস করার নিরাপদ জায়গা।

  const { GoogleGenerativeAI } = require('@google/generative-ai');
  const { defineSecret } = require('firebase-functions/params');
  const { onInit } = require('firebase-functions/v1');

  const apiKey = defineSecret('GOOGLE_API_KEY');

  let genAI;
  onInit(() => {
    genAI = new GoogleGenerativeAI(apiKey.value());
  })

CLI আচরণ কনফিগার করুন

Options অবজেক্টের মাধ্যমে প্যারামিটার কনফিগার করা যেতে পারে যা CLI কীভাবে ভ্যালুর জন্য প্রম্পট করবে তা কন্ট্রোল করে। নিম্নলিখিত উদাহরণটি ফোন নম্বরের ফর্ম্যাট যাচাই করার জন্য বিকল্প সেট করে, একটি সহজ নির্বাচন বিকল্প প্রদান করে এবং Firebase প্রোজেক্ট থেকে অটোমেটিক একটি নির্বাচন বিকল্প পূরণ করে:

const { defineString } = require('firebase-functions/params');

const welcomeMessage = defineString('WELCOME_MESSAGE', {default: 'Hello World',
description: 'The greeting that is returned to the caller of this function'});

const onlyPhoneNumbers = defineString('PHONE_NUMBER', {input: {text:
{validationRegex: /\d{3}-\d{3}-\d{4}/, validationErrorMessage: "Please enter
a phone number in the format XXX-YYY-ZZZZ"}}});

const selectedOption = defineString('PARITY', {input: {select: {options:
[{value: "odd"}, {value: "even"}]}}})

const storageBucket = defineString('BUCKET', {input: {resource: {type:
"storage.googleapis.com/Bucket"}}, description: "This will automatically
populate the selector field with the deploying Cloud Project’s
storage buckets"})

প্যারামিটারের ধরন

প্যারামিটারাইজড কনফিগারেশন প্যারামিটার ভ্যালুর জন্য শক্তিশালী টাইপিং প্রদান করে এবং Cloud Secret Manager থেকে সিক্রেটও সাপোর্ট করে। যেসব ধরন কাজ করে সেগুলি হল:

  • রহস্য
  • স্ট্রিং
  • Boolean
  • পূর্ণসংখ্যা
  • Float

প্যারামিটার নির্ধারণ করার ফাংশন সম্পর্কে তথ্য পেতে params নেমস্পেস রেফারেন্স দেখুন।

প্যারামিটারের ভ্যালু ও এক্সপ্রেশন

ডিপ্লয় করার সময় এবং ফাংশন এক্সিকিউট করার সময়, উভয় ক্ষেত্রেই Firebase আপনার প্যারামিটার মূল্যায়ন করে। এই ডুয়াল এনভায়রনমেন্টের কারণে, প্যারামিটারের মান তুলনা করার সময় এবং আপনার ফাংশনের জন্য রানটাইম বিকল্প সেট করতে সেগুলি ব্যবহার করার সময় কিছু অতিরিক্ত সতর্কতা অবলম্বন করতে হবে।

রানটাইম বিকল্প হিসেবে আপনার ফাংশনে প্যারামিটার পাস করতে, এটি সরাসরি পাস করুন:

const functions = require('firebase-functions/v1');
const { defineInt} = require('firebase-functions/params');
const minInstancesConfig = defineInt('HELLO_WORLD_MININSTANCES');

export const helloWorld = functions.runWith({ minInstances: minInstancesConfig}).https.onRequest(
  (req, res) => {
    //…

এছাড়াও, কোন বিকল্পটি বেছে নিতে হবে তা জানার জন্য আপনাকে যদি কোনও প্যারামিটারের সাথে তুলনা করতে হয়, তাহলে আপনাকে ভ্যালু চেক করার পরিবর্তে বিল্ট-ইন কম্প্যারেটর ব্যবহার করতে হবে:

const functions = require('firebase-functions/v1');
const { defineBool } = require('firebase-functions/params');
const environment = params.defineString(‘ENVIRONMENT’, {default: ‘dev’});

// use built-in comparators
const minInstancesConfig =environment.equals('PRODUCTION').thenElse(10, 1);
export const helloWorld = functions.runWith({ minInstances: minInstancesConfig}).https.onRequest(
  (req, res) => {
    //…

রানটাইমে শুধুমাত্র ব্যবহার করা হয় এমন প্যারামিটার ও প্যারামিটার এক্সপ্রেশন, তাদের value ফাংশনের মাধ্যমে অ্যাক্সেস করা যেতে পারে:

const functions = require('firebase-functions/v1');
const { defineString } = require('firebase-functions/params');
const welcomeMessage = defineString('WELCOME_MESSAGE');

// To use configured parameters inside the config for a function, provide them
// directly. To use them at runtime, call .value() on them.
export const helloWorld = functions.https.onRequest(
 (req, res) => {
    res.send(`${welcomeMessage.value()}! I am a function.`);
  }
);

বিল্ট-ইন প্যারামিটার

Cloud Functions SDK তিনটি প্রি-ডিফাইন করা প্যারামিটার অফার করে, যা firebase-functions/params সাবপ্যাকেজ থেকে উপলভ্য:

  • projectID — যে ক্লাউড প্রোজেক্টে ফাংশনটি চলছে।
  • databaseURL — ফাংশনের সাথে যুক্ত রিয়েলটাইম ডেটাবেস ইনস্ট্যান্সের URL (Firebase প্রোজেক্টে চালু করা থাকলে)।
  • storageBucket — ফাংশনের সাথে যুক্ত Cloud Storage বাকেট (Firebase প্রোজেক্টে চালু করা থাকলে)।

এগুলি সব দিক থেকে ব্যবহারকারীর দ্বারা নির্ধারিত স্ট্রিং প্যারামিটারের মতো কাজ করে, তবে যেহেতু Firebase CLI-এর কাছে এগুলির ভ্যালু সবসময় জানা থাকে, তাই ডেপ্লয়মেন্টের সময় এগুলির ভ্যালু কখনও প্রম্পট করা হয় না বা .env ফাইলে সেভ করা হয় না।

গোপন প্যারামিটার

Secret ধরনের প্যারামিটার, যা defineSecret() ব্যবহার করে সংজ্ঞায়িত করা হয়েছে, তা স্ট্রিং প্যারামিটারকে প্রতিনিধিত্ব করে যার ভ্যালু Cloud Secret Manager-এ স্টোর করা আছে। লোকাল .env ফাইলের সাথে মিলিয়ে দেখার পরিবর্তে এবং না থাকলে ফাইলে নতুন ভ্যালু লেখার পরিবর্তে, সিক্রেট প্যারামিটার Cloud Secret Manager-এ আছে কিনা তা চেক করে এবং ডেপ্লয়মেন্টের সময় নতুন সিক্রেটের ভ্যালুর জন্য ইন্টার‍্যাক্টিভ প্রম্পট দেখায়।

এইভাবে সংজ্ঞায়িত সিক্রেট প্যারামিটারগুলি অবশ্যই পৃথক ফাংশনের সাথে আবদ্ধ হতে হবে যেগুলির এগুলিতে অ্যাক্সেস থাকা উচিত:

const functions = require('firebase-functions/v1');
const { defineSecret } = require('firebase-functions/params');
const discordApiKey = defineSecret('DISCORD_API_KEY');

export const postToDiscord = functions.runWith({ secrets: [discordApiKey] }).https.onRequest(
  (req, res) => {
    const apiKey = discordApiKey.value();
    //…

এনভায়রনমেন্ট ভেরিয়েবল

Cloud Functions for Firebase-এ dotenv ফাইল ফর্ম্যাট কাজ করে, যার মাধ্যমে .env ফাইলে উল্লেখ করা এনভায়রনমেন্ট ভেরিয়েবেল আপনার অ্যাপ্লিকেশন রানটাইমে লোড করা যায়। ডেপ্লয় করা হয়ে গেলে, এনভায়রনমেন্ট ভেরিয়েবল process.env ইন্টারফেসের মাধ্যমে পড়া যাবে।

এইভাবে আপনার এনভায়রনমেন্ট কনফিগার করতে, আপনার প্রোজেক্টে একটি .env ফাইল তৈরি করুন, প্রয়োজনীয় ভেরিয়েবেল যোগ করুন এবং ডিপ্লয় করুন:

  1. আপনার functions/ ডিরেক্টরিতে একটি .env ফাইল তৈরি করুন:

    # Directory layout:
    #   my-project/
    #     firebase.json
    #     functions/
    #       .env
    #       package.json
    #       index.js
    
  2. এডিট করার জন্য .env ফাইলটি খুলুন এবং আপনার পছন্দের কী যোগ করুন। যেমন:

    PLANET=Earth
    AUDIENCE=Humans
    
  3. ফাংশন ডিপ্লয় করুন এবং এনভায়রনমেন্ট ভেরিয়েবল লোড হয়েছে কিনা তা যাচাই করুন:

    firebase deploy --only functions
    # ...
    # i functions: Loaded environment variables from .env.
    # ...
    

আপনার কাস্টম এনভায়রনমেন্ট ভেরিয়েবল ডিপ্লয় করা হয়ে গেলে, আপনার ফাংশন কোড process.env সিনট্যাক্স ব্যবহার করে সেগুলি অ্যাক্সেস করতে পারবে:

// Responds with "Hello Earth and Humans"
exports.hello = functions.https.onRequest((request, response) => {
  response.send(`Hello ${process.env.PLANET} and ${process.env.AUDIENCE}`);
});

পরিবেশ সংক্রান্ত ভেরিয়েবলের একাধিক সেট ডিপ্লয় করা হচ্ছে

আপনার Firebase প্রোজেক্টের জন্য (যেমন স্টেজিং বনাম প্রোডাকশন) এনভায়রনমেন্ট ভেরিয়েবলের বিকল্প সেট প্রয়োজন হলে, .env.<project or alias> ফাইল তৈরি করে সেখানে প্রোজেক্ট-নির্দিষ্ট এনভায়রনমেন্ট ভেরিয়েবল লিখুন। .env এবং প্রোজেক্ট-নির্দিষ্ট .env ফাইল (যদি থাকে) থেকে এনভায়রনমেন্ট ভেরিয়েবল সব ডিপ্লয় করা ফাংশনে অন্তর্ভুক্ত করা হবে।

যেমন, কোনও প্রোজেক্টে এই তিনটি ফাইল থাকতে পারে, যেগুলিতে ডেভেলপমেন্ট ও প্রোডাকশনের জন্য সামান্য আলাদা ভ্যালু রয়েছে:

.env .env.dev .env.prod
PLANET=Earth

AUDIENCE=Humans

AUDIENCE=Dev Humans AUDIENCE=Prod Humans

এইসব আলাদা ফাইলে দেওয়া ভ্যালুর ভিত্তিতে, আপনার ফাংশনের সাথে ডিপ্লয় করা এনভায়রনমেন্ট ভেরিয়েবলের সেট আপনার টার্গেট প্রোজেক্টের উপর নির্ভর করে আলাদা হবে:

$ firebase use dev
$ firebase deploy --only functions
i functions: Loaded environment variables from .env, .env.dev.
# Deploys functions with following user-defined environment variables:
#   PLANET=Earth
#   AUDIENCE=Dev Humans

$ firebase use prod
$ firebase deploy --only functions
i functions: Loaded environment variables from .env, .env.prod.
# Deploys functions with following user-defined environment variables:
#   PLANET=Earth
#   AUDIENCE=Prod Humans

রিজার্ভ করা এনভায়রনমেন্ট ভেরিয়েবল

কিছু এনভায়রনমেন্ট ভেরিয়েবেল কী ইন্টার্নাল ব্যবহারের জন্য রিজার্ভ করা আছে। আপনার .env ফাইলে এইসব কী ব্যবহার করবেন না:

  • X_GOOGLE_ দিয়ে শুরু হওয়া সব কী
  • EXT_ দিয়ে শুরু হওয়া সব কী
  • FIREBASE_ দিয়ে শুরু হওয়া সব কী
  • নিম্নলিখিত তালিকা থেকে যেকোনও কী:
  • CLOUD_RUNTIME_CONFIG
  • ENTRY_POINT
  • GCP_PROJECT
  • GCLOUD_PROJECT
  • GOOGLE_CLOUD_PROJECT
  • FUNCTION_TRIGGER_TYPE
  • FUNCTION_NAME
  • FUNCTION_MEMORY_MB
  • FUNCTION_TIMEOUT_SEC
  • FUNCTION_IDENTITY
  • FUNCTION_REGION
  • FUNCTION_TARGET
  • FUNCTION_SIGNATURE_TYPE
  • K_SERVICE
  • K_REVISION
  • পোর্ট
  • K_CONFIGURATION

সংবেদনশীল কনফিগারেশন তথ্য স্টোর এবং অ্যাক্সেস করা

.env ফাইলে সেভ করা এনভায়রনমেন্ট ভেরিয়েবেল ফাংশন কনফিগারেশনের জন্য ব্যবহার করা যেতে পারে, তবে ডেটাবেস ক্রেডেনশিয়াল বা API কী-এর মতো সংবেদনশীল তথ্য সেভ করার জন্য এটিকে নিরাপদ পদ্ধতি হিসেবে বিবেচনা করা উচিত নয়। আপনি সোর্স কন্ট্রোলে .env ফাইল চেক করলে, এটি বিশেষভাবে গুরুত্বপূর্ণ।

সংবেদনশীল কনফিগারেশন তথ্য স্টোর করতে আপনাকে সাহায্য করার জন্য, Cloud Functions for Firebase Google Cloud-এর সাথে ইন্টিগ্রেট করে Secret Manager. এই এনক্রিপ্ট করা পরিষেবা কনফিগারেশন ভ্যালু নিরাপদে স্টোর করে, তবে প্রয়োজন হলে আপনার ফাংশন থেকে সহজে অ্যাক্সেস করার অনুমতি দেয়।

সিক্রেট তৈরি ও ব্যবহার করা

সিক্রেট তৈরি করতে, Firebase CLI ব্যবহার করুন।

সিক্রেট তৈরি ও ব্যবহার করতে:

  1. আপনার লোকাল প্রোজেক্ট ডিরেক্টরির রুট থেকে, নিম্নলিখিত কমান্ড রান করুন:

    firebase functions:secrets:set SECRET_NAME

  2. SECRET_NAME-এর জন্য একটি মান লিখুন।

    CLI একটি সফল মেসেজ দেখায় এবং সতর্ক করে যে পরিবর্তন কার্যকর করার জন্য আপনাকে অবশ্যই ফাংশন ডিপ্লয় করতে হবে।

  3. ডেপ্লয় করার আগে, আপনার ফাংশন কোড যাতে runWith প্যারামিটার ব্যবহার করে সিক্রেট অ্যাক্সেস করতে পারে তা নিশ্চিত করুন:

    exports.processPayment = functions
      // Make the secret available to this function
      .runWith({ secrets: ["SECRET_NAME"] })
      .onCall((data, context) => {
        const myBillingService = initializeBillingService(
          // reference the secret value
          process.env.SECRET_NAME
        );
        // Process the payment
      });
  4. Cloud Functions ডিপ্লয় করুন:

    firebase deploy --only functions

এখন আপনি অন্য যেকোনও এনভায়রনমেন্ট ভেরিয়েবেলের মতো এটি অ্যাক্সেস করতে পারবেন। বিপরীতভাবে, অন্য কোনও ফাংশন যা runWith-এ সিক্রেট নির্দিষ্ট করে না, সেটি সিক্রেট অ্যাক্সেস করার চেষ্টা করলে, এটি একটি অনির্দিষ্ট ভ্যালু পায়:

  exports.anotherEndpoint = functions.https.onRequest((request, response) => {
    response.send(`The secret API key is ${process.env.SECRET_NAME}`);
    // responds with "The secret API key is undefined" because the `runWith` parameter is missing
  });

আপনার ফাংশন ডিপ্লয় করা হয়ে গেলে, এটি সিক্রেট ভ্যালু অ্যাক্সেস করতে পারবে। শুধুমাত্র যেসব ফাংশন বিশেষভাবে তাদের runWith প্যারামিটারে একটি গোপন তথ্য অন্তর্ভুক্ত করে, সেগুলি একটি এনভায়রনমেন্ট ভেরিয়েবল হিসেবে সেই গোপন তথ্য অ্যাক্সেস করতে পারবে। এটি আপনাকে নিশ্চিত করতে সাহায্য করে যে গোপন ভ্যালু শুধুমাত্র যেখানে প্রয়োজন সেখানে উপলভ্য, যার ফলে দুর্ঘটনাবশত গোপনীয়তা ফাঁস হওয়ার ঝুঁকি কমে।

সিক্রেট ম্যানেজ করা

আপনার সিক্রেট ম্যানেজ করতে Firebase CLI ব্যবহার করুন। এইভাবে সিক্রেট ম্যানেজ করার সময়, মনে রাখবেন যে কিছু CLI পরিবর্তনের জন্য আপনাকে সংশ্লিষ্ট ফাংশন পরিবর্তন এবং/অথবা আবার ডিপ্লয় করতে হবে। বিশেষত:

  • আপনি যখনই কোনও সিক্রেটের জন্য নতুন ভ্যালু সেট করেন, তখন আপনাকে অবশ্যই সেই সিক্রেটকে রেফারেন্স করে এমন সমস্ত ফাংশন আবার ডিপ্লয় করতে হবে যাতে তারা লেটেস্ট ভ্যালু বেছে নিতে পারে।
  • আপনি কোনও সিক্রেট মুছে দিলে, আপনার ডিপ্লয় করা কোনও ফাংশন যেন সেই সিক্রেট রেফারেন্স না করে তা নিশ্চিত করুন। যেসব ফাংশন মুছে ফেলা হয়েছে এমন গোপন ভ্যালু ব্যবহার করে, সেগুলি কোনও বিজ্ঞপ্তি ছাড়াই কাজ করা বন্ধ করে দেবে।

সিক্রেট ম্যানেজমেন্টের জন্য Firebase CLI কমান্ডের সারসংক্ষেপ এখানে দেওয়া হল:

# Change the value of an existing secret
firebase functions:secrets:set SECRET_NAME

# View the value of a secret
functions:secrets:access SECRET_NAME

# Destroy a secret
functions:secrets:destroy SECRET_NAME

# View all secret versions and their state
functions:secrets:get SECRET_NAME

# Automatically clean up all secrets that aren't referenced by any of your functions
functions:secrets:prune

access এবং destroy কমান্ডের জন্য, আপনি নির্দিষ্ট ভার্সন ম্যানেজ করতে ঐচ্ছিক ভার্সন প্যারামিটার প্রদান করতে পারেন। যেমন:

functions:secrets:access SECRET_NAME[@VERSION]

এইসব অপারেশন সম্পর্কে আরও তথ্যের জন্য, CLI সহায়তা দেখতে কমান্ডের সাথে -h পাস করুন।

সিক্রেট কীভাবে বিল করা হয়

Secret Manager-এ কোনও খরচ ছাড়াই ৬টি অ্যাক্টিভ সিক্রেট ভার্সন ব্যবহার করা যায়। এর অর্থ হল, আপনি কোনও খরচ ছাড়াই Firebase প্রোজেক্টে প্রতি মাসে ৬টি সিক্রেট রাখতে পারবেন।

ডিফল্ট হিসেবে, Firebase CLI অটোমেটিক অব্যবহৃত সিক্রেট ভার্সন উপযুক্ত জায়গায় ধ্বংস করার চেষ্টা করে, যেমন আপনি যখন সিক্রেটের নতুন ভার্সন সহ ফাংশন ডিপ্লয় করেন। এছাড়াও, আপনি functions:secrets:destroy এবং functions:secrets:prune ব্যবহার করে অব্যবহৃত সিক্রেট সক্রিয়ভাবে ক্লিন-আপ করতে পারবেন।

Secret Manager-এ কোনও সিক্রেটের ক্ষেত্রে প্রতি মাসে ১০,০০০টি বিল না করা অ্যাক্সেস অপারেশন করা যায়। ফাংশন ইনস্ট্যান্স প্রতিবার কোল্ড স্টার্ট করার সময় শুধুমাত্র তাদের secrets বিকল্পে নির্দিষ্ট করা সিক্রেট পড়ে। আপনার কাছে অনেক ফাংশন ইনস্ট্যান্স থাকলে অনেক সিক্রেট পড়া, আপনার প্রোজেক্ট এই ভাতা ছাড়িয়ে যেতে পারে, যে পয়েন্টে আপনাকে প্রতি ১০,০০০ অ্যাক্সেস অপারেশনের জন্য $০.০৩ চার্জ করা হবে।

আরও তথ্যের জন্য, Secret Manager-এর দাম দেখুন।

ইমুলেটর সাপোর্ট

dotenv-এর সাথে এনভায়রনমেন্ট কনফিগারেশন এমনভাবে ডিজাইন করা হয়েছে যাতে এটি লোকাল Cloud Functions এমুলেটর-এর সাথে ইন্টারঅপারেট করতে পারে।

লোকাল Cloud Functions এমুলেটর ব্যবহার করার সময়, আপনি .env.local ফাইল সেট-আপ করে আপনার প্রোজেক্টের জন্য এনভায়রনমেন্ট ভেরিয়েবল ওভাররাইড করতে পারবেন। .env.local-এর কন্টেন্ট .env এবং প্রোজেক্ট-নির্দিষ্ট .env ফাইলের চেয়ে বেশি অগ্রাধিকার পায়।

যেমন, কোনও প্রোজেক্টে এই তিনটি ফাইল থাকতে পারে, যেগুলিতে ডেভেলপমেন্ট ও লোকাল টেস্টিংয়ের জন্য সামান্য আলাদা ভ্যালু থাকে:

.env .env.dev .env.local

PLANET=Earth

AUDIENCE=Humans

AUDIENCE=Dev Humans AUDIENCE=Local Humans

লোকাল কন্টেক্সটে শুরু করা হলে, এমুলেটর দেখানো অনুযায়ী এনভায়রনমেন্ট ভেরিয়েবল লোড করে:

  $ firebase emulators:start
  i  emulators: Starting emulators: functions
  # Starts emulator with following environment variables:
  #  PLANET=Earth
  #  AUDIENCE=Local Humans

Cloud Functions এমুলেটরে গোপন তথ্য ও ক্রেডেনশিয়াল

Cloud Functions এমুলেটর সংবেদনশীল কনফিগারেশন তথ্য স্টোর ও অ্যাক্সেস করার জন্য সিক্রেট ব্যবহার করার সুবিধা দেয়। ডিফল্ট হিসেবে, এমুলেটর অ্যাপ্লিকেশন ডিফল্ট ক্রেডেনশিয়াল ব্যবহার করে আপনার প্রোডাকশন সিক্রেট অ্যাক্সেস করার চেষ্টা করে। CI এনভায়রনমেন্টের মতো কিছু পরিস্থিতিতে, অনুমতির উপর বিধিনিষেধ থাকার কারণে এমুলেটর হয়ত গোপন ভ্যালু অ্যাক্সেস করতে পারবে না।

এনভায়রনমেন্ট ভেরিয়েবেলের জন্য Cloud Functions এমুলেটর সাপোর্টের মতো, আপনি .secret.local ফাইল সেট-আপ করে সিক্রেট ভ্যালু ওভাররাইড করতে পারবেন। এর ফলে, আপনি সহজেই লোকালি আপনার ফাংশন পরীক্ষা করতে পারবেন, বিশেষ করে আপনার কাছে সিক্রেট ভ্যালুর অ্যাক্সেস না থাকলে।

রানটাইম কনফিগারেশন থেকে মাইগ্রেট করুন

functions.config API বন্ধ করা হয়েছে এবং ২০২৭ সালের মার্চ মাসে এটি সরিয়ে দেওয়া হবে। সেই তারিখের পরে, functions.config-এর সাথে ডিপ্লয়মেন্ট করা যাবে না।

ডিপ্লয়মেন্ট সংক্রান্ত সমস্যা এড়াতে, Firebase CLI ব্যবহার করে আপনার কনফিগারেশন Cloud Secret Manager-এ মাইগ্রেট করুন। আপনার কনফিগারেশন মাইগ্রেট করার জন্য সবচেয়ে দক্ষ এবং নিরাপদ উপায় হিসাবে এটি করার জন্য বিশেষভাবে সাজেস্ট করা হচ্ছে।

  1. Firebase CLI-এর মাধ্যমে কনফিগারেশন এক্সপোর্ট করা

    আপনার আগে থেকে থাকা এনভায়রনমেন্ট কনফিগারেশন Cloud Secret Manager-এ নতুন সিক্রেটে এক্সপোর্ট করতে config export কমান্ড ব্যবহার করুন:

    $ firebase functions:config:export
    i  This command retrieves your Runtime Config values (accessed via functions.config())
       and exports them as a Secret Manager secret.
    
    i  Fetching your existing functions.config() from your project...  ✔
       Fetched your existing functions.config().
    
    i  Configuration to be exported:
    ⚠  This may contain sensitive data. Do not share this output.
    
    {
       ...
    }
    
    ✔ What would you like to name the new secret for your configuration? RUNTIME_CONFIG
    
    ✔  Created new secret version projects/project/secrets/RUNTIME_CONFIG/versions/1```
    
  2. সিক্রেট বাইন্ড করতে ফাংশন কোড আপডেট করুন

    Cloud Secret Manager-এ নতুন সিক্রেটে স্টোর করা কনফিগারেশন ব্যবহার করতে, আপনার ফাংশন সোর্সে defineJsonSecret API ব্যবহার করুন। এছাড়াও, যেসব ফাংশনে সিক্রেট প্রয়োজন, সেগুলিতে সিক্রেট বাউন্ড করা আছে কিনা তা নিশ্চিত করুন।

    আগে

    const functions = require("firebase-functions/v1");
    
    exports.myFunction = functions.https.onRequest((req, res) => {
      const apiKey = functions.config().someapi.key;
      // ...
    });
    

    পরে

    const { onRequest } = require("firebase-functions/v2/https");
    const { defineJsonSecret } = require("firebase-functions/params");
    
    const config = defineJsonSecret("RUNTIME_CONFIG");
    
    exports.myFunction = onRequest(
      // Bind secret to your function
      { secrets: [config] },
      (req, res) => {
        // Access secret values via .value()
        const apiKey = config.value().someapi.key;
        // ...
    });
    
  3. ফাংশন ডিপ্লয় করুন

    পরিবর্তনগুলি প্রয়োগ করতে এবং গোপন অনুমতিগুলি বাইন্ড করতে আপনার আপডেট করা ফাংশনগুলি ডিপ্লয় করুন।

    firebase deploy --only functions:<your-function-name>
    

অটোমেটিক পপুলেট হওয়া এনভায়রনমেন্ট ভেরিয়েবল

ফাংশন রানটাইম এবং লোকাল এমুলেটেড ফাংশনে অটোমেটিক পপুলেট হওয়া এনভায়রনমেন্ট ভেরিয়েবল আছে। এর মধ্যে Google Cloud দ্বারা পপুলেট করা ভেরিয়েবল, এবং Firebase-নির্দিষ্ট এনভায়রনমেন্ট ভেরিয়েবল অন্তর্ভুক্ত:

process.env.FIREBASE_CONFIG: নিম্নলিখিত Firebase প্রোজেক্ট কনফিগারেশন সংক্রান্ত তথ্য প্রদান করে:

{
  databaseURL: 'https://DATABASE_NAME.firebaseio.com',
  storageBucket: 'PROJECT_ID.firebasestorage.app',
  projectId: 'PROJECT_ID'
}

মনে রাখবেন যে আপনার আসল Firebase কনফিগারেশনের ভ্যালু আপনার প্রোজেক্টে প্রভিশন করা রিসোর্সের উপর নির্ভর করে আলাদা হতে পারে।

আপনি কোনও আর্গুমেন্ট ছাড়াই Firebase Admin SDK শুরু করলে, এই কনফিগারেশন অটোমেটিক প্রয়োগ করা হয়। আপনি যদি জাভাস্ক্রিপ্টে ফাংশন লেখেন, তাহলে এইভাবে শুরু করুন:

const admin = require('firebase-admin');
admin.initializeApp();

আপনি TypeScript-এ ফাংশন লিখলে, এইভাবে শুরু করুন:

import * as functions from 'firebase-functions/v1';
import * as admin from 'firebase-admin';
import 'firebase-functions/v1';
admin.initializeApp();

পরিষেবা অ্যাকাউন্টের ক্রেডেনশিয়াল ব্যবহার করে ডিফল্ট প্রোজেক্ট কনফিগারেশনের সাথে অ্যাডমিন SDK শুরু করতে হলে, আপনি ফাইল থেকে ক্রেডেনশিয়াল লোড করে FIREBASE_CONFIG-এ এইভাবে যোগ করতে পারেন:

serviceAccount = require('./serviceAccount.json');

const adminConfig = JSON.parse(process.env.FIREBASE_CONFIG);
adminConfig.credential = admin.credential.cert(serviceAccount);
admin.initializeApp(adminConfig);