হোস্টিং REST API ব্যবহার করে আপনার সাইটে স্থাপন করুন

Firebase Hosting REST API আপনার ফায়ারবেস-হোস্টেড সাইটগুলিতে প্রোগ্রাম্যাটিক এবং কাস্টমাইজযোগ্য ডেপ্লয়মেন্ট সক্ষম করে। নতুন বা আপডেট করা Hosting কন্টেন্ট এবং কনফিগারেশন ডেপ্লয় করতে এই REST API ব্যবহার করুন।

ডেপ্লয়মেন্টের জন্য Firebase CLI ব্যবহারের বিকল্প হিসেবে, আপনি Firebase Hosting REST API ব্যবহার করে প্রোগ্রাম্যাটিকভাবে আপনার সাইটের জন্য অ্যাসেটের একটি নতুন version তৈরি করতে, সেই ভার্সনে ফাইল আপলোড করতে এবং তারপর আপনার সাইটে ভার্সনটি ডেপ্লয় করতে পারেন।

উদাহরণস্বরূপ, Firebase Hosting REST API ব্যবহার করে আপনি যা করতে পারেন:

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

• ডেভেলপার টুলের সাথে সংযুক্ত করুন। আপনি আপনার টুলে এমন একটি অপশন তৈরি করতে পারেন, যার মাধ্যমে মাত্র এক ক্লিকে আপনার ওয়েব অ্যাপ প্রজেক্টগুলো Firebase Hosting এ ডেপ্লয় করা যাবে (উদাহরণস্বরূপ, একটি IDE-এর মধ্যে থাকা ডেপ্লয় বাটনে ক্লিক করে)।

• স্ট্যাটিক কন্টেন্ট তৈরি হলে তা স্বয়ংক্রিয়ভাবে ডেপ্লয় হয়। যখন কোনো প্রসেস প্রোগ্রাম্যাটিকভাবে স্ট্যাটিক কন্টেন্ট তৈরি করে (উদাহরণস্বরূপ, ব্যবহারকারীর তৈরি কন্টেন্ট যেমন একটি উইকি বা একটি সংবাদ নিবন্ধ), তখন আপনি সেই তৈরি হওয়া কন্টেন্টকে ডাইনামিকভাবে সার্ভ করার পরিবর্তে স্ট্যাটিক ফাইল হিসেবে ডেপ্লয় করতে পারেন। এটি আপনার ব্যয়বহুল কম্পিউটিং শক্তি বাঁচায় এবং আপনার ফাইলগুলিকে আরও স্কেলেবল উপায়ে সার্ভ করে।

এই নির্দেশিকাটি প্রথমে বর্ণনা করে কিভাবে API সক্রিয়, প্রমাণীকরণ এবং অনুমোদন করতে হয়। এরপর এই নির্দেশিকাটি একটি উদাহরণের মাধ্যমে ধাপে ধাপে দেখায় কিভাবে একটি Firebase Hosting সংস্করণ তৈরি করতে হয়, সেই সংস্করণে প্রয়োজনীয় ফাইল আপলোড করতে হয় এবং সবশেষে সংস্করণটি স্থাপন করতে হয়।

আপনি সম্পূর্ণ Hosting REST API রেফারেন্স ডকুমেন্টেশন থেকেও এই REST API সম্পর্কে আরও জানতে পারেন।

শুরু করার আগে: REST API সক্রিয় করুন।

আপনাকে অবশ্যই গুগল এপিআই কনসোলে Firebase Hosting REST API সক্রিয় করতে হবে:

1. Google APIs কনসোলে Firebase Hosting API পৃষ্ঠাটি খুলুন।

2. নির্দেশিত হলে আপনার ফায়ারবেস প্রজেক্টটি নির্বাচন করুন।

3. Firebase Hosting API পেজে Enable- এ ক্লিক করুন।

ধাপ ১: এপিআই অনুরোধগুলি প্রমাণীকরণ ও অনুমোদন করার জন্য একটি অ্যাক্সেস টোকেন নিন।

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

