नमक के साथ तैनात करें

अब तक, कई कंपनियों में तैनात बड़ी समस्याएं पैदा करते हैं और दिन, सप्ताह और विशेष रूप से उपेक्षित मामलों में महीनों लग सकते हैं। लेकिन स्थिति निराशाजनक नहीं है। ऐसे कई उपकरण और अभ्यास हैं जो इस मुश्किल काम में मदद कर सकते हैं। लेकिन इन उपकरणों को अक्सर एक या दो दिनों में महारत हासिल नहीं होती है, और समय सीमा समाप्त हो जाती है।

आप आमतौर पर क्या चाहते हैं:

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

यह सब हम Django परियोजना के उदाहरण पर साल्ट + वैग्रंट के एक गुच्छा पर प्राप्त करेंगे। लेकिन अधिकांश तकनीकें केवल पायथन में ही नहीं, बल्कि अन्य भाषाओं में भी डेवलपर्स के लिए उपयोगी होंगी।


तुरंत स्रोत का लिंक दें: bitbucket.org/awnion/salt-django-deploy

नमक क्या है?

यदि आप साल्ट से परिचित हैं, तो आप इस अनुभाग को छोड़ सकते हैं।

नमक क्लस्टर प्रबंधन (क्लस्टर ऑर्केस्ट्रेशन) के लिए एक काफी शक्तिशाली उपकरण है, लेकिन मेरी निजी राय में, यहां तक ​​कि एक मशीन का उपयोग करना काफी न्यायसंगत है और यह ओवरकिल नहीं होगा (मोटे तौर पर बोलें, तो आपकी टीम के पास ठीक 1 डेवलपर है, इसका मतलब यह नहीं है कि आपको इसका उपयोग नहीं करना चाहिए संस्करण नियंत्रण प्रणाली)।

साल्ट स्टेट्स स्लैम एक्सटेंशन वाली YAML फाइलें होती हैं जो बताती हैं कि मशीन किस अवस्था में होनी चाहिए। उदाहरण के लिए, यह फ़ाइल यहां होनी चाहिए, इस सेवा को लॉन्च किया जाना चाहिए, इस उपयोगकर्ता के पास ऐसे अधिकार होने चाहिए, और इसी तरह। साल्ट में, आप न केवल सिस्टम उपयोगिताओं (उपयुक्त, आरपीएम, क्रोन, इनिट स्क्रिप्ट और विभिन्न कॉन्फ़िगरेशन) की स्थिति को बनाए रख सकते हैं, लेकिन, उदाहरण के लिए, आप जांच सकते हैं कि क्या ऐसा उपयोगकर्ता RabbitMQ में मौजूद है, क्या git रिपॉजिटरी का नवीनतम संस्करण, सभी पैकेज में हैं अपने virtualenv और इतने पर। शर्तों की एक पूरी सूची यहां docs.saltstack.com/ref/states/all पर देखी जा सकती है, और मेरी राय में यह बहुत प्रभावशाली है।

नमक के बारे में कुछ तथ्य

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

देव विन्यास

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

git clone <repo_url> && cd <repo_name> && vagrant up 

ठीक है, यह वास्तव में 3 टीमें हैं, लेकिन अगर आप आसान कर सकते हैं - मैं आपका हाथ हिलाता हूं।

इसलिए, हम वैग्रांत पर अपने देव विन्यास का निर्माण करेंगे (उन लोगों के लिए जो वैग्रांट से परिचित नहीं हैं, मैं दृढ़ता से आपसे मिलने की सलाह देता हूं):

 mkdir my_app && cd my_app git init vagrant init 

वैग्रंट के लिए एक git रिपॉजिटरी और कॉन्फिग हमारे my_app फ़ोल्डर में दिखाई दिया।

अगला, निम्नलिखित के साथ Vagrantfile की सामग्री को प्रतिस्थापित करें:

 Vagrant.configure("2") do |config| config.vm.box = "precise64" config.vm.hostname = "dev-my-app" config.vm.network :private_network, ip: '3.3.3.3' config.vm.synced_folder "salt/roots/salt", "/srv/salt/" config.vm.synced_folder "salt/roots/pillar", "/srv/pillar/" config.vm.provision :salt do |salt| salt.minion_config = "salt/minion" salt.run_highstate = true end end 

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

आप यहाँ क्या हो रहा है, इसके बारे में अधिक जानकारी प्राप्त कर सकते हैं

इसलिए, हम राज्य का वर्णन करने के लिए शुरू करने के लिए तैयार हैं। निम्नलिखित सामग्री के साथ एक नमक / मिनियन फ़ाइल बनाएँ:

 file_client: local 

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

अब दो फ़ोल्डर बनाएँ:

 mkdir -p salt/roots/pillar mkdir -p salt/roots/salt 

पहला एक विभिन्न चरों को संग्रहीत करेगा, और दूसरा हमारे अतिथि मशीन के लिए राज्य फ़ोल्डर है।

एक फ़ाइल नमक / जड़ें / नमक / top.sls बनाएँ

 base: 'dev-my-app': - nginx - python - supervisor 

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

