रेल 4 इंजन। माउंटेबल इंजन के माध्यम से मणि विकास - सर्वर लॉग पढ़ें

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

मणि के निर्माण के बारे में होबे पर पहले से ही लेख थे ( समय दो तीन )

लेकिन उनके आधार पर एक पूर्ण रत्न तैयार करना असंभव है - वे बहुत पुरानी हैं और, एक नियम के रूप में, कंजूस आधिकारिक दस्तावेज का अनुवाद हैं। और सबसे महत्वपूर्ण बात, वे ज्यादातर रीडमी और लाइसेंस फ़ाइलों के निर्माण का वर्णन करते हैं, और वास्तविक मणि की कार्यक्षमता हैलो वर्ल्ड के लिए नीचे आती है।

समस्या

मुझे नहीं पता कि किसी के पास यह कैसे है, लेकिन मेरे पास नियमित रूप से एक स्थिति है - मैंने एक नई सुविधा को स्थानीय रूप से खराब कर दिया है, इसकी जांच की है, यह काम करने लगता है। आप टोपी तैनात चलाते हैं, सर्वर को देखते हैं, और वहां

“क्षमा करें, लेकिन कुछ गलत हो गया।
यदि आप अनुप्रयोग के स्वामी हैं तो अधिक जानकारी के लिए लॉग की जाँच करें। ”

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

विचार

एक मणि लिखें जो टेल कमांड के परिणामों को दिए गए पथ पर ब्राउज़र को आउटपुट करेगा। यह लॉग / फ़ोल्डर में सभी .log फ़ाइलों को देखने में सक्षम होने के लिए सलाह दी जाती है

तुरंत दिखाओ कि अंत में क्या हुआ:

आपको केवल Gemfile में पंजीकरण करना है

gem 'tail' 

मणि स्थापित करें

 bundle install 

और उदाहरण के लिए, इसे ( config/routes.rb ) को अनुप्रयोग में वांछित बिंदु पर माउंट करें

 mount Tail::Engine, at: "/tail" 

इसके बाद अपने सर्वर पर

यदि एप्लिकेशन Devise का उपयोग करता है, तो आपको पहले उपयोगकर्ता नाम और पासवर्ड दर्ज करना होगा।

कैसे करें?

आमतौर पर, इस तरह के मामलों ( उदाहरण के लिए ) के लिए सिनात्रा-आधारित रत्नों का उपयोग किया जाता है
व्यक्तिगत रूप से, मैं अपने मणि के लिए बिंदु नहीं देख रहा हूँ, क्योंकि मैं रेल का उपयोग करता हूँ और पापात्रा की कोई आवश्यकता नहीं है।

शुरू करने के लिए, यह वास्तविक एप्लिकेशन लिखने के लिए समझ में आता है, जिसे बाद में एक अलग मणि में बदल दिया जाएगा।
मेरे मामले में, इसमें एक नियंत्रक और एक कार्रवाई शामिल होगी:

  class LogsController < ApplicationController before_filter :authenticate_user! if defined? Devise def index @web_logger ||= Log.instance @web_logger.n = params[:n] log_file_name = params[:file_name] || "#{Rails.env}.log" @files = @web_logger.tail(log_file_name) end end 

यह सरल है, हम एक सिंगलटन क्लास का उपयोग करते हैं, जो किसी दिए गए .log फ़ाइल से दी गई लाइनों की संख्या लौटाता है। लॉग क्लास अपने आप में कोई दिलचस्पी नहीं है। जब तक लॉग प्राप्त करने की बहुत विधि नहीं:

 @files.include?(file_name) ? `tail -n #{@n} log/#{file_name}`.lines : [] 

रूबी मूल रूप से आपको ओएस कमांड्स को निष्पादित करने की अनुमति देती है, बस इसे इन में संलग्न करना (नरक जानता है कि उन्हें सही तरीके से क्या कहा जाता है) वर्ण: `tail -n 40 production.log` - फ़ाइल से अंतिम 40 लाइनें लौटाता है।

परिणामस्वरूप पंक्तियों को एक तालिका में रखा गया है, सीएसएस के साथ थोड़ा परिष्कृत और प्रदर्शित किया गया है।

जावास्क्रिप्ट की एक पंक्ति (अच्छी तरह से ज्ञात ढांचा - वेनिला.जेएस ) स्क्रीन को अंतिम पंक्ति तक नीचे ले जाती है:

 'window.scrollTo(0, document.body.scrollHeight);' 

हम आवेदन से मणि बनाते हैं।

हैबे और सम्मानित रेयान बेट्स के लेखों में बंडल जेम कमांड के माध्यम से मणि के निर्माण का वर्णन किया गया है। नवीनतम वीडियो नवंबर 2011 तक का है।
अब इंजनों के माध्यम से रेल रत्न बनाने की सिफारिश की गई है।

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

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

रत्नों के लिए जो केवल सीमित रेल कार्यक्षमता के साथ काम करते हैं (उदाहरण के लिए, एक नया सहायक या नियंत्रक फ़िल्टर बनाना) - प्लगइन्स का उपयोग करना बेहतर है

तो, पूंछ नामक भविष्य का रत्न बनाएं

 rails plugin new tail --mountable 

--mountable वास्तव में माउंटेबल इंजन के निर्माण को अपेक्षाकृत सरल प्लगइन से अलग करता है।


बहुत मज़ेदार टीम है। यदि आप परिणामस्वरूप बनाए गए फ़ोल्डर संरचना को देखते हैं, तो यह सामान्य रेल एप्लिकेशन और bundle gem कमांड के परिणाम का मिश्रण होगा।

तीन मुख्य बिंदु:

पहले

