📍 😼 👩🏿‍🚀 Capistrano और php 👨🏻‍🎨 🌅 🤾🏿

सभी को नमस्कार। आज मैं फिर से अद्भुत तैनाती के बारे में बात करना चाहूंगा।

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

कैपिस्ट्रानो रूबी में लिखा गया है और यह "मॉड्यूल" (या घटक है, मुझे नहीं पता है कि रेल ढांचे पर रूबी का कितना अच्छा है)।

यह विषय प्रोजेक्ट पेज से ट्यूटोरियल के अनुवाद के लिए कुछ अतिरिक्त, परिवर्तन और संक्षिप्त विवरण के साथ php (या "आरओआर नहीं") के लिए है। यह कई सर्वरों और एक डेटाबेस के साथ काम करने के मुद्दों को संबोधित नहीं करेगा, यह शुरुआती लोगों के लिए सिर्फ एक छोटा गाइड है।

तो, चलो हमारे स्थानीय कंप्यूटर पर / पथ / परिनियोजन / पैकेज से कहते हैं कि php में लिखा गया एक आवेदन है। इस एप्लिकेशन के पास वर्तमान कोड के साथ example.net/project.git पर स्थित एक git रिपॉजिटरी है। हमारे पास ssh एक्सेस और / path / तैनात / फोल्डर के साथ example.com पर एक होस्टिंग भी है जहाँ हम अपनी फाइलें अपलोड करने जा रहे हैं। हम लगातार ftp क्लाइंट के साथ खिलवाड़ नहीं करना चाहते हैं और कैपिस्ट्रानो को समझने के लिए कई घंटे बिताने का फैसला किया है। चलिए शुरू करते हैं।

स्थापना

चलो स्थापना के साथ शुरू करते हैं। कंसोल खोलें और दर्ज करें:

$ sudo apt-get install ruby rubygems $ sudo gem install capistrano

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

  $ mkdir /path/deploy/from/config

यदि वह निर्देशिका जिसमें आप कॉन्फ़िगर निर्देशिका बनाते हैं, वह भी सर्वर की मूल निर्देशिका है, तो इसमें एपाचे के लिए .htaccess फ़ाइल डालना न भूलें, जो इस निर्देशिका से फ़ाइलों को देखने से रोक देगा, या अन्य वेब सर्वर के कॉन्फ़िगरेशन में इस निर्देशिका तक पहुंच को प्रतिबंधित करेगा।

Kapifikatsiya

कैपिस्ट्रानो को स्थापित करने के बाद हमें जो पहली चीज करनी चाहिए, वह है हमारे एप्लिकेशन को "कैपिफाई-न्यूट" करना। "Capfaction" एक आवेदन को तैनात करने के लिए capistrano को कॉन्फ़िगर करने की प्रक्रिया है। यह काफी सरल है: सुनिश्चित करें कि आप अपनी परियोजना के मूल निर्देशिका में हैं और दर्ज करें:

  $ cd /path/deploy/from $ capify .

यह कमांड दो फाइल बनाएगी:

Capfile

मुख्य फ़ाइल है जिसे capistrano की आवश्यकता होती है। जैसे मेकफाइल का उपयोग करता है और रेक रेकफाइल का उपयोग करता है, कैपिस्ट्रानो डिफॉल्ट रूप से कैपफाइल को खोजता है और डाउनलोड करता है। शुरू में उत्पन्न Capfile बहुत सरल है: यह सब "लोड / config.rb" लोड है ...

config/deploy.rb

- फ़ाइल जिसमें एप्लिकेशन की "सेटिंग" होती है।

