Firebase CLI রেফারেন্স

Firebase সিএলআই ( গিটহাব ) ফায়ারবেস প্রকল্পগুলি পরিচালনা, দেখার এবং স্থাপনের জন্য বিভিন্ন ধরণের সরঞ্জাম সরবরাহ করে।

Firebase CLI ব্যবহার করার আগে, একটি Firebase প্রকল্প সেট আপ করুন ।

CLI সেট আপ বা আপডেট করুন

Firebase সিএলআই ইনস্টল করুন

আপনার অপারেটিং সিস্টেম, অভিজ্ঞতার স্তর এবং/অথবা ব্যবহারের ক্ষেত্রের সাথে মেলে এমন একটি পদ্ধতি ব্যবহার করে আপনি Firebase CLI ইনস্টল করতে পারেন। আপনি যেভাবেই CLI ইনস্টল করুন না কেন, আপনার একই কার্যকারিতা এবং firebase কমান্ডের অ্যাক্সেস থাকবে।

উইন্ডোজ ম্যাকওএস লিনাক্স

জানালা

আপনি নিম্নলিখিত বিকল্পগুলির মধ্যে একটি ব্যবহার করে উইন্ডোজের জন্য Firebase CLI ইনস্টল করতে পারেন:

ম্যাকওএস বা লিনাক্স

আপনি নিম্নলিখিত বিকল্পগুলির মধ্যে একটি ব্যবহার করে macOS বা Linux এর জন্য Firebase CLI ইনস্টল করতে পারেন:

লগ ইন করুন এবং Firebase CLI পরীক্ষা করুন

CLI ইনস্টল করার পর, আপনাকে অবশ্যই প্রমাণীকরণ করতে হবে। তারপর আপনি আপনার Firebase প্রকল্পগুলি তালিকাভুক্ত করে প্রমাণীকরণ নিশ্চিত করতে পারেন।

1. নিম্নলিখিত কমান্ডটি চালিয়ে আপনার গুগল অ্যাকাউন্ট ব্যবহার করে ফায়ারবেসে লগ ইন করুন:

   firebase login

   এই কমান্ডটি আপনার স্থানীয় মেশিনকে Firebase-এর সাথে সংযুক্ত করে এবং আপনার Firebase প্রকল্পগুলিতে অ্যাক্সেস প্রদান করে।

2. আপনার Firebase প্রকল্পগুলি তালিকাভুক্ত করে পরীক্ষা করুন যে CLI সঠিকভাবে ইনস্টল করা আছে এবং আপনার অ্যাকাউন্ট অ্যাক্সেস করছে। নিম্নলিখিত কমান্ডটি চালান:

   firebase projects:list

   প্রদর্শিত তালিকাটি Firebase কনসোলে তালিকাভুক্ত Firebase প্রকল্পগুলির মতোই হওয়া উচিত।

সর্বশেষ CLI সংস্করণে আপডেট করুন

সাধারণত, আপনি সবচেয়ে হালনাগাদকৃত Firebase CLI সংস্করণটি ব্যবহার করতে চান।

আপনি কীভাবে CLI সংস্করণ আপডেট করবেন তা আপনার অপারেটিং সিস্টেম এবং আপনি কীভাবে CLI ইনস্টল করেছেন তার উপর নির্ভর করে।

Firebase সিএলআই আনইনস্টল করুন

আপনি কীভাবে CLI আনইনস্টল করবেন তা আপনার অপারেটিং সিস্টেম এবং আপনি কীভাবে CLI ইনস্টল করেছেন তার উপর নির্ভর করে।

CI সিস্টেমের সাথে CLI ব্যবহার করুন

CI সিস্টেমের সাথে CLI ব্যবহার করার সময় আমরা আপনাকে অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র ব্যবহার করে প্রমাণীকরণ করার পরামর্শ দিচ্ছি।

(প্রস্তাবিত) অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র ব্যবহার করুন

Firebase CLI অ্যাপ্লিকেশন ডিফল্ট শংসাপত্রগুলি সেট করা থাকলে তা সনাক্ত করবে এবং ব্যবহার করবে। CI এবং অন্যান্য হেডলেস পরিবেশে CLI প্রমাণীকরণের সবচেয়ে সহজ উপায় হল অ্যাপ্লিকেশন ডিফল্ট শংসাপত্রগুলি সেট আপ করা ।