आधार हमारे काल्पनिक क्लस्टर के राज्य विन्यास का नाम है। dev-my-app हमारे गेस्ट मशीन का होस्टनाम है। यहां पैटर्न मिलान का उपयोग किया जाता है, अर्थात, हम 'dev- *' निर्दिष्ट कर सकते हैं, और नीचे दिए गए सभी राज्य देव-अल्फ़ा, देव-फ़ोबार, आदि जैसी सभी मशीनों पर लागू होंगे। निम्नलिखित राज्यों की एक सूची है जिसका हमें वर्णन करना होगा।

अजगर, नग्नेक्स और पर्यवेक्षक की घोषित अवस्थाएँ बनाएँ:

नमक / जड़ें / नमक / अजगर

 #    ,   python  python-virtualenv # ,    --      python: pkg: - installed - names: - python - python-virtualenv 

नमक / जड़ें / नमक / nginx.sls

 #    nginx     ,   require # ,   service     pkg nginx: pkg: - installed service: - running - reload: True #   reload - require: - pkg: nginx 

नमक / जड़ें / नमक / सुपरवाइज़र। sls

 supervisor: pkg: - installed service: - running - require: - pkg: supervisor 

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

अब तक, सब कुछ सरल प्रतीत हो रहा है। हम करने के लिए जारी:

स्तंभ चर बनाएं:

नमक / जड़ें / स्तंभ / शीर्ष। sls

 base: 'dev-my-app': - my-app 

नमक / जड़ें / स्तंभ / मेरा app.sls

 my_app: gunicorn_bind: 127.0.0.1:8000 dns_name: dev.my-app.com venv_dir: /home/vagrant/my_app_env work_dir: /vagrant 

पहली फ़ाइल कहती है कि डेव-माय-ऐप होस्ट को मेरे ऐप कॉन्फिगर से वेरिएबल असाइन किया गया है। दूसरी फ़ाइल स्वयं वास्तविक चर है।

अब हमारे Django आवेदन के विन्यास राज्यों के लिए एक फ़ोल्डर बनाएँ:

 mkdir -p salt/roots/salt/my_app 

नमक / जड़ें / नमक / my_app / init.sls

 {% set my_app = pillar['my_app'] %} my_app.venv: virtualenv.managed: - name: {{ my_app['venv_dir'] }} - system_site_packages: False - require: - pkg: python my_app.pip: pip.installed: - bin_env: {{ my_app['venv_dir'] }} - names: - Django==1.6 - gunicorn==18.0 - require: - virtualenv: my_app.venv my_app.nginx.conf: file.managed: - name: /etc/nginx/sites-enabled/my_app.conf - source: salt://my_app/nginx.my_app.conf - context: #    pillar,        bind: {{ my_app['gunicorn_bind'] }} dns_name: {{ my_app['dns_name'] }} - template: jinja - makedirs: True - watch_in: - service: nginx my_app.supervisor.conf: file.managed: - name: /etc/supervisor/conf.d/my_app.conf - source: salt://my_app/supervisor.my_app.conf - context: app_name: my_app bind: {{ my_app['gunicorn_bind'] }} gunicorn: {{ my_app['venv_dir'] }}/bin/gunicorn directory: {{ my_app['work_dir'] }} workers: {{ grains['num_cpus'] * 2 + 1 }} #     - template: jinja - makedirs: True my_app.supervisor: supervisord.running: - name: my_app - watch: - file: my_app.supervisor.conf - require: - pip: my_app.pip - pkg: supervisor 

संकेत : जब निर्भरता, आवश्यकता, घड़ी आदि का निर्माण करते हैं, तो ध्यान रखें कि राज्यों को यादृच्छिक क्रम में जांचा जाएगा। इस लेख को बनाते समय, मैंने इस तरह की गलती की, और django और gunicorn संकुल ने अभी तक वर्चुअलाइज नहीं बनाया है।

