FiveM CI/CD विथ GitHub Actions: डिप्लॉयमेंट स्वचालित करें

FiveM विकास के लिए CI/CD क्यों?

कंटीन्यूअस इंटीग्रेशन और कंटीन्यूअस डिप्लॉयमेंट FiveM स्क्रिप्ट्स के लिए अधिक लग सकता है, लेकिन जैसे-जैसे आपके प्रोजेक्ट जटिल होते हैं और आपकी टीम बढ़ती है, स्वचालित वर्कफ़्लोज़ अमूल्य हो जाते हैं। CI/CD सिंटैक्स त्रुटियों को सर्वर तक पहुँचने से पहले पकड़ता है, योगदानकर्ताओं के बीच कोड गुणवत्ता मानकों को लागू करता है, संस्करण बंपिंग और चेंजलॉग जनरेशन को स्वचालित करता है, और रिलीज़ को लगातार पैकेज करता है। GitHub Actions सार्वजनिक रिपॉजिटरीज़ के लिए मुफ्त CI/CD प्रदान करता है और निजी रिपॉजिटरीज़ के लिए उदार फ्री-टियर मिनट्स, जिससे यह FiveM डेवलपर्स के लिए आदर्श प्लेटफ़ॉर्म बन जाता है।

Lua लिंटिंग सेट करना

अपने CI पाइपलाइन को Luacheck के साथ स्वचालित लिंटिंग के साथ शुरू करें, जो मानक Lua स्थैतिक विश्लेषण उपकरण है। एक बनाएं .github/workflows/lint.yml फ़ाइल जो हर पुश और पुल अनुरोध पर चलती है। वर्कफ़्लो LuaRocks के माध्यम से Luacheck स्थापित करना चाहिए, फिर इसे अपने Lua फ़ाइलों के खिलाफ एक कस्टम .luacheckrc FiveM ग्लोबल्स को परिभाषित करने वाला विन्यास जैसे Citizen, TriggerServerEventऔर अन्य फ्रेमवर्क-विशिष्ट फ़ंक्शन। यह अनिर्धारित वेरिएबल संदर्भों, अप्रयुक्त लोकल्स, और स्टाइल असंगतताओं को पकड़ता है इससे पहले कि कोड प्रोडक्शन तक पहुंचे।

TypeScript बिल्ड सत्यापन

यदि आपका FiveM प्रोजेक्ट TypeScript का उपयोग करता है, तो एक बिल्ड स्टेप जोड़ें जो आपके TypeScript स्रोतों को संकलित करता है और सुनिश्चित करता है कि कोई टाइप त्रुटि नहीं है। npm के साथ अपने प्रोजेक्ट निर्भरताएँ इंस्टॉल करें, फिर TypeScript कंपाइलर को चेक मोड में चलाएँ। यह सुनिश्चित करता है कि हर पुल रिक्वेस्ट वैध JavaScript आउटपुट उत्पन्न करे और टाइप असंगतियों को पकड़ता है जो रनटाइम त्रुटियाँ पैदा कर सकती हैं। इस चरण को लिंटिंग से पहले शामिल करें ताकि आप उत्पन्न Lua या JavaScript आउटपुट को TypeScript स्रोत के साथ मान्य कर सकें, जिससे संभावित समस्याओं का पूर्ण कवरेज मिलता है।

स्वचालित संस्करण प्रबंधन

अपने रिलीज़ वर्कफ़्लो को स्वचालित करने के लिए GitHub Actions का उपयोग करें। जब आप संस्करण पैटर्न से मेल खाने वाला टैग पुश करते हैं जैसे v*.*.* , एक वर्कफ़्लो ट्रिगर करें जो संस्करण संख्या निकालता है, इसे आपके में अपडेट करता है fxmanifest.lua , अंतिम टैग से कमिट संदेशों से एक चेंजलॉग उत्पन्न करता है, किसी भी संकलित संपत्ति का निर्माण करता है, और पैकेज्ड संसाधन के साथ GitHub रिलीज़ बनाता है जिसे डाउनलोड करने योग्य आर्टिफैक्ट के रूप में उपयोग किया जा सकता है। यह मैनुअल रिलीज़ तैयारी को समाप्त करता है और सुनिश्चित करता है कि हर रिलीज़ सुसंगत और पूर्ण हो।

स्वचालित परीक्षण रणनीतियाँ

जबकि FiveM में एक अंतर्निहित परीक्षण फ्रेमवर्क नहीं है, आप साझा उपयोगिता फ़ंक्शंस और व्यावसायिक लॉजिक को मानक Lua परीक्षण उपकरण जैसे Busted का उपयोग करके परीक्षण कर सकते हैं। अपने परीक्षण वातावरण में FiveM-विशिष्ट ग्लोबल्स और नेटिव फ़ंक्शंस का मॉक बनाएं, फिर अपने शुद्ध लॉजिक फ़ंक्शंस के खिलाफ यूनिट परीक्षण चलाएं। एकीकरण परीक्षण के लिए, एक हेडलेस FiveM सर्वर को Docker कंटेनर में सेटअप करने पर विचार करें जो आपका रिसोर्स लोड करता है और परीक्षण क्लाइंट का उपयोग करके स्वचालित परिदृश्यों को चलाता है। ये परीक्षण जल्दी रिग्रेशन पकड़ते हैं और आपके रिलीज की गुणवत्ता में विश्वास बनाते हैं।

डिप्लॉयमेंट ऑटोमेशन

लाइव सर्वरों का प्रबंधन करने वाली टीमों के लिए, अपने CI/CD पाइपलाइन को तैनाती संभालने के लिए विस्तारित करें। सफल बिल्ड और परीक्षण रन के बाद, SSH या FTP क्रियाओं का उपयोग करके अपडेट किए गए संसाधन को अपने स्टेजिंग सर्वर पर तैनात करें। एक स्मोक टेस्ट चलाएं जो सत्यापित करता है कि संसाधन बिना त्रुटियों के शुरू होता है, फिर मैनुअल अनुमोदन गेट के साथ उत्पादन में प्रमोट करें। सर्वर क्रेडेंशियल्स को GitHub Secrets के रूप में स्टोर करें और तैनाती वर्कफ़्लोज़ को संरक्षित शाखाओं तक सीमित करें। यह वर्कफ़्लो सुनिश्चित करता है कि केवल परीक्षण और समीक्षा किया गया कोड आपके लाइव सर्वर तक पहुंचता है और टूटे हुए अपडेट्स को तैनात करने के जोखिम को कम करता है जो आपकी समुदाय को बाधित कर सकते हैं।