(উত্তরাধিকার) FIREBASE_TOKEN ব্যবহার করুন

বিকল্পভাবে, আপনি FIREBASE_TOKEN ব্যবহার করে প্রমাণীকরণ করতে পারেন। এটি অ্যাপ্লিকেশন ডিফল্ট শংসাপত্রের চেয়ে কম নিরাপদ এবং আর সুপারিশ করা হয় না।

1. ব্রাউজারযুক্ত মেশিনে, Firebase CLI ইনস্টল করুন ।

2. নিম্নলিখিত কমান্ডটি চালিয়ে সাইন ইন প্রক্রিয়া শুরু করুন:

   firebase login:ci

3. প্রদত্ত URL টি দেখুন, তারপর একটি Google অ্যাকাউন্ট ব্যবহার করে লগ ইন করুন।

4. একটি নতুন রিফ্রেশ টোকেন প্রিন্ট করুন। বর্তমান CLI সেশন প্রভাবিত হবে না।

5. আপনার CI সিস্টেমে আউটপুট টোকেনটি একটি নিরাপদ কিন্তু অ্যাক্সেসযোগ্য উপায়ে সংরক্ষণ করুন।

6. firebase কমান্ড চালানোর সময় এই টোকেনটি ব্যবহার করুন। আপনি নিম্নলিখিত দুটি বিকল্পের যেকোনো একটি ব্যবহার করতে পারেন:

   • বিকল্প ১: টোকেনটিকে পরিবেশ পরিবর্তনশীল FIREBASE_TOKEN হিসেবে সংরক্ষণ করুন। আপনার সিস্টেম স্বয়ংক্রিয়ভাবে টোকেনটি ব্যবহার করবে।

   • বিকল্প ২: আপনার CI সিস্টেমে --token TOKEN ফ্ল্যাগ দিয়ে সমস্ত firebase কমান্ড চালান।
     টোকেন লোডিংয়ের ক্ষেত্রে এটি অগ্রাধিকারের ক্রম: পতাকা, পরিবেশ পরিবর্তনশীল, পছন্দসই ফায়ারবেস প্রকল্প।

একটি ফায়ারবেস প্রকল্প শুরু করুন

CLI ব্যবহার করে সম্পাদিত অনেক সাধারণ কাজ, যেমন Firebase প্রকল্পে স্থাপনের জন্য, একটি প্রকল্প ডিরেক্টরি প্রয়োজন। আপনি firebase init কমান্ড ব্যবহার করে একটি প্রকল্প ডিরেক্টরি স্থাপন করেন। একটি প্রকল্প ডিরেক্টরি সাধারণত আপনার সোর্স কন্ট্রোল রুটের মতো একই ডিরেক্টরি হয় এবং firebase init চালানোর পরে, ডিরেক্টরিতে একটি firebase.json কনফিগারেশন ফাইল থাকে।

একটি নতুন Firebase প্রকল্প শুরু করতে, আপনার অ্যাপের ডিরেক্টরির মধ্যে থেকে নিম্নলিখিত কমান্ডটি চালান:

firebase init

    {
      "$schema": "https://raw.githubusercontent.com/firebase/firebase-tools/master/schema/firebase-config.json",
      "hosting": {
        "public": "public",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ],
        "cleanUrls": true,
        "trailingSlash": false
      },
      "apphosting": {
        "backendId": "my-app",
        "rootDir": "backend",
        "ignore": [
          "firebase.json",
          "**/.*",
          "**/node_modules/**"
        ]
      },
      "firestore": {
        "rules": "firestore.rules",
        "indexes": "firestore.indexes.json"
      },
      "storage": {
        "rules": "storage.rules"
      },
      "database": {
        "rules": "database.rules.json"
      },
      "dataconnect": {
        "source": "dataconnect",
        "location": "us-central1"
      },
      "functions": [
        {
          "source": "functions",
          "codebase": "default",
          "ignore": [
            "**/.*",
            "**/node_modules/**"
          ],
          "predeploy": [
            "npm --prefix \"$RESOURCE_DIR\" run lint",
            "npm --prefix \"$RESOURCE_DIR\" run build"
          ]
        }
      ],
      "emulators": {
        "auth": {
          "port": 9099
        },
        "functions": {
          "port": 5001
        },
        "firestore": {
          "port": 8080
        },
        "hosting": {
          "port": 5000
        },
        "storage": {
          "port": 9199
        },
        "ui": {
          "enabled": true,
          "port": 4000
        },
        "singleProjectMode": true
      },
      "extensions": {
        "my-storage-resizer": "firebase/storage-resize-images@^0.1.0"
      },
      "remoteconfig": {
        "template": "remoteconfig.template.json"
      }
    }

      "firestore": [
        {
          "database": "(default)",
          "rules": "firestore.default.rules",
          "indexes": "firestore.default.indexes.json"
        },
        {
          "database": "ecommerce",
          "rules": "firestore.ecommerce.rules",
          "indexes": "firestore.ecommerce.indexes.json"
        }
      ],