আপনি আপনার Firebase প্রোজেক্টের সমস্ত সার্ভিস অ্যাকাউন্ট দেখতে পারেন এখানে। settings > পরিষেবা অ্যাকাউন্ট ট্যাব ।

একটি সার্ভিস অ্যাকাউন্টকে প্রমাণীকরণ করতে এবং ফায়ারবেস সার্ভিসগুলো অ্যাক্সেস করার জন্য অনুমোদন দিতে, আপনাকে অবশ্যই JSON ফরম্যাটে একটি প্রাইভেট কী ফাইল তৈরি করতে হবে।

আপনার পরিষেবা অ্যাকাউন্টের জন্য একটি ব্যক্তিগত কী ফাইল তৈরি করতে:

1. Firebase কনসোলে, এখানে যান settings > পরিষেবা অ্যাকাউন্ট ট্যাব ।

2. Generate New Private Key-তে ক্লিক করুন, তারপর Generate Key-তে ক্লিক করে নিশ্চিত করুন।

3. কী-টি ধারণকারী JSON ফাইলটি নিরাপদে সংরক্ষণ করুন।

আপনার পছন্দের ভাষার জন্য গুগল অথ লাইব্রেরির সাথে আপনার ফায়ারবেস ক্রেডেনশিয়াল ব্যবহার করে একটি স্বল্পস্থায়ী OAuth 2.0 অ্যাক্সেস টোকেন পুনরুদ্ধার করুন:

const {google} = require('googleapis');
function getAccessToken() {
  return new Promise(function(resolve, reject) {
    var key = require('./service-account.json');
    var jwtClient = new google.auth.JWT(
      key.client_email,
      null,
      key.private_key,
      SCOPES,
      null
    );
    jwtClient.authorize(function(err, tokens) {
      if (err) {
        reject(err);
        return;
      }
      resolve(tokens.access_token);
    });
  });
}

def _get_access_token():
  """Retrieve a valid access token that can be used to authorize requests.

  :return: Access token.
  """
  credentials = ServiceAccountCredentials.from_json_keyfile_name(
      'service-account.json', SCOPES)
  access_token_info = credentials.get_access_token()
  return access_token_info.access_token

private static String getAccessToken() throws IOException {
  GoogleCredential googleCredential = GoogleCredential
      .fromStream(new FileInputStream("service-account.json"))
      .createScoped(Arrays.asList(SCOPES));
  googleCredential.refreshToken();
  return googleCredential.getAccessToken();
}

আপনার অ্যাক্সেস টোকেনের মেয়াদ শেষ হয়ে গেলে, একটি হালনাগাদ অ্যাক্সেস টোকেন পাওয়ার জন্য টোকেন রিফ্রেশ মেথডটি স্বয়ংক্রিয়ভাবে কল করা হয়।

ধাপ ২: নিশ্চিত করুন যে আপনার প্রোজেক্টের একটি ডিফল্ট Hosting সাইট আছে।

Firebase Hosting এ আপনার প্রথমবার ডেপ্লয়মেন্টের আগে, আপনার ফায়ারবেস প্রজেক্টের একটি ডিফল্ট Hosting SITE থাকতে হবে।

1. sites.list এন্ডপয়েন্টটি কল করে যাচাই করুন আপনার প্রোজেক্টে আগে থেকেই কোনো ডিফল্ট Hosting সাইট আছে কিনা।

   উদাহরণস্বরূপ:

   cURL কমান্ড

   curl -H "Content-Type: application/json" \
          -H "Authorization: Bearer ACCESS_TOKEN" \
   
   https://firebasehosting.googleapis.com/v1beta1/projects/PROJECT_ID/sites
   

   কাঁচা HTTPS অনুরোধ

   Host: firebasehosting.googleapis.com
   
   POST /v1beta1/projects/PROJECT_ID/sites HTTP/1.1
   Authorization: Bearer ACCESS_TOKEN
   Content-Type: application/json

   • যদি সাইটগুলোর কোনো একটির "type": "DEFAULT_SITE" হয়, তাহলে আপনার প্রোজেক্টে আগে থেকেই একটি ডিফল্ট Hosting সাইট আছে। এই ধাপের বাকি অংশটি বাদ দিন এবং পরবর্তী ধাপে চলে যান: আপনার সাইটের জন্য একটি নতুন ভার্সন তৈরি করুন ।

   • যদি আপনি একটি খালি অ্যারে পান, তাহলে আপনার কোনো ডিফল্ট Hosting সাইট নেই। এই ধাপের বাকি অংশ সম্পূর্ণ করুন।