engine.rb फ़ोल्डर भविष्य के मणि का आधार होगा और इसमें सबसे महत्वपूर्ण फ़ाइल engine.rb है। engine.rb

 module Tail class Engine < ::Rails::Engine isolate_namespace Tail end end 

मणि नामक एक मॉड्यूल एक पृथक नाम स्थान के साथ बनाया गया है, जिसमें आपके सभी मॉडल, नियंत्रक, दृश्य और कक्षाएं लपेटी जाएंगी। यानी SomeClass क्लास के बजाय आपके पास Tail::SomeClass , जो मार्गों और रास्तों के साथ समान है - इसके बजाय, उदाहरण के लिए, messages_path आप tail.messages_path यदि आपको मणि वेब भाग में जाने की आवश्यकता है।
बेशक, यह मणि के नाम और अनुप्रयोगों के टकराव को खत्म करने के लिए किया जाता है जहां इसे माउंट किया जाएगा।

app/ में app/ फ़ोल्डरों की संरचना पर ध्यान दें: मणि नाम के साथ एक अतिरिक्त सबफ़ोल्डर उनमें से प्रत्येक में जोड़ा जाता है, जिसमें आवश्यक फाइलें जोड़ी जाती हैं। फ़ाइलों और सहायकों के लिए पथ को प्रभावित करता है।

दूसरा,

.gemspec फ़ाइल - pesonal जानकारी का वर्णन करने के अलावा, इसमें अन्य रत्नों पर निर्भरता की एक सूची और विधानसभा के लिए आवश्यक फ़ाइलों की एक सूची शामिल है।

lib / version.rb - gem'a संस्करण संख्या। यह अनुशंसा की जाती है कि आप semver.org पर वर्णित संकेतन का उपयोग करें। एक साधारण बात है, लेकिन मैं इस पर ध्यान आकर्षित करता हूं, क्योंकि संस्करण को बदलने के बिना जेम'ए के अगले प्रकाशन की अनुमति नहीं है।

और तीसरा:

परीक्षण / डमी फ़ोल्डर - इसमें एक फर्जी एप्लिकेशन है जो पहले से ही माउंट किया गया है (/test/dummy/config/routes.rb)। यानी, मणि के काम की जांच करने के लिए, बस इस फ़ोल्डर में जाएं और रेल सर्वर शुरू करें। मेरा आवेदन लोकलहोस्ट: 3000 / पूंछ पर होगा। वास्तव में बहुत सहज है।

मणि भरें

 rails generate resource log 

मैं मचान का उपयोग नहीं करता हूं, क्योंकि सीआरयूडी और पीढ़ी के विचारों की कोई आवश्यकता नहीं है।

मैं मौजूदा कक्षाओं से उत्पन्न फ़ाइलों में कोड स्थानांतरित करता हूं। यह सुनिश्चित करने लायक है कि test/dummy से नकली एप्लिकेशन चलाकर सब कुछ काम करता है।

सब कुछ, अब से, मणि को जोड़ा जा सकता है और एक अन्य अनुप्रयोग में डीबग किया जा सकता है:

 gem 'tail', path: '~/projects/tail' 

या

 gem 'tail' , git: 'git://github.com/k2m30/tail.git' #   push  github 

मुख्य बात यह है कि संस्करण फ़ाइल को अपडेट करने के लिए मत भूलना और प्रत्येक परिवर्तन के बाद मणि का उपयोग करके एप्लिकेशन में bundle update tail ।

प्रकाशन

माणिक पर रत्न प्रकाशित करने के लिए, आपको वहां पंजीकरण करना होगा।

उसके बाद, रत्न परियोजना फ़ोल्डर में
मणि बनाने के लिए

 rake build 

हेल्पर टीम

 gem push 

यह मणि बनाने में शामिल नहीं है, यह केवल एक आसान तरीका है, जो रूबीगैम्स क्रेडिट को रिलीज़ करने के लिए बताता है। केवल एक बार प्रवेश करने की आवश्यकता है।

वास्तव में प्रकाशन।

 rake release 

उसके तुरंत बाद, मणि रूबीज पर एक खोज में दिखाई देगा और अन्य डेवलपर्स के लिए मणि स्थापित के माध्यम से उपलब्ध होगा।

कुल मिलाकर

1. एक माउंटेबल रेल रत्न बनाने के लिए, निम्न कार्य करें:
कंकाल बनाएँ

 rails plugin new tail --mountable 

2. एक परिचित रेल आवेदन के साथ इसे भरें
मामूली विशेषताएं हैं, लेकिन वे कम हैं और वे अच्छी तरह से वर्णित हैं।
यह देखना बहुत आसान है कि आपने test/dummy/ फ़ोल्डर में rails server चलाकर क्या किया

3. एक रत्न बनाएँ

 rake build 

4. rubygems.org पर रजिस्टर करें और अपने उपयोगकर्ता नाम और पासवर्ड को इंगित करें:

 gem push 

जारी करो

 rake release 

बस इतना ही, आप अपने खुद के मणि के खुश मालिक हैं

वैसे, प्रकाशन के समय माणिक दावा करते हैं कि मेरे मणि को 151 बार पहले ही डाउनलोड किया जा चुका है। विश्वास करना बहुत कठिन नहीं है, लेकिन अच्छा है।

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

मुझे वास्तव में उम्मीद है कि मेरा लेख, और जो जानता है, मणि अपने आप उपयोगी हो जाएगा और किसी के समय और तंत्रिकाओं को बचाएगा।

---

संदर्भ

http://wangjohn.imtqy.com/railties/rails/gsoc/2013/07/10/introduction-to-railties.html
http://blog.thepete.net/2010/11/creating-and-publishing-your-first-ruby.html
रूसी में रेल
Github.com पर ही रत्न
वह rubygems.org पर है