नमक / जड़ें / नमक / my_app / nginx.my_app.conf

 server { listen 80; server_name {{ dns_name }} _; location / { proxy_pass http://{{ bind }}; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } } 

नमक / जड़ें / नमक / my_app / पर्यवेक्षक .my_app.conf

 [program:{{ app_name }}] command={{ gunicorn }} {{ app_name }}.wsgi:application -b {{ bind }} -w {{ workers }} directory={{ directory }} user=nobody autostart=true autorestart=true redirect_stderr=true 

नए बनाए गए राज्य को नमक / जड़ों / नमक / top.sls में जोड़ें

 base: 'dev-my-app': - nginx - python - supervisor - my_app # <---- 

हम लगभग हो चुके हैं। लेकिन सबसे महत्वपूर्ण बात याद आ रही है - हमारे काल्पनिक Django एप्लिकेशन का कोड। चलिए एक खाली टेस्ट Django प्रोजेक्ट बनाते हैं:

 vagrant provision 

इस प्रक्रिया में कई मिनट लगेंगे (अधिकांश समय django और gunicorn को virtualenv में स्थापित किया जाएगा)।

जब प्रावधान काम करता है, तो अतिथि मशीन पर जाएं:

 vagrant ssh 

और अंदर निम्नलिखित करता है:

 /home/vagrant/my_app_env/bin/django-admin.py startproject my_app /vagrant exit 

और होस्ट मशीन पर फिर से, योनि प्रावधान करें , और यह जांचने के लिए कि सब कुछ होस्ट फ़ाइल में काम करता है, इसे अस्थायी रूप से लिखें:

 dev.my-app.com 3.3.3.3 

ब्राउज़र में dev.my-app.com पर जाएं, और यदि सब कुछ ठीक है, तो हम देखेंगे कि यह काम कर रहा है!

देव विन्यास निर्मित है। आप प्रतिबद्ध कर सकते हैं।

अब अगर आप अपने दोस्त को अपने प्रोजेक्ट के साथ खेलने देना चाहते हैं, तो उसे केवल git क्लोन और वैजाइनल अप करना होगा । इसके अलावा, इस काल्पनिक दोस्त को न केवल परियोजना का स्रोत कोड प्राप्त होगा, बल्कि यह भी पता होगा कि इसे कैसे तैनात किया जाएगा।

अन्य बातों के अलावा, डिफ़ॉल्ट रूप से, हमारी परियोजना स्वतंत्र रूप से gunicorn + पर्यवेक्षक के नियंत्रण में घूमती है। लेकिन क्या होगा अगर हम दूर से रिमोट करना चाहते हैं या हम अपने पसंदीदा ऑटोरेलोड कोड में बदलाव करना चाहते हैं? कोई सवाल नहीं:

 vagrant ssh supervisorctl stop my_app /home/vagrant/my_app_env/bin/python /vagrant/manage.py runserver 

अब हम सुरक्षित रूप से कोड को संपादित कर सकते हैं, और सभी परिवर्तन django सर्वर द्वारा स्वचालित रूप से उठाए जाएंगे।
और अगर हमारे पास अभी भी मेजबान अस्थायी रूप से ट्विक है , तो वही django सर्वर dev.my-app.com से अनुरोधों का जवाब देगा ।

उत्पादन विन्यास

तो हम सबसे महत्वपूर्ण बात करने के लिए मिला है। हम यह मानते हैं कि हम प्रोडक्ट-माय-ऐप पर तैनात होंगे।

अगला, हम उस स्थिति में तैनाती के विकल्प पर विचार करेंगे जहां हमारे पास नमक-मास्टर के लिए एक अलग सर्वर है (इसके बाद बस एक मास्टर)।

मास्टर कॉन्फ़िगरेशन में कॉपी करें, /srv/salt/top.sls में जोड़ें

  'prod-my-app': - nginx - python - supervisor - my_app 

या हमारे मामले में, आप यह कर सकते हैं:

 base: '*-my-app': - nginx - python - supervisor - my_app 

इसके बाद /srv/pillar/top.sls फ़ाइल के साथ भी ऐसा ही करें

 base: '*-my-app': - my-app 

/Srv/pillar/my_app.sls में हम अपने लेआउट मैप के अनुसार चर बदलते हैं।

ठेस-मेरी-ऐप पर नमक-मिनियन सेट करें। हम नमक-मिनियन को नमक-मास्टर से जोड़ते हैं ( यहां पढ़ें कि यह कैसे करना है)।
अब विज़ार्ड पर आप कॉन्फिग का एप्लिकेशन शुरू कर सकते हैं:

 sudo salt prod-my-app state.highstate 

क्या बचा है:

मास्टर को विन्यास की डिलीवरी

Rsync से git तक के कई तरीके हैं। यह सब आपकी घरेलू नीति पर निर्भर करता है।

ठेस-मेरी ऐप के लिए परियोजना स्रोतों की डिलीवरी

यहाँ फिर से, विकल्पों का एक गुच्छा। व्यक्तिगत रूप से, मैं यह करता हूं: नमक के साथ मैं ठेस-मेरी-ऐप पर समर्थन करता हूं जो एक विशिष्ट प्रतिबद्ध पर गिट रिपॉजिटरी है जिसका हैश स्तंभ में संग्रहीत है, और यदि यह बदलता है, तो नमक काम के अंत में तैनाती स्क्रिप्ट चलाता है।

ईमानदारी से, यह सबसे अच्छा तरीका नहीं है, लेकिन यह सबसे आसान है। आदर्श रूप से, उदाहरण के लिए, मूल पैकेज बनाएँ, या एक निजी pypi बढ़ाएँ।

संदर्भ

www.saltstack.com
www.vagrantup.com
hynek.me/talks/python-deployments एक बहुत उपयोगी लेख है जिसमें अजगर परियोजनाओं की तैनाती पर सार का एक सेट शामिल है।

पुनश्च
दुर्भाग्य से, कई चीजों को याद करना पड़ा, अन्यथा लेख को एक बड़े आकार के लिए प्रेरित किया गया होगा। मैंने या तो स्पष्ट चीजों को याद करने की कोशिश की, या कुछ ऐसा जो दस्तावेज़ में ढूंढना आसान है। हालांकि, टिप्पणियों में प्रश्न पूछें।