2. আপনার ডিফল্ট Hosting সাইটের জন্য SITE_ID নির্ধারণ করুন। এই SITE_ID নির্ধারণ করার সময় নিম্নলিখিত বিষয়গুলি মনে রাখবেন:

   • এই SITE_ID আপনার ডিফল্ট Firebase সাবডোমেইন তৈরি করতে ব্যবহৃত হয়:
     SITE_ID .web.app এবং SITE_ID .firebaseapp.com .

   • একটি SITE_ID নিম্নলিখিত শর্তাবলী রয়েছে:

     • হোস্টনেম লেবেলটি অবশ্যই বৈধ হতে হবে, অর্থাৎ এতে . , _ , ইত্যাদি থাকতে পারবে না।
     • অবশ্যই ৩০ অক্ষর বা তার কম হতে হবে।
     • ফায়ারবেসের মধ্যে অবশ্যই বিশ্বব্যাপী অনন্য হতে হবে

   মনে রাখবেন যে আমরা প্রায়শই আপনার ডিফল্ট Hosting সাইটের জন্য SITE_ID হিসেবে আপনার প্রজেক্ট আইডি ব্যবহার করার পরামর্শ দিই। কীভাবে এই আইডিটি খুঁজে বের করবেন তা "আন্ডারস্ট্যান্ড ফায়ারবেস প্রজেক্টস" অংশে জানুন।

3. আপনার পছন্দের SITE_ID siteId প্যারামিটার হিসেবে ব্যবহার করে sites.create এন্ডপয়েন্টটি কল করার মাধ্যমে আপনার ডিফল্ট Hosting সাইটটি তৈরি করুন।

   উদাহরণস্বরূপ:

   cURL কমান্ড

   curl -H "Content-Type: application/json" \
          -H "Authorization: Bearer ACCESS_TOKEN" \
   
   https://firebasehosting.googleapis.com/v1beta1/projects/PROJECT_ID/sites?siteId=SITE_ID
   

   কাঁচা HTTPS অনুরোধ

   Host: firebasehosting.googleapis.com
   
   POST /v1beta1/projects/PROJECT_ID/sites?siteId=SITE_ID
   Authorization: Bearer ACCESS_TOKEN
   Content-Type: application/json

   sites.create এ এই API কলটি নিম্নলিখিত JSON ফেরত দেয়:

   {
     "name": "projects/PROJECT_ID/sites/SITE_ID",
     "defaultUrl": "https://SITE_ID.web.app",
     "type": "DEFAULT_SITE"
   }

ধাপ ৩: আপনার সাইটের জন্য একটি নতুন সংস্করণ তৈরি করুন

আপনার প্রথম এপিআই কলটি হলো আপনার সাইটের জন্য একটি নতুন Version তৈরি করা। এই গাইডের পরবর্তী অংশে, আপনি এই ভার্সনে ফাইল আপলোড করবেন এবং তারপর এটি আপনার সাইটে ডেপ্লয় করবেন।

1. যে সাইটে আপনি ডেপ্লয় করতে চান, তার SITE_ID নির্ধারণ করুন।