"ignore": [
  ".git",
  ".runtimeconfig.json",
  "firebase-debug.log",
  "firebase-debug.*.log",
  "node_modules"
]

firebase use --add

আপনি যেকোনো CLI কমান্ড দিয়ে --project ফ্ল্যাগ পাস করে সক্রিয় প্রকল্প হিসেবে ব্যবহৃত জিনিসগুলিকে ওভাররাইড করতে পারেন। উদাহরণস্বরূপ: আপনি আপনার CLI কে এমন একটি Firebase প্রকল্পের বিরুদ্ধে চালানোর জন্য সেট করতে পারেন যা আপনি staging উপনাম নির্ধারণ করেছেন। আপনি যদি prod উপনাম নির্ধারণ করা Firebase প্রকল্পের বিরুদ্ধে একটি একক কমান্ড চালাতে চান, তাহলে আপনি firebase deploy --project=prod চালাতে পারেন, উদাহরণস্বরূপ,।

উৎস নিয়ন্ত্রণ এবং প্রকল্পের উপনাম

সাধারণভাবে, আপনার দলকে প্রকল্পের উপনামগুলি ভাগ করে নেওয়ার অনুমতি দেওয়ার জন্য আপনার .firebaserc ফাইলটি সোর্স কন্ট্রোলে পরীক্ষা করা উচিত। তবে, ওপেন সোর্স প্রকল্প বা স্টার্টার টেমপ্লেটের জন্য, আপনার সাধারণত .firebaserc ফাইলটি পরীক্ষা করা উচিত নয়।

যদি আপনার এমন কোনও ডেভেলপমেন্ট প্রজেক্ট থাকে যা শুধুমাত্র আপনার ব্যবহারের জন্য, তাহলে আপনি প্রতিটি কমান্ডের সাথে --project ফ্ল্যাগটি পাস করতে পারেন অথবা Firebase প্রজেক্টে কোনও উপনাম বরাদ্দ না করেই firebase use PROJECT_ID চালাতে পারেন।

স্থানীয়ভাবে আপনার Firebase প্রকল্প পরিবেশন এবং পরীক্ষা করুন

আপনি আপনার Firebase প্রকল্পটি স্থানীয়ভাবে হোস্ট করা URL গুলিতে প্রোডাকশনে স্থাপন করার আগে দেখতে এবং পরীক্ষা করতে পারেন। আপনি যদি শুধুমাত্র নির্বাচিত বৈশিষ্ট্যগুলি পরীক্ষা করতে চান, তাহলে আপনি firebase serve কমান্ডের একটি ফ্ল্যাগে কমা দ্বারা পৃথক করা তালিকা ব্যবহার করতে পারেন।

আপনি যদি নিম্নলিখিত কাজগুলির যেকোনো একটি করতে চান তবে আপনার স্থানীয় প্রকল্প ডিরেক্টরির রুট থেকে নিম্নলিখিত কমান্ডটি চালান:

• আপনার Firebase-হোস্টেড অ্যাপের স্ট্যাটিক কন্টেন্ট দেখুন।
• Firebase Hosting জন্য গতিশীল কন্টেন্ট তৈরি করতে Cloud Functions ব্যবহার করুন এবং আপনি আপনার প্রোডাকশন (স্থাপিত) HTTP ফাংশনগুলি স্থানীয় URL-এ Hosting অনুকরণ করতে ব্যবহার করতে চান।

