अगर आपने अपने-आप रोल आउट होने की सुविधा चालू की है, तो GitHub रिपॉज़िटरी में लाइव ब्रांच में नया कमिट पुश करने पर, App Hosting आपके ऐप्लिकेशन का नया वर्शन अपने-आप रोल आउट कर देता है. रोल आउट की स्थिति देखने के लिए, Firebase कंसोल या App Hosting GitHub की जांच पर जाएं.
इसके अलावा, App Hosting में सीआई/सीडी इंटिग्रेशन या किसी अन्य मामले में, मैन्युअल तरीके से रोल आउट ट्रिगर करने की सुविधा भी मिलती है.
रोलआउट देखना
Firebase console से, आपके ऐप्लिकेशन के सभी रोलआउट के बारे में ज़्यादा जानकारी मिलती है.
होस्टिंग और सर्वरलेस> App Hosting पर जाएं. इसके बाद, उस बैकएंड के लिए देखें को चुनें जिसके रोलआउट आपको देखने हैं. बैकएंड के लिए रोलआउट टैब में, इस बैकएंड के लिए सभी रोलआउट के इतिहास की सूची वाली टेबल दिखती है.
हर रोलआउट एंट्री में, Cloud Build जॉब और रोलआउट को ट्रिगर करने वाले बदलाव या कमिट के लिंक शामिल होते हैं. साथ ही, इसमें लेखक, रोलआउट बनाने की तारीख, और रोलआउट की स्थिति के बारे में बुनियादी जानकारी शामिल होती है.
- Cloud Build जॉब, बिल्ड एनवायरमेंट है, जहां App Hosting आपके ऐप्लिकेशन का बिल्ड कमांड चलाता है. बिल्ड आईडी पर क्लिक करके, Cloud Build लॉग ऐक्सेस किए जा सकते हैं.
- बदलाव, GitHub कमिट या कोई अन्य कार्रवाई है, जिसकी वजह से रोलआउट ट्रिगर हुआ.
मैन्युअल तरीके से रोलआउट ट्रिगर करना
अगर आपको GitHub सोर्स से रोलआउट को मैन्युअल तरीके से ट्रिगर करना है, तो नया कमिट पुश किए बिना, Firebase कंसोल या Firebase सीएलआई से रोलआउट बनाया जा सकता है. यह इन मामलों में काम आता है:
- स्टैटिक कॉन्टेंट को फिर से जनरेट करने के लिए मजबूर करना.
- सीआई/सीडी सिस्टम को रोलआउट ट्रिगर करने की अनुमति देना.
- प्रोडक्शन रोलआउट को खास तारीखों या समय तक सीमित करना.
Firebase कंसोल में रोलआउट ट्रिगर करने के लिए:
- Firebase कंसोल में, होस्टिंग और सर्वरलेस > App Hosting पर जाएं.
- जिस बैकएंड के लिए आपको रोलआउट बनाना है उसके लिए, देखें पर क्लिक करें.
- बैकएंड डैशबोर्ड की खास जानकारी में, रोलआउट बनाएं को चुनें.
- डिप्लॉय करने के लिए ब्रांच चुनें.
- डिप्लॉय करने के लिए, कमिट चुनें. इसके लिए, सबसे नया कमिट या कमिट आईडी के हिसाब से कोई पुराना कमिट चुना जा सकता है.
- बनाएं को चुनें. रोलआउट के इतिहास की टेबल में, रोलआउट की स्थिति और बिल्ड नंबर दिखता है. रोल आउट की प्रोसेस पूरी होने के बाद, यह रोल आउट मौजूदा रोल आउट के तौर पर दिखता है.
Firebase सीएलआई में रोलआउट ट्रिगर करने के लिए, यहां दिया गया कमांड चलाएं. इसके बाद, पूछे जाने पर रोलआउट के लिए ब्रांच चुनें:
firebase apphosting:rollouts:create BACKEND_ID
इसके अलावा, --git-branch विकल्प का इस्तेमाल करके, किसी खास ब्रांच के लिए सबसे नए कमिट का रोलआउट शुरू किया जा सकता है:
firebase apphosting:rollouts:create BACKEND_ID
--git-branch BRANCH_NAME
--git-commit विकल्प का इस्तेमाल करके, किसी खास कमिट के साथ भी रोलआउट बनाया जा सकता है:
firebase apphosting:rollouts:create BACKEND_ID
--git-commit COMMIT_ID
पिछले रोलआउट को वापस लाना
App Hosting आपको पिछले रोलआउट को वापस लाने के लिए दो विकल्प देता है:
- ऐप्लिकेशन को फिर से बनाए बिना, तुरंत रोल बैक करना
- फिर से बनाएं और पिछले वर्शन पर रोल बैक करें
तुरंत रोलबैक करना
कभी-कभी आपको अपने ऐप्लिकेशन के पिछले वर्शन पर तुरंत वापस जाना पड़ सकता है. उदाहरण के लिए, अगर आपको हाल ही में रोल आउट किए गए नए वर्शन में कोई गंभीर गड़बड़ी मिलती है या आपको कोई ऐसी गड़बड़ी मिलती है जो नए रोल आउट को ब्लॉक कर रही है. ऐसे मामलों में, पिछले रोलआउट से अपनी पसंद की मौजूदा कंटेनर इमेज को वापस लाया जा सकता है. इस इमेज को फिर से नहीं बनाया जाता. हालांकि, इसमें उस कोड और एनवायरमेंट कॉन्फ़िगरेशन का इस्तेमाल किया जाता है जो इसे पहली बार बनाते समय इस्तेमाल किया गया था.
तुरंत रोलबैक करने के लिए:
- Firebase कंसोल में, होस्टिंग और सर्वरलेस > App Hosting पर जाएं.
- जिस बैकएंड के लिए आपको रोलबैक बनाना है उसके लिए, देखें पर क्लिक करें.
- रोलआउट टैब को चुनें.
- बैकएंड के लिए इतिहास टेबल में, पिछले बिल्ड के लिए तीन बिंदु वाले मेन्यू को चुनें.
- इस बिल्ड पर वापस जाएं को चुनें और पुष्टि करें.
फिर से बनाना और रोल बैक करना
अगर आपको अपने ऐप्लिकेशन के पुराने वर्शन पर वापस जाना है, लेकिन मौजूदा कॉन्फ़िगरेशन को बनाए रखना है, तो रोलबैक की प्रोसेस के तहत ऐप्लिकेशन को फिर से बनाया जा सकता है. उदाहरण के लिए, अगर आपके सबसे नए वर्शन ने Secret Manager में एपीआई पासकोड की वैल्यू को अपडेट किया है, तो फिर से बिल्ड करने से यह पक्का किया जा सकता है कि रोल बैक करने के बाद, आपके ऐप्लिकेशन में नए पासकोड का इस्तेमाल किया जाए.
फिर से बनाने और रोल बैक करने के लिए:
- Firebase कंसोल में, होस्टिंग और सर्वरलेस > App Hosting पर जाएं.
- जिस बैकएंड के लिए आपको रोलबैक बनाना है उसके लिए, डैशबोर्ड देखें पर क्लिक करें.
- रोलआउट टैब को चुनें.
- रोलआउट बनाएं को चुनें.
- रोलआउट बनाएं डायलॉग बॉक्स में, पिछला कमिट चुनें. इसके बाद, उस वर्शन का कमिट आईडी डालें जिसे आपको फिर से बनाना है और रोल बैक करना है. कमिट आईडी, आपके रोलआउट इतिहास में मौजूद हर रोलआउट के लिए, "बदलाव की जानकारी" का हिस्सा होता है. यह लेबल में ब्रैकेट में मौजूद होता है.
- रोलबैक शुरू करने के लिए, बनाएं को चुनें.
रोलआउट की सेटिंग बदलना
बैकएंड के लिए डैशबोर्ड में, सेटिंग > डिप्लॉयमेंट व्यू में मौजूद कंट्रोल का इस्तेमाल करके, रोलआउट के लिए लाइव ब्रांच को बदला जा सकता है. साथ ही, अपने-आप होने वाले रोलआउट की सुविधा को बंद या चालू किया जा सकता है.
- Firebase कंसोल में, होस्टिंग और सर्वरलेस > App Hosting पर जाएं.
- उस बैकएंड के लिए देखें पर क्लिक करें जिसकी रोलआउट सेटिंग अपडेट करनी हैं.
- बैकएंड डैशबोर्ड में, Settings को चुनें. डिफ़ॉल्ट व्यू में, डोमेन और कस्टम डोमेन की जानकारी दिखती है.
- डिप्लॉयमेंट व्यू चुनें. इस व्यू में, रोलआउट के लिए लाइव ब्रांच को बदला जा सकता है. साथ ही, अपने-आप होने वाले रोलआउट की सुविधा को बंद या चालू किया जा सकता है. इसके अलावा, बैकएंड के लिए ऐप्लिकेशन की रूट डायरेक्ट्री और एनवायरमेंट सेट करने के विकल्प भी मौजूद हैं. इसके बारे में ज़्यादा जानने के लिए, एक से ज़्यादा एनवायरमेंट में डिप्लॉय करना लेख पढ़ें.
अपने-आप रोल आउट होने की सुविधा मैनेज करना
डिफ़ॉल्ट रूप से, App Hosting सभी फ़ाइलों की "ज़रूरी" सूची को मान लेता है. इसका मतलब है कि आपकी रिपॉज़िटरी में हर नई कमिट से, एक नया बिल्ड और रोल आउट ट्रिगर होता है. हालांकि, समय बचाने और ग़ैर-ज़रूरी डिप्लॉयमेंट से बचने के लिए, App Hosting को कॉन्फ़िगर किया जा सकता है. इससे, कमिट में बदली गई फ़ाइल के पाथ के आधार पर बिल्ड को स्किप किया जा सकता है.
इसे सेटिंग > रोलआउट > रोलआउट ट्रिगर में जाकर कॉन्फ़िगर किया जा सकता है. यहां, ज़रूरी पाथ को खाली छोड़ा जा सकता है. ऐसा तब किया जा सकता है, जब आपको अपनी रिपॉज़िटरी में हर नए कमिट के लिए, एक नया बिल्ड और रोलआउट ट्रिगर करना हो. इसके अलावा, यह भी तय किया जा सकता है कि किन डायरेक्ट्री या फ़ाइलों को हमेशा रोलआउट ट्रिगर करना चाहिए. अगर डायरेक्ट्री तय की जाती हैं, तो वे सभी पाथ जोड़ना न भूलें जिनमें बदलाव होने पर रोलआउट ट्रिगर होना चाहिए.
अनदेखा किए गए पाथ में जोड़ी गई डायरेक्ट्री या फ़ाइलें, कभी भी अपने-आप रोल आउट नहीं होंगी. अगर कोई सबडायरेक्ट्री, ज़रूरी और नज़रअंदाज़ किए जाने वाले कोड की सूची, दोनों में शामिल है, तो अपने-आप रोल आउट होने की सुविधा ट्रिगर नहीं होगी. अगर आपने सिर्फ़ अनदेखा किए गए पाथ की सूची भरी है, तो App Hosting ज़रूरी पाथ के लिए "*" को अपने-आप भर देगा.
अगर आपने कोई ऐसा कमिट पुश किया है जिसमें बदली गई कोई भी फ़ाइल आपके ज़रूरी पाथ से मैच नहीं होती है (या अगर सभी बदलावों को आपके अनदेखा किए गए पाथ से साफ़ तौर पर बाहर रखा गया है), तो App Hosting अब भी GitHub इवेंट की रसीद को स्वीकार करेगा. हालांकि, यह बिल्ड और रोलआउट की स्थितियों को SKIPPED के तौर पर मार्क करेगा. साथ ही, कोई भी ऑटोमैटिक रोलआउट ट्रिगर नहीं होगा.