ट्राक और उसके दोस्त गितोलाइट, नेग्नेक्स और यूडब्ल्यूएसजीआई

हर कोई शायद अद्भुत OpenSource प्रोजेक्ट Trac जानता है, जो आपको सॉफ़्टवेयर विकास में वर्कफ़्लो को व्यवस्थित करने की अनुमति देता है। हालांकि, इसकी तैनाती और विन्यास एक आसान काम नहीं है। इंटरनेट पर जानकारी बिखरी हुई है और अक्सर पहले से ही पुरानी है। मैं Nginx + UWSGI के एक समूह पर Gitolite के साथ एकीकृत Trac की स्थापना करके इसे स्वयं सत्यापित करने में सक्षम था।

एक टैम्बोरिन के साथ एक छोटी सी अवधि के बाद, मैं इस दस्तावेज का जन्म हुआ, जो ट्राक परियोजना को तैनात करने के लिए एक कदम-दर-चरण निर्देश है। आशा है कि यह किसी और के लिए काम में आता है।

निर्देश मूल लिनक्स प्रशासन ज्ञान और पायथन पैकेज इंस्टॉलेशन सिस्टम के साथ एक उपयोगकर्ता के लिए लक्षित है। मैं तुरंत कहूंगा कि एक नए स्थापित उबंटू 12.04 वितरण वाले सिस्टम पर तैनाती की प्रक्रिया का वर्णन किया गया है, हालांकि, मुझे लगता है कि जानकारी अन्य लिनक्स असेंबली के प्रशंसकों के लिए उपयोगी होगी।

ट्राक परियोजना की शुरुआत

यदि आपके सिस्टम पर Trac स्थापित नहीं है, तो इन चरणों का पालन करें:

• अजगर पिप स्थापित करें;
• यदि आपको इंटरफ़ेस स्थानीयकरण की आवश्यकता है तो बैबेल स्थापित करें;
• संस्करण के साथ ही Trac स्थापित करें, लेख संस्करण 1.0 की स्थापना का वर्णन करता है।

sudo apt-get install python-pip sudo pip install babel sudo pip install "Trac==1.0" 

अब आपको प्रोजेक्ट लोकेशन डायरेक्टरी को इनिशियलाइज़ करना होगा। इन चरणों का पालन करें:

• trac उपयोगकर्ता बनाएं;
• ट्रैसीज़ समूह बनाएं और इसमें ट्रेक और खुद को शामिल करें;
• परियोजना के स्थान के लिए एक जगह तैयार करना;
• प्रोजेक्ट डायरेक्टरी को इनिशियलाइज़ करें;
• मालिक और आवश्यक अधिकार नियुक्त करें;
• दौड़ो, देखो क्या हुआ।

 sudo adduser --disabled-password --gecos 'Trac' trac sudo addgroup tracsys sudo adduser trac tracsys sudo adduser `whoami` tracsys sudo mkdir -p /var/www/trac sudo trac-admin /var/www/trac initenv sudo chown -R nobody:tracsys /var/www/trac sudo chmod -R g+rwXs /var/www/trac tracd -p 8000 /var/www/trac/ 

Tracsys समूह में हेरफेर करने और परियोजना निर्देशिका को अधिकार प्रदान करने के लिए छोड़कर, सब कुछ काफी तुच्छ है। लेकिन इससे जिगोलिट और Nginx + UWSGI बंडल पर आधारित एक परियोजना की मेजबानी के संगठन के साथ एकीकरण प्रभावित हुआ।

Nginx और UWSGI के साथ होस्टिंग