firebase serve --only hosting

স্থানীয় HTTP ফাংশন ব্যবহার করে আপনার প্রকল্প অনুকরণ করুন

স্থানীয় HTTP ফাংশন ব্যবহার করে আপনার প্রকল্প অনুকরণ করতে আপনার প্রকল্প ডিরেক্টরি থেকে নিম্নলিখিত যেকোনো কমান্ড চালান।

• স্থানীয় URL-এ পরীক্ষার জন্য HTTP ফাংশন এবং হোস্টিং অনুকরণ করতে, নিম্নলিখিত কমান্ডগুলির যেকোনো একটি ব্যবহার করুন:

  firebase serve

  firebase serve --only functions,hosting // uses a flag

• শুধুমাত্র HTTP ফাংশন অনুকরণ করতে, নিম্নলিখিত কমান্ডটি ব্যবহার করুন:

  firebase serve --only functions

অন্যান্য স্থানীয় ডিভাইস থেকে পরীক্ষা করুন

ডিফল্টরূপে, firebase serve শুধুমাত্র localhost থেকে আসা অনুরোধের জবাব দেয়। এর অর্থ হল আপনি আপনার কম্পিউটারের ওয়েব ব্রাউজার থেকে আপনার হোস্ট করা সামগ্রী অ্যাক্সেস করতে পারবেন কিন্তু আপনার নেটওয়ার্কের অন্যান্য ডিভাইস থেকে নয়। আপনি যদি অন্যান্য স্থানীয় ডিভাইস থেকে পরীক্ষা করতে চান, তাহলে --host পতাকাটি ব্যবহার করুন, যেমন:

firebase serve --host 0.0.0.0  // accepts requests to any host

একটি Firebase প্রকল্পে স্থাপন করুন

Firebase CLI আপনার Firebase প্রকল্পে কোড এবং সম্পদ স্থাপনের কাজ পরিচালনা করে, যার মধ্যে রয়েছে:

• আপনার Firebase Hosting সাইটের নতুন প্রকাশনা
• Cloud Functions for Firebase
• Firebase Data Connect জন্য নতুন বা আপডেট করা স্কিমা এবং সংযোগকারী
• Firebase Realtime Database জন্য Security Rules
• Cloud Storage for Firebase Security Rules
• Cloud Firestore জন্য Security Rules
• Cloud Firestore জন্য সূচী

একটি Firebase প্রকল্পে স্থাপন করতে, আপনার প্রকল্প ডিরেক্টরি থেকে নিম্নলিখিত কমান্ডটি চালান:

firebase deploy

আপনি ঐচ্ছিকভাবে আপনার প্রতিটি স্থাপনার জন্য একটি মন্তব্য যোগ করতে পারেন। এই মন্তব্যটি আপনার প্রকল্পের Firebase Hosting পৃষ্ঠায় অন্যান্য স্থাপনার তথ্যের সাথে প্রদর্শিত হবে। উদাহরণস্বরূপ:

firebase deploy -m "Deploying the best new feature ever."

যখন আপনি firebase deploy কমান্ড ব্যবহার করেন, তখন নিম্নলিখিত বিষয়গুলি সম্পর্কে সচেতন থাকুন:

• একটি প্রজেক্ট ডিরেক্টরি থেকে রিসোর্স স্থাপন করতে, প্রজেক্ট ডিরেক্টরিতে একটি firebase.json ফাইল থাকতে হবে । এই ফাইলটি স্বয়ংক্রিয়ভাবে firebase init কমান্ড দ্বারা আপনার জন্য তৈরি করা হয়।

• ডিফল্টরূপে, firebase deploy আপনার প্রোজেক্ট ডিরেক্টরিতে সমস্ত স্থাপনযোগ্য রিসোর্সের জন্য একটি রিলিজ তৈরি করে। নির্দিষ্ট Firebase পরিষেবা বা বৈশিষ্ট্য স্থাপন করতে, আংশিক স্থাপনা ব্যবহার করুন ।

নির্দিষ্ট Firebase পরিষেবা স্থাপন করুন