2. কল করার সময় আপনার SITE_ID ব্যবহার করে versions.create এন্ডপয়েন্টটি কল করুন।

   (ঐচ্ছিক) আপনি কলে একটি Firebase Hosting কনফিগারেশন অবজেক্টও পাস করতে পারেন, যার মধ্যে একটি হেডার সেট করার সুবিধাও রয়েছে যা একটি নির্দিষ্ট সময়ের জন্য সমস্ত ফাইল ক্যাশ করে রাখে।

   উদাহরণস্বরূপ:

   cURL কমান্ড

   curl -H "Content-Type: application/json" \
          -H "Authorization: Bearer ACCESS_TOKEN" \
          -d '{
                "config": {
                  "headers": [{
                    "glob": "**",
                    "headers": {
                      "Cache-Control": "max-age=1800"
                    }
                  }]
                }
              }' \
   https://firebasehosting.googleapis.com/v1beta1/sites/SITE_ID/versions
   

   কাঁচা HTTPS অনুরোধ

   Host: firebasehosting.googleapis.com
   
   POST /v1beta1/sites/SITE_ID/versions HTTP/1.1
   Authorization: Bearer ACCESS_TOKEN
   Content-Type: application/json
   Content-Length: 134
   
   {
     "config": {
       "headers": [{
         "glob": "**",
         "headers": {
           "Cache-Control": "max-age=1800"
         }
       }]
     }
   }

versions.create এ এই API কলটি নিম্নলিখিত JSON ফেরত দেয়:

{
  "name": "sites/SITE_ID/versions/VERSION_ID",
  "status": "CREATED",
  "config": {
    "headers": [{
      "glob": "**",
      "headers": {
        "Cache-Control": "max-age=1800"
      }
    }]
  }
}

{
  "uploadRequiredHashes": [
    "490423ebae5dcd6c2df695aea79f1f80555c62e535a2808c8115a6714863d083",
    "59cae17473d7dd339fe714f4c6c514ab4470757a4fe616dfdb4d81400addf315"
  ],
  "uploadUrl": "https://upload-firebasehosting.googleapis.com/upload/sites/SITE_ID/versions/VERSION_ID/files"
}

curl -H "Content-Type: application/json" \
       -H "Authorization: Bearer ACCESS_TOKEN" \
       -X PATCH \
       -d '{"status": "FINALIZED"}' \
https://firebasehosting.googleapis.com/v1beta1/sites/SITE_ID/versions/VERSION_ID?update_mask=status

Host: firebasehosting.googleapis.com

PATCH /v1beta1/sites/SITE_ID/versions/VERSION_ID?update_mask=status HTTP/1.1
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
Content-Length: 23

{"status": "FINALIZED"}

{
  "name": "sites/SITE_ID/versions/VERSION_ID",
  "status": "FINALIZED",
  "config": {
    "headers": [{
      "glob": "**",
      "headers": {"Cache-Control": "max-age=1800"}
    }]
  },
  "createTime": "2018-12-02T13:41:56.905743Z",
  "createUser": {
    "email": "SERVICE_ACCOUNT_EMAIL@SITE_ID.iam.gserviceaccount.com"
  },
  "finalizeTime": "2018-12-02T14:56:13.047423Z",
  "finalizeUser": {
    "email": "USER_EMAIL@DOMAIN.tld"
  },
  "fileCount": "5",
  "versionBytes": "114951"
}

curl -H "Authorization: Bearer ACCESS_TOKEN" \
       -X POST
https://firebasehosting.googleapis.com/v1beta1/sites/SITE_ID/releases?versionName=sites/SITE_ID/versions/VERSION_ID

Host: firebasehosting.googleapis.com

POST /v1beta1/sites/SITE_ID/releases?versionName=sites/SITE_ID/versions/VERSION_ID HTTP/1.1
Authorization: Bearer ACCESS_TOKEN

{
  "name": "sites/SITE_ID/releases/RELEASE_ID",
  "version": {
    "name": "sites/SITE_ID/versions/VERSION_ID",
    "status": "FINALIZED",
    "config": {
    "headers": [{
      "glob": "**",
      "headers": {"Cache-Control": "max-age=1800"}
    }]
  }
  },
  "type": "DEPLOY",
  "releaseTime": "2018-12-02T15:14:37Z"
}