UWSGI एक WSGI एप्लिकेशन सर्वर है। इसके तहत हमारे Trac प्रोजेक्ट को चलाने के लिए, आपको इसे WSGI एप्लिकेशन के रूप में प्रस्तुत करना होगा। नीचे स्क्रिप्ट का उपयोग करके ऐसा करना मुश्किल नहीं है। इसे फ़ाइल /home/trac/wsgi_trac.py फ़ाइल में कॉपी करें, उपयोगकर्ता को मालिक बना दें। इसके बाद, आपको Nginx और UWSGI कॉन्फ़िगरेशन फ़ाइलों को बनाने की आवश्यकता है। Nginx के लिए, फ़ाइल ऐसे मामलों में मानक है, लेकिन UWSGI के लिए सूक्ष्मताएं हैं। हमारे WSGI को उपयोगकर्ता trac और group tracsys के अधिकारों के साथ शुरू किया जाएगा। Wsgi_trac.nginx और wsgi_trac.uwsgi कॉन्फ़िगरेशन फ़ाइलें नीचे सूचीबद्ध हैं।

wsgi_trac.py

 import os import sys import trac.web.main sys.stdout=sys.stderr os.environ['TRAC_ENV'] = '/var/www/trac' application = trac.web.main.dispatch_request 

wsgi_trac.nginx

 server { listen 80; server_name trac.local; location / { include uwsgi_params; uwsgi_pass 127.0.0.1:5544; } } 

wsgi_trac.uwsgi

 [uwsgi] uid=trac gid=tracsys chmod-socket=777 chown-socket=trac chdir = /home/trac socket = 127.0.0.1:5544 module = wsgi_trac:application processes = 2 master = 1 

यदि Nginx और / या UWSGI स्थापित नहीं हैं, तो उन्हें स्थापित करें। सिमिलिंक के साथ, कॉन्फ़िगरेशन फ़ाइलों को सक्रिय करें और सेवाओं को पुनरारंभ करें।

 sudo apt-get install nginx uwsgi uwsgi-plugin-python sudo ln -s /home/trac/wsgi_trac.nginx /etc/nginx/sites-enabled/trac.conf sudo ln -s /home/trac/wsgi_trac.uwsgi /etc/uwsgi/apps-enabled/trac.ini sudo service nginx restart sudo service uwsgi restart 

AccountManagerPlugin प्लगइन स्थापित करना

Trac 1.0 वितरण में एक घटक शामिल नहीं है जो आपको उपयोगकर्ता खातों को प्रबंधित करने की अनुमति देगा। इसके लिए, विभिन्न प्लगइन्स का उपयोग किया जाता है। हमारे उदाहरण में, AccountManagerPlugin प्लगइन का उपयोग किया जाएगा। इसे डाउनलोड करें और इसे अंडे के वितरण की तरह बनाएं। परिणामी फ़ाइल को एक्सटेंशन के साथ कॉपी करें । प्लगइन्स डायरेक्टरी में जाएं। हमारे मामले में यह / var / www / trac / plugins है । Trac.ini फ़ाइल में लाइनें जोड़ें।

 [components] trac.web.auth.LoginModule = disabled acct_mgr.web_ui.LoginModule = enabled acct_mgr.web_ui.RegistrationModule = enabled 

पासवर्ड को संग्रहित करने के लिए HtDigest प्रारूप में एक फ़ाइल का उपयोग किया जाएगा, इसके लिए हम निम्नलिखित पंक्तियों को trac.ini फ़ाइल में जोड़ते हैं ।

 [account-manager] authentication_url = force_passwd_change = False hash_method = HtDigestHashMethod htdigest_realm = trac htpasswd_hash_type = crypt password_file = /var/www/trac/db/users.htdigest password_store = HtDigestStore persistent_sessions = False refresh_passwd = False user_lock_max_time = 0 verify_email = False 

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

 trac-admin /var/www/trac permission add <  > TRAC_ADMIN 