যদি আপনি শুধুমাত্র নির্দিষ্ট Firebase পরিষেবা বা বৈশিষ্ট্য স্থাপন করতে চান, তাহলে আপনি firebase deploy কমান্ডের একটি ফ্ল্যাগে কমা দ্বারা পৃথক করা তালিকা ব্যবহার করতে পারেন। উদাহরণস্বরূপ, নিম্নলিখিত কমান্ডটি Firebase Hosting সামগ্রী এবং Cloud Storage Security Rules স্থাপন করে।

firebase deploy --only hosting,storage

নিম্নলিখিত টেবিলে আংশিক স্থাপনার জন্য উপলব্ধ পরিষেবা এবং বৈশিষ্ট্যগুলির তালিকা দেওয়া হয়েছে। ফ্ল্যাগের নামগুলি আপনার firebase.json কনফিগারেশন ফাইলের কীগুলির সাথে মিলে যায়।

Security Rules জন্য স্থাপনার দ্বন্দ্ব

Firebase Realtime Database , Cloud Storage for Firebase এবং Cloud Firestore জন্য, আপনি আপনার স্থানীয় প্রকল্প ডিরেক্টরিতে বা Firebase কনসোলে Security Rules সংজ্ঞায়িত করতে পারেন।

স্থাপনার দ্বন্দ্ব এড়াতে আরেকটি বিকল্প হল আংশিক স্থাপনা ব্যবহার করা এবং শুধুমাত্র Firebase কনসোলে Security Rules সংজ্ঞায়িত করা।

প্রি-ডিপ্লয় এবং পোস্ট-ডিপ্লয় স্ক্রিপ্টেড টাস্ক সেট আপ করুন

আপনি শেল স্ক্রিপ্টগুলিকে firebase deploy কমান্ডের সাথে সংযুক্ত করে predeploy বা postdeploy কাজগুলি সম্পাদন করতে পারেন। উদাহরণস্বরূপ, একটি predeploy স্ক্রিপ্ট TypeScript কোডকে JavaScript-এ স্থানান্তর করতে পারে এবং একটি postdeploy হুক Firebase Hosting এ নতুন সাইটের সামগ্রী স্থাপনের বিষয়ে প্রশাসকদের অবহিত করতে পারে।

predeploy বা postdeploy হুক সেট আপ করতে, আপনার firebase.json কনফিগারেশন ফাইলে bash স্ক্রিপ্ট যোগ করুন। আপনি সরাসরি firebase.json ফাইলে সংক্ষিপ্ত স্ক্রিপ্ট সংজ্ঞায়িত করতে পারেন, অথবা আপনি আপনার প্রোজেক্ট ডিরেক্টরিতে থাকা অন্যান্য ফাইলগুলি উল্লেখ করতে পারেন।

উদাহরণস্বরূপ, নিম্নলিখিত স্ক্রিপ্টটি হল firebase.json এক্সপ্রেশন যা একটি পোস্টডিপ্লয় টাস্কের জন্য যা Firebase Hosting এ সফলভাবে স্থাপনের পরে একটি Slack বার্তা পাঠায়।

"hosting": {
  // ...

  "postdeploy": "./messageSlack.sh 'Just deployed to Firebase Hosting'",
  "public": "public"
}

messageSlack.sh স্ক্রিপ্ট ফাইলটি প্রজেক্ট ডিরেক্টরিতে থাকে এবং দেখতে এরকম:

curl -X POST -H 'Content-type: application/json' --data '{"text":"$1"}'
     \https://SLACK_WEBHOOK_URL

আপনি যে কোনও অ্যাসেটের জন্য predeploy এবং postdeploy হুক সেট আপ করতে পারেন যা আপনি স্থাপন করতে পারেন । মনে রাখবেন যে firebase deploy চালানো আপনার firebase.json ফাইলে সংজ্ঞায়িত সমস্ত predeploy এবং postdeploy টাস্ক ট্রিগার করে। শুধুমাত্র একটি নির্দিষ্ট Firebase পরিষেবার সাথে সম্পর্কিত কাজগুলি চালানোর জন্য, আংশিক স্থাপন কমান্ড ব্যবহার করুন ।

predeploy এবং postdeploy উভয় হুকই টার্মিনালে স্ক্রিপ্টের স্ট্যান্ডার্ড আউটপুট এবং এরর স্ট্রিম প্রিন্ট করে। ব্যর্থতার ক্ষেত্রে, নিম্নলিখিত বিষয়গুলি লক্ষ্য করুন:

• যদি একটি প্রিডপ্লয় হুক প্রত্যাশা অনুযায়ী সম্পন্ন করতে ব্যর্থ হয়, তাহলে ডিপ্লয়মেন্ট বাতিল করা হয়।
• যদি কোনও কারণে স্থাপনা ব্যর্থ হয়, তাহলে পোস্টডিপ্লয় হুকগুলি ট্রিগার করা হয় না।

পরিবেশের ভেরিয়েবল

প্রিডপ্লয় এবং পোস্টডিপ্লয় হুকগুলিতে চলমান স্ক্রিপ্টগুলির মধ্যে, নিম্নলিখিত পরিবেশ ভেরিয়েবলগুলি উপলব্ধ:

• $GCLOUD_PROJECT : সক্রিয় প্রকল্পের প্রকল্প আইডি
• $PROJECT_DIR : firebase.json ফাইল ধারণকারী রুট ডিরেক্টরি
• $RESOURCE_DIR : (শুধুমাত্র hosting এবং functions স্ক্রিপ্টের জন্য) যে ডিরেক্টরিতে Hosting বা Cloud Functions রিসোর্স স্থাপন করা হবে তার অবস্থান

স্থাপনার কোটা

এটা সম্ভব (যদিও অসম্ভাব্য) যে আপনি এমন একটি কোটা অতিক্রম করতে পারেন যা আপনার Firebase স্থাপনার ক্রিয়াকলাপের হার বা ভলিউমকে সীমিত করে। উদাহরণস্বরূপ, খুব বেশি সংখ্যক ফাংশন স্থাপন করার সময়, আপনি একটি HTTP 429 Quota ত্রুটি বার্তা পেতে পারেন। এই ধরনের সমস্যা সমাধানের জন্য, আংশিক স্থাপনা ব্যবহার করে দেখুন।

একটি স্থাপনা রোল ব্যাক করুন

আপনার প্রোজেক্টের Firebase Hosting পৃষ্ঠা থেকে নির্বাচিত রিলিজের জন্য রোলব্যাক অ্যাকশন নির্বাচন করে আপনি একটি Firebase Hosting স্থাপনা রোলব্যাক করতে পারেন।

Firebase Realtime Database , Cloud Storage for Firebase , অথবা Cloud Firestore এর জন্য Security Rules এর রিলিজ রোল ব্যাক করা সম্ভব নয়।

কমান্ড রেফারেন্স

CLI প্রশাসনিক কমান্ড

প্রকল্প ব্যবস্থাপনা কমান্ড

স্থাপনা এবং স্থানীয় উন্নয়ন

এই কমান্ডগুলি আপনাকে আপনার Firebase Hosting সাইট স্থাপন এবং ইন্টারঅ্যাক্ট করতে দেয়।

App Distribution কমান্ড

App Hosting কমান্ড

Authentication (ব্যবহারকারী ব্যবস্থাপনা) কমান্ড

Cloud Firestore কমান্ড

Cloud Functions for Firebase

আরও তথ্যের জন্য, পরিবেশ কনফিগারেশন ডকুমেন্টেশন দেখুন।

Crashlytics কমান্ড

Data Connect কমান্ড

এই কমান্ডগুলি এবং তাদের ব্যবহারের ক্ষেত্রে Data Connect CLI রেফারেন্স গাইডে আরও বিশদে আলোচনা করা হয়েছে।

Extensions কমান্ড

Extensions প্রকাশক কমান্ড

Hosting কমান্ড

Realtime Database কমান্ড

মনে রাখবেন যে আপনি Firebase কনসোলে অথবা সাধারণ firebase init ওয়ার্কফ্লো বা নির্দিষ্ট firebase init database ফ্লো ব্যবহার করে আপনার প্রাথমিক, ডিফল্ট Realtime Database ইনস্ট্যান্স তৈরি করতে পারেন।

একবার ইনস্ট্যান্স তৈরি হয়ে গেলে, আপনি CLI ব্যবহার করে Manage এবং ইন্টারঅ্যাক্ট করুন -এ বর্ণিত পদ্ধতিতে সেগুলি পরিচালনা করতে পারেন।

Remote Config কমান্ড