सामान्यतया, हमें अकेले ही Capfile को छोड़ने और config / तैनात.rb फ़ाइल को बारीकी से निपटने की आवश्यकता है। प्रारंभ में, यह इस तरह दिखेगा:

  set :application, "set your application name here" set :repository, "set your repository location here" set :scm, :subversion # Or: `accurev`, `bzr`, `vcs`, `darcs`, `git`, `mercurial`, `perforce`, `subversion` or `none` role :web, "your web-server here" # Your HTTP server, Apache/etc role :app, "your app-server here" # This may be the same as your `Web` server role :db, "your primary db-server here", :primary => true # This is where Rails migrations will run role :db, "your slave db-server here" # If you are using Passenger mod_rails uncomment this: # if you're still using the script/reapear helper you will need # these http://github.com/rails/irs_process_scripts # namespace :deploy do # task :start do ; end # task :stop do ; end # task :restart, :roles => :app, :except => { :no_release => true } do # run "#{try_sudo} touch #{File.join(current_path,'tmp','restart.txt')}" # end # end

यह कॉन्फिगरेशन हमें शोभा नहीं देता है, इसलिए हम इसे फिर से लिखेंगे।

विन्यास

सबसे पहले आपको एप्लिकेशन को एक नाम देना होगा। चलो इसे "मेरी php एप्लिकेशन" कहते हैं:

  set :application, "my php application"

फिर आपको उस रिपॉजिटरी को निर्दिष्ट करना होगा जहां हमारा कोड स्थित है। यह रिपॉजिटरी आपकी स्थानीय मशीन और होस्टिंग से, जहां आप प्रोजेक्ट को तैनात करना चाहते हैं, दोनों जगह पहुंच योग्य होनी चाहिए। हम अपना भंडार सेट करते हैं:

  set :repository, "ssh://git@example.net/project.git"

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

  set :repository, "ssh://git@example.com:22100/project.git" set :local_repository, "ssh://git@example:project.git"

चूंकि हम सबवर्सन के अलावा एक संस्करण नियंत्रण प्रणाली का उपयोग करते हैं, जिसे डिफ़ॉल्ट रूप से सौंपा गया है, आपको निम्नलिखित पंक्ति दर्ज करनी होगी:

  set :scm, :git

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

निर्देशिका संरचना Capistrano

