Preview Deploys For Pull Requests के लिए पूर्वावलोकन तैनातियां

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

पूर्वावलोकन प्रदर्शन कहाँ रहते हैं

Websites खोलें, साइट पर क्लिक करें, साइट टैब पट्टी में Environments मेनू खोलें, और Preview चुनें। पृष्ठ का शीर्षक Preview deploys है।

पूर्वावलोकन स्टेजिंग से अलग हैं। स्टेजिंग साइट की एक लंबी स्थायी प्रति है जिसे आप जानबूझकर धकेलते हैं; एक पूर्वावलोकन एक अल्पकालिक पर्यावरण है जो प्रति पुल अनुरोध बनाया जाता है और बाद में फेंक दिया जाता है। कई टीमें दोनों का उपयोग करती हैं। दूसरी आधी के लिए Staging Environments देखें।

पहले Git Deploy सेट अप करें

पूर्वावलोकन एक स्वतंत्र सुविधा नहीं हैं। वे उत्पादन साइट की तैनाती कुंजी और बिल्ड कमांड का पुनः उपयोग करते हैं, इसलिए पूर्वावलोकन को सक्षम करने से पहले साइट को एक कार्यशील Git Deploy कॉन्फ़िगरेशन की आवश्यकता होती है।

यदि Git Deploy कॉन्फ़िगर नहीं किया गया है, तो पृष्ठ कहता है Set up Git deploy first और सक्षम फॉर्म के बजाय एक Go to Git deploy बटन प्रदान करता है। Deploying a Site From Git के माध्यम से काम करें, फिर वापस आएँ।

पूर्वावलोकन सक्षम करना

1. Enable preview deploys कार्ड में, owner/repo फॉर्म में भंडार टाइप करें। URL नहीं, SSH पता नहीं: बस दो खंड, उदाहरण के लिए acme/marketing-site।
2. Enable पर क्लिक करें।

कुछ भी जो owner/name से मेल नहीं खाता है उसे Repo must be in owner/name format के साथ अस्वीकार किया जाता है।

सक्षम करने के तुरंत बाद, KPanel Copy your webhook secret now शीर्षक वाले कार्ड में वेबहुक स्वाक्षरण गुप्त दिखाता है, एक चेतावनी के साथ कि आप इसे फिर से नहीं देखेंगे।

आपके भंडार में वेबहुक जोड़ना

कॉन्फ़िगर किए गए कार्ड में एक Webhook URL दिखाया जाता है जिसे आपके भंडार सेटिंग्स में, Webhooks के तहत पेस्ट करना है। इसे निम्नानुसार कॉन्फ़िगर करें:

• Payload URL: पृष्ठ पर दिखाया गया वेबहुक URL।
• Secret: वह मान जिसकी आपने अभी प्रतिलिपि बनाई।
• Content type: JSON।
• Events: pull request घटनाएँ, साथ ही धकेलना, ताकि एक खुले पुल अनुरोध पर नई प्रतिबद्धताएँ पूर्वावलोकन को फिर से बनाएँ।

एक बार यह जगह में है, एक पुल अनुरोध खोलने से कुछ ही मिनटों में एक पूर्वावलोकन बनाया जाता है। एक पृष्ठभूमि कार्य हर मिनट नए पूर्वावलोकन कार्य की जांच करता है, इसलिए KPanel में कुछ भी दबाने की आवश्यकता नहीं है।

पूर्वावलोकन URL

प्रत्येक पूर्वावलोकन को pr-<pull-request-number>-<site-id>.kapsulecloud.app के फॉर्म का अपना होस्टनाम मिलता है, एक वाइल्डकार्ड प्रमाणपत्र द्वारा कवर किया जाता है ताकि इसे HTTPS पर परोसा जाए आपके स्वयं के प्रमाणपत्र चरण के बिना।

इसे खोलने का विश्वसनीय तरीका Recent previews में पूर्वावलोकन की पंक्ति पर Open बटन है, जो उस बिल्ड के लिए प्रावधानित सटीक URL को ले जाता है। उस लिंक को पुल अनुरोध में पेस्ट करें ताकि समीक्षकों को बिल्कुल भी KPanel खोजने की आवश्यकता न हो।

हाल के पूर्वावलोकन सूची पढ़ना

Recent previews अनुभाग सबसे हाल के पूर्वावलोकन को सूचीबद्ध करता है, सबसे नए पहले। प्रत्येक पंक्ति पुल अनुरोध संख्या और शीर्षक, शाखा, प्रतिबद्धता, और एक स्थिति दिखाती है:

इसके बिल्ड आउटपुट को इनलाइन विस्तारित करने के लिए किसी पंक्ति पर Toggle build log पर क्लिक करें। वह लॉग पहली जगह है जहाँ देखना है जब एक पूर्वावलोकन विफल होता है, और यह वही आउटपुट है जो आपका बिल्ड स्थानीय रूप से उत्पन्न करता।

