🏹 🎃 🛎️ ड्रुपल + गिट सबमॉडल्स: व्यंजनों 🤹🏾 📹 😉

यह आलेख गिटार के सबमॉड्यूल्स के साथ काम करने के बुनियादी तरीकों पर चर्चा करेगा, यदि आप उन्हें ड्रुपल के साथ उपयोग करते हैं।

यह पोस्ट उन लोगों के लिए सबसे उपयोगी होगी, जिनके पास एक मामूली अनुभव है, एक ड्रुपल प्रोजेक्ट पर मिला है जहां सबमॉड्यूल्स का उपयोग किया जाता है। (यह कि मैं सबमॉडल्स से कैसे मिला और यह एक ऐसा लेख था, जो मुझे उस समय याद आ गया।)

सामग्री की तालिका

स्थिति

हमारे पास लिनक्स है, ड्रश स्थापित है और सातवें ड्रुपल की स्थापना है। मुख्य रिपॉजिटरी में ड्रुपल (और, संभवतः, हमारे कस्टम मॉड्यूल) का कोर शामिल है। जब तक अन्यथा निर्दिष्ट न हो, सभी आदेशों को Drupal संस्थापन के मूल निर्देशिका से निष्पादित किया जाता है। मॉड्यूल ड्रुपल मॉड्यूल है, सबमॉड्यूल गिटार का सबमॉड्यूल है।

न्यूनतम सबमॉड्यूल सूचना

सबमॉड्यूल्स नियमित गिट रिपोजिटरी हैं। वे मुख्य भंडार से अलग संग्रहीत हैं।

प्रोजेक्ट रिपॉजिटरी उपयोग किए गए .gitmodules सूची, उनके स्थान और URL (। .gitmodules फ़ाइल) को .gitmodules करता है और .gitmodules विशिष्ट स्थिति (संस्करण / रिलीज़ / कमिट / टैग) के बारे में जानकारी का उपयोग किया जाएगा ( .git निर्देशिका के .git में)।

प्रोजेक्ट अपडेट #

यदि आपका प्रोजेक्ट सबमॉड्यूल्स का उपयोग करता है, तो git pull बाद हर बार इन कमांड को चलाना सबसे अच्छा है:

 git submodule sync #     git submodule update --init #

मॉड्यूल को स्थापित करना #

Dl drash कमांड मॉड्यूल के साथ काम कर सकता है जैसा कि एक gith के उप-मॉड्यूल के साथ होता है:

 drush dl module_name --package-handler=git_drupalorg --gitsubmodule

कचरा केवल आधिकारिक रिपॉजिटरी - git.drupal.org साथ काम करता है।

लगातार dl कमांड के अतिरिक्त मापदंडों को न लिखने के लिए, आप डिफॉल्ट ड्रेश पैरामीटर्स को निम्नलिखित पंक्तियों को drushrc.php जोड़कर कॉन्फ़िगर कर सकते हैं:

 $options['package-handler'] = 'git_drupalorg'; $options['gitsubmodule'] = TRUE;

इस स्थिति में, डिफ़ॉल्ट रूप से सभी मॉड्यूल को गिटार के सबमॉड्यूल के रूप में डाउनलोड किया जाएगा और आप बस लिख सकते हैं:

 drush dl module_name

यदि आपको मैन्युअल रूप से सबमॉड्यूल स्थापित करने की आवश्यकता है, उदाहरण के लिए, आधिकारिक रिपॉजिटरी से नहीं, तो हम सामान्य गिट्टी का उपयोग करते हैं:

 git submodule add git://github.com/example/module_name.git sites/all/modules/module_name

फिर आपको स्थापित सबमॉड्यूल की निर्देशिका में जाने और वांछित रिलीज़ पर स्विच करने की आवश्यकता है:

 git checkout 7.x-1.0

मॉड्यूल संस्करण का निर्धारण #

यदि आप drupal.org से मॉड्यूल "पुराने ढंग का" डाउनलोड करते हैं, तो मॉड्यूल के संस्करण को module_name.info फ़ाइल में इंगित किया जाएगा। रिलीज़ बनाते समय यह स्वचालित रूप से इस फ़ाइल में जोड़ा जाता है; यह रिपॉजिटरी में नहीं है।

Drupal के लिए मॉड्यूल के संस्करण को स्वयं निर्धारित करने के लिए, git_deploy मॉड्यूल की आवश्यकता होती है । यह Drupal द्वारा प्राप्त जानकारी को सूचना-फाइलों से मॉड्यूल के एक संस्करण में जोड़कर, जिसे वह "अर्क" करता है, का उपयोग करके विभिन्न कमांड का उपयोग करता है। आप git_deploy बिना git_deploy उपयोग कर सकते हैं, लेकिन आप drush up माध्यम से अपडेट का उपयोग नहीं कर पाएंगे, क्योंकि Drupal को स्थापित मॉड्यूल के वर्तमान संस्करण का पता नहीं होगा।

आप इस तरह मॉड्यूल संस्करण का भी पता लगा सकते हैं:

 git submodule status | grep module_name

कोष्ठक में हमारी परियोजना में उपयोग किए जाने वाले टैग को इंगित किया जाएगा।
UPD: यह तरीका हमेशा सही तरीके से काम नहीं करता है, क्योंकि यह निकला है। सबमॉड्यूल निर्देशिका से चलाना बेहतर है:

 git describe --all

मॉड्यूल अपडेट #

अपडेट करने का कमांड सबसे आम है:

 drush up module_name