कैपिस्ट्रानो के साथ सफलतापूर्वक तैनात एक परियोजना में नीचे की तरह एक संरचना होगी (जहां [तैनाती_तो वह निर्देशिका है जहां हम परियोजना को तैनात करना चाहते हैं):

  [deploy_to] [deploy_to]/releases [deploy_to]/releases/20080819001122 [deploy_to]/releases/... [deploy_to]/shared [deploy_to]/shared/log [deploy_to]/shared/pids [deploy_to]/shared/system [deploy_to]/current -> [deploy_to]/releases/20100819001122

हर बार जब आप एक प्रोजेक्ट परिनियोजित करते हैं, तो "रिलीज़" फ़ोल्डर में एक नई निर्देशिका बनाई जाएगी, जिसमें उसका नवीनतम संस्करण कॉपी किया जाएगा। उसके बाद, प्रतीकात्मक लिंक "वर्तमान" अपडेट किया जाएगा और एक नई निर्देशिका को इंगित करेगा। यदि आपके एप्लिकेशन की संरचना RoR या किसी अन्य एप्लिकेशन में एक एप्लिकेशन की संरचना के समान है, जहां प्रोजेक्ट रूट और वेब निर्देशिकाएं अलग-अलग हैं, तो आपको यह सुनिश्चित करने की आवश्यकता है कि सर्वर इस निर्देशिका में कॉन्फ़िगर किया गया है (RoR में, यह [तैनाती_ वर्तमान] / सार्वजनिक /) है।

वापस कॉन्फ़िगरेशन के लिए

इसलिए हमें यह निर्दिष्ट करने की आवश्यकता है कि सर्वर पर हम एप्लिकेशन को कहां तैनात करना चाहते हैं। डिफ़ॉल्ट रूप से, यह फ़ोल्डर है "/ u / apps / # {एप्लिकेशन}" (जहां # {एप्लिकेशन} वह नाम है जिसे हमने चर "उपरोक्त:" अनुप्रयोग में निर्दिष्ट किया है)। चूंकि हमारी निर्देशिका डिफ़ॉल्ट निर्देशिका से अलग है, इसलिए हम इसे स्पष्ट रूप से निर्दिष्ट करते हैं:

  set :deploy_to "/path/deploy/to"

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

  server "example.com"

उन्नत सेटिंग्स

अब कुछ अतिरिक्त चरों को देखते हैं जो आपके लिए उपयोगी हो सकते हैं।

 set :user, "foo"

यदि आप सर्वर से उस नाम के अलावा किसी अन्य नाम से सर्वर से कनेक्ट होते हैं, जिसके तहत आप अपने स्थानीय कंप्यूटर में लॉग इन हैं, तो ssh या ftp एक्सेस के लिए उपयोगकर्ता नाम निर्दिष्ट करता है।

 set :password, "password"

सर्वर से कनेक्ट करने के लिए पासवर्ड सेट करता है। अनुशंसित नहीं है।

```
 set :scm_username, "foo"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     
```
रिपॉजिटरी तक पहुंचने के लिए उपयोगकर्ता नाम निर्दिष्ट करता है यदि आप इसे उस नाम के अलावा किसी अन्य नाम से कनेक्ट करते हैं जिसके तहत आप स्थानीय कंप्यूटर पर लॉग ऑन हैं। सभी vcs इस विकल्प का समर्थन नहीं करते हैं। यदि आपका संस्करण नियंत्रण प्रणाली समर्थन नहीं करती है, तो आपको इस नाम को ": रिपॉजिटरी" पैरामीटर में निर्दिष्ट करना होगा, क्योंकि यह ऊपर किया गया है।

 set :use_sudo, false

डिफ़ॉल्ट रूप से असाइन किया गया। यदि आप किसी भी कार्य को करने के लिए Capistrano sudo को एक्सेस देना चाहते हैं, तो true

सेट करें

 set :via, "scp"

प्रोटोकॉल सेट करता है जिसके द्वारा डेटा कॉपी किया जाएगा।

 set :branch, "master"

उस परियोजना शाखा को इंगित करता है जिसमें से कोड लिया जाएगा।

 set :deploy_via, :remote_cache

सर्वर पर नवीनतम संस्करण का कैश बचाता है और, एक नई तैनाती के साथ, केवल अपडेट डाउनलोड करता है। निश्चित रूप से आप इस पैरामीटर को सेट करना चाहेंगे।

कैपिस्ट्रानो टीमें

हमने अपनी रेसिपी लिखी, इसके बाद आप Capistrano से कुछ प्रश्न पूछ सकते हैं:

 $ cap -h

विकल्पों की एक सूची प्रदर्शित की जाती है।

 $ cap -H

उनमें से प्रत्येक के विस्तृत विवरण के साथ सभी विकल्पों की एक सूची प्रदर्शित की जाएगी।

 $ cap -T

उनमें से प्रत्येक के संक्षिप्त विवरण के साथ सभी कार्यों (या कार्यों) को सूचीबद्ध करता है।

 $ cap -e deploy:web_disable

किसी विशिष्ट कार्य के बारे में विस्तृत जानकारी दिखाएं।

सेटअप

आइए सर्वर के साथ बातचीत करने के लिए कैपिस्ट्रानो का उपयोग करने का प्रयास करें। पहले हमें निर्देशिकाओं की मूल संरचना बनाने की आवश्यकता है:

  $ cap deploy:setup

जब यह कमांड लॉन्च किया जाता है, तो कैपिस्ट्रानो सर्वर से जुड़ जाएगा और "mkdir" कमांड की एक श्रृंखला निष्पादित करेगा। अग्रिम में सुनिश्चित करें कि आपके पास उस निर्देशिका तक पहुँच अधिकार के साथ सब कुछ है जिसमें आप परियोजना को तैनात कर रहे हैं।

निर्भरता की जाँच

अब जब हमारे पास ढांचा है, तो हम कैपिस्ट्रानो से पूछ सकते हैं कि क्या हमारे पास परियोजना के विकास को जारी रखने के लिए आवश्यक सभी चीजें हैं:

  $ cap deploy:check

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

सर्वर को कोड भेजना

अब हम एक पूर्ण तैनाती नहीं करेंगे, लेकिन यह सुनिश्चित करने के लिए सर्वर पर कोड अपलोड करने का प्रयास करें कि इस चरण में सब कुछ क्रम में है:

  $ cap deploy:update

यह कमांड सर्वर से रिपॉजिटरी का कोड डाउनलोड करता है और वर्तमान लिंक को अपडेट करता है।

तैनाती

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

लागू होने के बाद से: अद्यतन और तैनात: अंतिम रूप से तैयार करें आदेश रेल अनुप्रयोगों पर रूबी के लिए विशिष्ट हैं, हमें उन्हें फिर से परिभाषित करने की आवश्यकता है। इन दो आदेशों के अलावा, मैं आपको सलाह देता हूं कि आप तैनाती को फिर से परिभाषित करें: शुरू करें और तैनात करें: आज्ञाओं को रोकें, क्योंकि वे आरओआर के लिए भी तेज हो जाते हैं और, यदि चलाया जाता है, तो त्रुटि हो सकती है (वास्तव में, अन्य विशिष्ट आदेश हैं, लेकिन हम केवल सबसे बुनियादी चीजों को फिर से परिभाषित करते हैं):

  namespace :deploy do task :start do end task :stop do end task :restart do end task :finalize_update do end end

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

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

  after "deploy", "deploy:cleanup"

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

बहुस्तरीय

हमारे विकास में, हम कैपिस्ट्रानो-एक्सटेंट एक्सटेंशन का भी उपयोग करते हैं, जो आपको तथाकथित मल्टीस्टेज करने की अनुमति देता है। मान लीजिए कि आपके पास एक परीक्षण और उत्पादन सर्वर है। आप उनमें से प्रत्येक के लिए एक अलग विन्यास लिख सकते हैं और केवल वांछित सर्वर के लिए तैनात कर सकते हैं।

कमांड लाइन पर एक्सटेंशन स्थापित करने के लिए, टाइप करें:

  $ gem install capistrano-ext

इसके बाद, फ़ोल्डर में / पथ / परिनियोजित / से / कॉन्फ़िगर / एक नई निर्देशिका बनाएं:

  $ mkdir /path/deploy/from/config/deploy

और हमारे व्यंजनों को इसमें डालें: उदाहरण के लिए उत्पादन। आरबी और स्टेजिंग। आरबी। कॉन्फ़िगरेशन के लिए हमें जो कुछ चाहिए वह है दो पंक्तियों को /path/deploy/from/config/deploy.rb फ़ाइल में लिखना :

  set :stages, %w(staging production) require 'capistrano/ext/multistage'

अब आप "टोपी उत्पादन तैनात" और "टोपी मंचन तैनाती" आदेश का उपयोग कर तैनात कर सकते हैं। यदि आपको किसी अन्य कॉन्फ़िगरेशन की आवश्यकता है, तो बस उसे परिनियोजन निर्देशिका में रखें और उसका नाम चर में जोड़ें :stages

:

  set :stages, %w(staging production develop)

यदि आप केवल "कैप तैनाती" कमांड को निष्पादित करने का प्रयास करते हैं, तो कैपिस्ट्रानो आपको चेतावनी देगा कि आपको एक नुस्खा निर्दिष्ट करने की आवश्यकता है जिसके लिए आपको एक तैनाती करने की आवश्यकता है और काम को बाधित करेगा। डिफ़ॉल्ट नुस्खा का उपयोग करने के लिए, आप चर "default_stage" को परिभाषित कर सकते हैं:

  set :stages, %w(staging production develop) set :default_stage, "develop" require 'capistrano/ext/multistage'

कैप तैनाती कमांड अब कैप डेवलपमेंट कमांड कमांड के बराबर होगी।

यह सब, आपके ध्यान के लिए धन्यवाद।

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

मूल ट्यूटोरियल

मल्टीस्टेज के बारे में लेख

help.github.com/capistrano

Capistrano और php