यदि सूची खाली है, तो पृष्ठ कहता है: भंडार पर एक पुल अनुरोध खोलें और कुछ मिनटों के भीतर एक पूर्वावलोकन बनाया जाएगा।

वेबहुक गुप्त घुमाना

कॉन्फ़िगर किए गए कार्ड में Regenerate secret पर क्लिक करें। KPanel आपको पुष्टि करने के लिए कहता है, और स्पष्ट है कि वर्तमान गुप्त तुरंत काम करना बंद कर देता है और आपको इसे अपने भंडार की वेबहुक सेटिंग्स में अपडेट करने की आवश्यकता होगी।

नया गुप्त एक बार दिखाया जाता है, पहले जैसे ही एक बार वाले कार्ड में। इसकी प्रतिलिपि बनाएँ, फिर आपके भंडार में वेबहुक को अपडेट करें। उन दोनों क्षणों के बीच, आने वाली वेबहुक डिलीवरी अस्वीकार कर दी जाती है, इसलिए दोनों चरणों को पीठ से पीठ तक करें।

गुप्त को पुनर्जीवित करें जब कोई व्यक्ति भंडार व्यवस्थापक पहुँच के साथ चला जाता है, या यदि गुप्त को कहीं पेस्ट किया गया है जहाँ यह नहीं होना चाहिए, जैसे कि एक साझा चैट चैनल या एक टिकट।

पूर्वावलोकन बंद करना

Disable पर क्लिक करें। कॉन्फ़िगरेशन बंद कर दिया जाता है और संग्रहीत गुप्त साफ किया जाता है। मौजूदा पूर्वावलोकन पुनर्निर्मित होना बंद कर देते हैं।

अपने भंडार में वेबहुक को हटाकर सफाई करें। यह विफल होने लगेगा बजाय कुछ भी हानिकारक करने के, लेकिन एक वेबहुक जो हमेशा के लिए त्रुटि देता है वह आपके भंडार की डिलीवरी लॉग में शोर है।

लागत और रखरखाव

पूर्वावलोकन वास्तविक कोड बनाता है और परोसता है, इसलिए वे साइट पर किसी भी अन्य तैनाती के रूप में समान संसाधनों का उपयोग करते हैं। दो आदतें इसे नियंत्रण में रखती हैं:

• पुल अनुरोध बंद करें जिन पर आप अब काम नहीं कर रहे हैं। एक बंद पुल अनुरोध का पूर्वावलोकन स्वचालित रूप से साफ किया जाता है।
• पूर्वावलोकन को उत्पादन क्रेडेंशियल की ओर न ले जाएँ। Secrets टैब के preview पर्यावरण के माध्यम से परीक्षण कुंजियाँ दें, जो ठीक इसलिए मौजूद है ताकि पूर्वावलोकन और उत्पादन कॉन्फ़िगरेशन को भ्रमित न किया जा सके।

समस्या निवारण

जब एक पुल अनुरोध खोला जाता है तो कुछ भी नहीं बनाया जाता है। अपने भंडार में वेबहुक की हाल की डिलीवरी की जांच करें। 401 या 403 का अर्थ है गुप्त मेल नहीं खाता है, इसलिए इसे पुनर्जीवित करें और दोनों सिरों को अपडेट करें। कोई डिलीवरी बिल्कुल नहीं का अर्थ है वेबहुक पुल अनुरोध घटनाओं की सदस्यता नहीं है।

पूर्वावलोकन बनता है लेकिन एक निर्देशिका सूची या 404 दिखाता है। Git Deploy पृष्ठ पर आउटपुट निर्देशिका वह जगह से मेल नहीं खाती है जहाँ आपका बिल्ड वास्तव में लिखता है। पूर्वावलोकन उत्पादन से उस सेटिंग को विरासत में देते हैं।

बिल्ड केवल पूर्वावलोकन में विफल होता है। सबसे आम कारण एक निर्भरता या एक पर्यावरण चर है जो उत्पादन में मौजूद है लेकिन पूर्वावलोकन पर्यावरण में कभी नहीं जोड़ा गया है। Secrets पृष्ठ पर preview टैब की जांच करें।

एक पूर्वावलोकन URL काम करना बंद कर देता है। इसकी पंक्ति पर स्थिति देखें। DESTROYED का अर्थ है पुल अनुरोध बंद हो गया और पर्यावरण को पुनः प्राप्त किया गया, जो इच्छित व्यवहार है।

आगे कहाँ जाएँ

• Deploying a Site From Git, आवश्यक कॉन्फ़िगरेशन।
• Storing App Secrets For a Site प्रति-पर्यावरण क्रेडेंशियल के लिए।
• Staging Environments एक स्थायी पूर्व-उत्पादन प्रति के लिए।