फिर, यह तभी काम करेगा जब हमारे पास git_deploy स्थापित हो।

यदि हमें मैन्युअल रूप से मॉड्यूल को अपडेट करने की आवश्यकता है, तो मान लें कि हम एक विशिष्ट संस्करण में अपग्रेड करना चाहते हैं। फिर सबमॉड्यूल की सूची से, दो कमांड चलाएं:

 git fetch #      git checkout 7.x-3.5 #      ()

उसके बाद, डेटाबेस अपडेट शुरू करना न भूलें:

 drush updb

पैच मॉड्यूल #

सबसे पहले, एक विशिष्ट ब्रंच के लिए सबमॉड्यूल को स्विच करना उचित है क्योंकि

पैच ज्यादातर देव संस्करणों के लिए लिखे गए हैं
एक विशिष्ट रिलीज (टैग) के लिए सबमॉडल "टारगेट" करता है, जिसका अर्थ है कि आपका सबमॉडल "अलग सिर" स्थिति में है और आगे काम मुश्किल हो सकता है।

उदाहरण के लिए, यदि हमने मॉड्यूल संस्करण 7.x-3.5 का उपयोग किया है, तो हम इस रिलीज़ की कार्यशील शाखा में जाएंगे:

 git fetch #      git checkout 7.x-3.x #     git pull #

मैं कमांड लाइन , आपके पसंदीदा आईडीई या अन्य टूल का उपयोग करके पैच लागू नहीं करूंगा।

हम उस मॉड्यूल के लिए एक अलग रिपॉजिटरी बनाते हैं जिसे हमने पैच किया था। उदाहरण के लिए, एक गीथूब पर।

अपने सबमॉड्यूल रिपॉजिटरी के URL को अपडेट करना। ऐसा करने के लिए, .gitmodules फ़ाइल में संबंधित अनुभाग .gitmodules , उदाहरण के लिए:

  [submodule "sites/all/modules/module_name"] path = sites/all/modules/module_name - url = git://git.drupal.org/project/module_name.git + url = https://github.com/example/module_name.git

नए URL का उपयोग करना शुरू करने के लिए, हम करते हैं:

 git submodule sync

अब आप हमारे परिवर्तन कर सकते हैं और हमारे नए भंडार में सब कुछ धक्का दे सकते हैं। सबमॉड्यूल निर्देशिका से, निष्पादित करें:

 git commit -m "Applied patch from http://drupal.org/node/00000#comment-0000000" git push

आपका कमिटमेंट और पूरा पिछला मॉड्यूल इतिहास आपके रिपॉजिटरी में जाएगा।

पैच किए गए मॉड्यूल को अपडेट करना #

कभी-कभी उस मॉड्यूल को अपडेट करना आवश्यक होता है जिसमें हमने अपने बदलाव किए हैं, उदाहरण के लिए, सुरक्षा अपडेट जारी करने या हमें आवश्यक नई सुविधाओं की उपस्थिति के संबंध में।

सबसे आसान समाधान आधिकारिक रिपॉजिटरी की कामकाजी शाखा से अपडेट करना है। उदाहरण के लिए, अगर हमने पहले इसके सबमोडर्ल की निर्देशिका से ब्रंच 7.x-3.x के आधार पर एक मॉड्यूल पैच किया है, तो रन करें:

 git pull http://git.drupal.org/project/module_name.git 7.x-3.x

(ईमानदार होने के लिए, यह एकमात्र तरीका है जो मैंने इस बिंदु तक उपयोग किया है।)

मॉड्यूल रिपॉजिटरी रिकवरी #

यदि आपका पैच प्रतिबद्ध है या अब इसकी आवश्यकता नहीं है, तो यह git.drupal.org लिए git.drupal.org को वापस करने के लिए समझ में आता है। ऐसा करने के लिए, अपडेट करें (पुराने को लौटाएं) URL, सबमॉडल्स के URL को सिंक्रोनाइज़ करें, सबमॉड्यूल डायरेक्टरी से git fetch लाएं और वांछित रिलीज को देखें। यह सब ऊपर वर्णित है।

सबमॉडल हटाना #

कोई सरल आदेश नहीं है, लेकिन स्टैकओवरफ़्लो के साथ एक नुस्खा है :

.gitmodules और .gitmodules .git/config फ़ाइलों से .gitmodules अनुभाग हटाएं
चलाने git rm --cached sites/all/modules/module_name ,
परिवर्तन करें और सबमॉड्यूल निर्देशिका को हटा दें।

निष्कर्ष

द्रुपाल के संदर्भ में, सबमॉड्यूल का उपयोग कई फायदे प्रदान करता है। पैचिंग मॉड्यूल अधिक सुविधाजनक हो जाते हैं, जबकि उन्हें बनाए रखना आसान होता है। आप कई परियोजनाओं में पैच या अपने स्वयं के मॉड्यूल का उपयोग कर सकते हैं, जबकि उन पर केंद्रीय रूप से काम कर रहे हैं। और अगर आप विचार करते हैं कि सबमोडुल्स के साथ काम करने के लिए आपको बस कुछ सरल ट्रिक्स सीखने की जरूरत है, तो हम ठोस प्लस प्राप्त करते हैं और निष्कर्ष निकालते हैं कि सबमॉड्यूल एक सरल और प्रभावी उपकरण है जिसका उपयोग और ड्रुपल परियोजनाओं में किया जाना चाहिए।

ड्रुपल + गिट सबमॉडल्स: व्यंजनों