अब हमारे पास एक व्यवस्थापक है, जिसके तहत आप अन्य उपयोगकर्ताओं के अधिकारों को बना सकते हैं, हटा सकते हैं और असाइन कर सकते हैं। कृपया ध्यान दें कि वेब इंटरफ़ेस में नए उपयोगकर्ता पंजीकरण फॉर्म का लिंक सक्रिय हो गया है, यदि उपयोगकर्ता के पास परियोजना के लिए स्वतंत्र पंजीकरण नहीं है, तो उसे अक्षम कर दें। आप खाता प्रबंधक के प्लग-इन कॉन्फ़िगरेशन के रूप में c RegistrationModule को अनचेक करके प्लग-इन प्रबंधन के व्यवस्थापक अनुभाग में पहले से ही ऐसा कर सकते हैं।

गितोितल एकता

Git रिपॉजिटरी के प्रबंधन के लिए एक महान Gitolite टूल है, जिसे Trac प्रोजेक्ट्स के साथ भी एकीकृत किया जा सकता है। ऐसा करने के लिए, इन चरणों का पालन करें:

• Gitolite वितरण को तैनात करें, वर्किंग डायरेक्टरी / होम / gitolite के साथ एक git यूजर बनाएं और इसे ट्रैक्स ग्रुप में जोड़ें;
• Trac उपयोगकर्ता के लिए SSH कुंजियाँ बनाएँ और सार्वजनिक कुंजी को /tmp/trac.pub पर कॉपी करें;

 sudo apt-get install gitolite sudo adduser --home /home/gitolite --disabled-password --gecos 'Git' git sudo adduser git tracsys sudo su trac cd ~ ssh-keygen -t rsa cp ~/.ssh/id_rsa.pub /tmp/trac.pub exit 

अगला कदम गिट यूजर के रूप में जिओलाइट वर्किंग डायरेक्टरी को इनिशियलाइज़ करना है। यह कॉन्फ़िगरेशन फ़ाइल खोलेगा जहाँ आपको '$ REPO_UMASK = 0077;' लाइन को ठीक करने की आवश्यकता होगी। से '$ REPO_UMASK = 0007?'। यदि विम में परेशानी हो रही है, तो बस ZZ दबाएं। आप फ़ाइल /home/gitolite/.gitolite.rc को संपादित करके बाद में मुखौटा बदल सकते हैं। निर्देशिका को असाइन करें साथ ही Trac परियोजना के साथ निर्देशिका को सौंपे गए समान अधिकार।

 sudo su git cd ~ gl-setup /tmp/trac.pub exit sudo chown -R git:tracsys /home/gitolite/repositories/ sudo chmod -R g+rwXs /home/gitolite/repositories/ 

यह हमारे Trac प्रोजेक्ट के Git के साथ एकीकरण को सक्षम करने के लिए बना हुआ है। ऐसा करने के लिए, निम्नलिखित पंक्तियों को trac.ini में जोड़ें ।

 [components] tracopt.versioncontrol.git.* = enabled [trac] repository_type = git 

अब प्रशासन क्षेत्र में, रिपॉजिटरी सेक्शन में, नाम के परीक्षण के साथ टेस्ट रिपॉजिटरी gitolite /home/gitolite/repositories/testing.git, और कंट्रोल रिपॉजिटरी / होम / gololite / repositories / gitolite-admin.it को gitolite-admin नाम से कनेक्ट करें । यदि सब कुछ सही ढंग से किया गया था, तो स्रोत कोड अनुभाग वेब इंटरफ़ेस मेनू में दिखाई देगा, जिसमें वे दोनों उपस्थित होंगे।

सब कुछ ठीक है, लेकिन मैं हमारे ट्राक प्रोजेक्ट के इंटरफेस के माध्यम से जीटोलिट रिपॉजिटरी का प्रबंधन करना चाहूंगा। कोई समस्या नहीं है, trac-GitolitePlugin प्लगइन इस मामले में मदद करेगा। इसे उपरोक्त पृष्ठ से डाउनलोड करें और इसे अंडे के वितरण की तरह बनाएँ। परिणामी फ़ाइल को प्लगइन्स निर्देशिका में कॉपी करें और trac.ini फ़ाइल में निम्न पंक्तियों को जोड़कर सक्रिय करें।

 [components] trac_gitolite.* = enabled [trac] permission_policies = GitolitePermissionPolicy, AuthzPolicy, DefaultPermissionPolicy, LegacyAttachmentPolicy [trac-gitolite] admin_reponame = gitolite-admin admin_real_reponame = gitolite-admin admin_ssh_path = git@localhost:gitolite-admin.git admin_system_user = trac default_private = True all_includes_anonymous = False 

उसके बाद, एक नया अनुभाग व्यवस्थापक पैनल में दिखाई देगा जहां आप उपयोगकर्ताओं को गिटोलिट में जोड़ सकते हैं और उन्हें रिपॉजिटरी के अधिकार प्रदान कर सकते हैं। हालाँकि, पहले उपयोगकर्ता जोड़ के दौरान, मुझे git क्लोन कमांड git @ localhost: gitolite-admin.git / tmp / bla-bla निष्पादित करते समय एक त्रुटि मिली। मुझे उपयोगकर्ता ट्रेक के तहत इस कमांड को निष्पादित करना था और मैन्युअल रूप से कुंजी को जोड़ने की पुष्टि करनी थी, फिर सब कुछ समस्याओं के बिना काम किया।

यह Trac और Git की सबसे दिलचस्प एकीकरण विशेषताओं में से एक को लागू करने के लिए बनी हुई है, यह टिकट कोड को वचन में निर्दिष्ट करके टिकट को बंद करता है। उदाहरण के लिए, एक कमिट जिसमें "करीब # 777" लाइन होती है, वह स्वचालित रूप से संबंधित टिकट को बंद कर देगी। ऐसा करने के लिए, आपको पहले व्यवस्थापक पैनल के माध्यम से या Trac.ini फ़ाइल में निम्न पंक्तियों को जोड़कर कमेटटाइकपैड घटक को सक्रिय करना होगा ।

 [components] tracopt.ticket.commit_updater.* = enabled 

अगला, पायथन स्क्रिप्ट डाउनलोड करें जो संबंधित हुक को लागू करती है, उदाहरण के लिए, निर्देशिका / var / www / trac / हुक में। इसका एक कॉन्फ़िगरेशन अनुभाग है जिसे किसी विशिष्ट Trac प्रोजेक्ट के स्थान और कॉन्फ़िगरेशन के आधार पर कॉन्फ़िगर करने की आवश्यकता है। हमारे मामले में, यह कुछ इस तरह दिखेगा:

 # config TRAC_ENV = '/var/www/trac' GIT_PATH = '/usr/bin/git' TRAC_ADMIN = '/usr/local/bin/trac-admin' #REPO_NAME = '(default)' # if you are using gitolite or sth similar, you can get the repo name from envir REPO_NAME = os.getenv('GL_REPO') 

गिटोलिट के पास हुक आयोजित करने के लिए अपनी प्रणाली है, ठीक से पंजीकृत है, वे उन सभी रिपॉजिटरी के लिए काम करते हैं जिन्हें वे नियंत्रित करते हैं, जो वास्तव में आवश्यक है। ऐसा करने के लिए, उपयोगकर्ता के रूप में निम्नलिखित सामग्री के साथ एक ~ / .ITolite / हुक / पोस्ट-प्राप्त फ़ाइल बनाएं:

 #!/bin/bash python /var/www/trac/hooks/trac-post-receive-hook-0.12-new-commits-from-all-branches.py 

और अंत में, निम्न आदेशों को निष्पादित करके इस हुक को सक्रिय करें।

 sudo su git cd ~/.gitolite/hooks/ chmod 755 post-receive gl-setup 

निष्कर्ष

मुझे उम्मीद है कि मेरा लेख किसी को इस मुद्दे से निपटने या कम से कम समय बचाने में मदद करेगा।