सभी को नमस्कार!

मैं होटल आरक्षण सेवा Ostrovok.ru में एक DevOps इंजीनियर के रूप में काम करता हूं। इस लेख में मैं अपने अनुभव के बारे में बात करना चाहता हूं, ताकि हम अनजानी भूमिकाओं का परीक्षण कर सकें।

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

अणु

अणु - ansible भूमिकाओं का परीक्षण करने में मदद करने के लिए एक रूपरेखा।

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

अब और विस्तार से।

सिद्धांत की बिट

अणु और चालक: मोलेक्यूल की दो प्रमुख इकाइयों पर विचार करें।

परिदृश्य

स्क्रिप्ट में क्या, कहाँ, कैसे और किस क्रम में प्रदर्शन किया जाएगा, का विवरण है। एक भूमिका में कई स्क्रिप्ट हो सकती हैं, और प्रत्येक पथ के साथ एक निर्देशिका है <role>/molecule/<scenario> , जिसमें परीक्षण के लिए आवश्यक कार्यों का विवरण शामिल है। default स्क्रिप्ट मौजूद होनी चाहिए, जो स्वचालित रूप से बनाई जाएगी यदि आप अणु का उपयोग करते हुए भूमिका को शुरू करते हैं। निम्नलिखित परिदृश्यों के नाम आपके विवेक पर चुने गए हैं।

स्क्रिप्ट में परीक्षण के अनुक्रम को मैट्रिक्स कहा जाता है , और डिफ़ॉल्ट रूप से यह निम्नानुसार है:

(उपयोगकर्ता के द्वारा वर्णित नहीं होने पर डिफ़ॉल्ट रूप से छोड़े गए कदम)

• lint - रन लिंटर। डिफ़ॉल्ट रूप से, yamllint और flake8 ,
• destroy - पिछले अणु प्रक्षेपण से उदाहरणों को हटा दें (यदि छोड़ दिया गया है),
• dependency ? - परीक्षण की भूमिका की विश्वसनीय-निर्भरता की स्थापना,
• syntax - syntax - ansible-playbook --syntax-check , का उपयोग करके किसी भूमिका के वाक्य ansible-playbook --syntax-check
• create - एक उदाहरण बनाएँ,
• prepare ? - उदाहरण की तैयारी; जैसे python2 की जाँच / स्थापना
• converge - परीक्षण की गई प्लेबुक का शुभारंभ,
• idempotence - आलस्य परीक्षण के लिए प्लेबुक को पुनः आरंभ करें,
• side_effect ? - कार्रवाई सीधे भूमिका से संबंधित नहीं है, लेकिन परीक्षणों के लिए आवश्यक है,
• verify - testinfra (डिफ़ॉल्ट) / goss / goss का उपयोग करके परिणामी कॉन्फ़िगरेशन के परीक्षण चलाएं,
• cleanup ? - (नए संस्करणों में) - मोटे तौर पर, बोलचाल से प्रभावित बाहरी बुनियादी ढांचे की "सफाई"
• destroy - एक उदाहरण हटाना।

यह अनुक्रम अधिकांश मामलों को शामिल करता है, लेकिन यदि आवश्यक हो तो आप इसे बदल सकते हैं।

उपर्युक्त चरणों में से प्रत्येक को molecule <command> का उपयोग करके अलग से चलाया जा सकता है। लेकिन यह समझना उचित है कि ऐसे प्रत्येक क्ली-कमांड के लिए अपने स्वयं के अनुक्रम मौजूद हो सकते हैं, जिन्हें molecule matrix <command> निष्पादित करके पहचाना जा सकता है। उदाहरण के लिए, जब आप converge कमांड चलाते हैं (परीक्षण प्लेबुक चलाते हैं), तो निम्न कार्य किए जाएंगे:

 $ molecule matrix converge ... └── default #   ├── dependency #   ├── create #   ├── prepare #   └── converge #   

इन क्रियाओं के अनुक्रम को संपादित किया जा सकता है। यदि सूची में से कुछ पहले ही पूरा हो चुका है, तो इसे छोड़ दिया जाएगा। वर्तमान स्थिति, साथ ही आवृत्ति कॉन्फ़िगरेशन, $TMPDIR/molecule/<role>/<scenario> निर्देशिका में संग्रहीत है।

के साथ कदम जोड़ें ? आप कर सकते हैं, जो कि ansible-playbook के प्रारूप में वांछित क्रियाओं का वर्णन करते हैं, और चरण के अनुसार फ़ाइल का नाम बनाते हैं: side_effect.yml / side_effect.yml । अणु स्क्रिप्ट फ़ोल्डर में इन फ़ाइलों की प्रतीक्षा करेगा।

ड्राइवर

एक चालक एक इकाई है जहां परीक्षण उदाहरण बनाए जाते हैं।
मानक ड्राइवरों की सूची जिसके लिए मोलेक्यूल तैयार है, निम्नानुसार हैं: एज़्योर, डॉकर, ईसी 2, जीसीई, एलएक्ससी, एलएक्सडी, ओपनस्टैक, वैग्रेंट, डेलिगेट।

ज्यादातर मामलों में, टेम्प्लेट स्क्रिप्ट फ़ोल्डर में create.yml और create.yml destroy.yml होती हैं जो क्रमशः उदाहरण के निर्माण और विलोपन का वर्णन करती हैं।
अपवाद डोकर और वैग्रांत हैं, क्योंकि उपरोक्त फ़ाइलों के बिना उनके मॉड्यूल के साथ बातचीत हो सकती है।

यह डेलीगेटेड ड्राइवर को हाइलाइट करने के लायक है, क्योंकि यदि इसका उपयोग किसी इंस्टेंस को बनाने और हटाने के लिए फाइलों में किया जाता है, तो केवल इंस्टेंस के कॉन्फ़िगरेशन के साथ काम किया जाता है, बाकी का वर्णन इंजीनियर द्वारा किया जाना चाहिए।

डिफ़ॉल्ट ड्राइवर Docker है।

अब हम अभ्यास करते हैं और वहां की विशेषताओं पर विचार करते हैं।

शुरुआत हो रही है

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

virtualenv तैयार करें और इसमें molecule स्थापित करें:

 > pip install virtualenv > virtualenv -p `which python2` venv > source venv/bin/activate > pip install molecule docker # molecule  ansible  ; docker   

अगला कदम एक नई भूमिका शुरू करना है।
एक नई भूमिका, साथ ही एक नए परिदृश्य का प्रारंभ, molecule init <params> कमांड का उपयोग करके किया जाता है:

 > molecule init role -r nginx --> Initializing new role nginx... Initialized role in <path>/nginx successfully. > cd nginx > tree -L 1 . ├── README.md ├── defaults ├── handlers ├── meta ├── molecule ├── tasks └── vars 6 directories, 1 file 

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

आइए देखें कि भूमिका निर्देशिका में क्या है:

 > tree molecule/default/ molecule/default/ ├── Dockerfile.j2 # Jinja-  Dockerfile ├── INSTALL.rst. #       ├── molecule.yml #   ├── playbook.yml #    └── tests #     verify └── test_default.py 1 directory, 6 files 

आइए molecule/default/molecule.yml विन्यास का विश्लेषण करते हैं (हम केवल डॉक चित्र की जगह लेंगे):

 --- dependency: name: galaxy driver: name: docker lint: name: yamllint platforms: - name: instance image: centos:7 provisioner: name: ansible lint: name: ansible-lint scenario: name: default verifier: name: testinfra lint: name: flake8 

निर्भरता

यह खंड निर्भरता के स्रोत का वर्णन करता है।

संभावित विकल्प: आकाशगंगा , गिल्ट , शेल।

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

मैं यहां लंबे समय तक नहीं रुकूंगा, यह प्रलेखन में पर्याप्त वर्णित है।

ड्राइवर

ड्राइवर का नाम। हमारे पास यह डॉकटर है।

एक प्रकार का वृक्ष

लिंटर के रूप में, यमलिन्ट का उपयोग किया जाता है।

कॉन्फ़िगरेशन के इस भाग में उपयोगी विकल्प यमलिन्ट, आगे के वातावरण चर या लिंटर को निष्क्रिय करने के लिए एक विन्यास फाइल निर्दिष्ट करने की क्षमता है:

 lint: name: yamllint options: config-file: foo/bar env: FOO: bar enabled: False 

प्लेटफार्मों

उदाहरणों के विन्यास का वर्णन करता है।
एक ड्राइवर के रूप में Dockerfile.j2 के मामले में, Molecule इस खंड पर Dockerfile.j2 होता है, और प्रत्येक सूची आइटम Dockerfile.j2 में item चर के रूप में उपलब्ध होता है।

ड्राइवर के मामले में, जिसमें create.yml और create.yml destroy.yml , अनुभाग उन्हें create.yml रूप में उपलब्ध है, और उस पर पुनरावृत्तियों पहले से ही इन फ़ाइलों में वर्णित हैं।

चूँकि अणु मॉड्यूल के लिए अणु नियंत्रण प्रदान करता है, इसलिए वहाँ संभावित सेटिंग्स की सूची मांगी जानी चाहिए। Docker के लिए, उदाहरण के लिए, docker_container_module मॉड्यूल का उपयोग किया जाता है । अन्य ड्राइवरों में कौन से मॉड्यूल का उपयोग किया जाता है, प्रलेखन में पाया जा सकता है।

और विभिन्न ड्राइवरों का उपयोग करने के उदाहरणों को स्वयं अणु के परीक्षणों में पाया जा सकता है ।

बदलें सेंटोस: 7 यहाँ ubuntu पर।

प्रावधानकर्ता

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

• प्लेबुक : आप निर्दिष्ट कर सकते हैं कि कुछ चरणों में कौन सी प्लेबुक का उपयोग किया जाना चाहिए।

 provisioner: name: ansible playbooks: create: create.yml destroy: ../default/destroy.yml converge: playbook.yml side_effect: side_effect.yml cleanup: cleanup.yml 

• config_options : ansible config

 provisioner: name: ansible config_options: defaults: fact_caching: jsonfile ssh_connection: scp_if_ssh: True 

• connection_options : कनेक्शन पैरामीटर

 provisioner: name: ansible connection_options: ansible_ssh_common_args: "-o 'UserKnownHostsFile=/dev/null' -o 'ForwardAgent=yes'" 

• विकल्प : अस्थिर विकल्प और पर्यावरण चर

 provisioner: name: ansible options: vvv: true diff: true env: FOO: BAR 

परिदृश्य

स्क्रिप्ट अनुक्रम का नाम और विवरण।
आप एक <command>_sequence के डिफ़ॉल्ट एक्शन मैट्रिक्स को बदल सकते हैं <command>_sequence और चरणों की सूची का निर्धारण करते हुए हमें इसके लिए एक मूल्य के रूप में आवश्यक है।
मान लें कि हम प्लेबुक रन कमांड चलाते समय क्रियाओं के अनुक्रम को बदलना चाहते हैं: molecule converge

 # : # - dependency # - create # - prepare # - converge scenario: name: default converge_sequence: - create - converge 

सत्यापनकर्ता

परीक्षणों और इसके लिए लाइनर के लिए रूपरेखा तैयार करना। डिफ़ॉल्ट रूप से, testinfra और flake8 का उपयोग flake8 testinfra में किया testinfra । संभावित विकल्प उपरोक्त के समान हैं:

 verifier: name: testinfra additional_files_or_dirs: - ../path/to/test_1.py - ../path/to/test_2.py - ../path/to/directory/* options: n: 1 enabled: False env: FOO: bar lint: name: flake8 options: benchmark: True enabled: False env: FOO: bar 

आइए अपनी भूमिका पर वापस लौटते हैं। इस तरह दिखने के लिए tasks/main.yml संपादित करें:

 --- - name: Install nginx apt: name: nginx state: present - name: Start nginx service: name: nginx state: started 

और परीक्षणों को molecule/default/tests/test_default.py

 def test_nginx_is_installed(host): nginx = host.package("nginx") assert nginx.is_installed def test_nginx_running_and_enabled(host): nginx = host.service("nginx") assert nginx.is_running assert nginx.is_enabled def test_nginx_config(host): host.run("nginx -t") 

किया, यह केवल चलाने के लिए बनी हुई है (भूमिका की जड़ से, मैं आपको याद दिलाता हूं):

 > molecule test 

 --> Validating schema <path>/nginx/molecule/default/molecule.yml. Validation completed successfully. --> Test matrix └── default ├── lint ├── destroy ├── dependency ├── syntax ├── create ├── prepare ├── converge ├── idempotence ├── side_effect ├── verify └── destroy --> Scenario: 'default' --> Action: 'lint' --> Executing Yamllint on files found in <path>/nginx/... Lint completed successfully. --> Executing Flake8 on files found in <path>/nginx/molecule/default/tests/... Lint completed successfully. --> Executing Ansible Lint on <path>/nginx/molecule/default/playbook.yml... Lint completed successfully. --> Scenario: 'default' --> Action: 'destroy' PLAY [Destroy] ***************************************************************** TASK [Destroy molecule instance(s)] ******************************************** changed: [localhost] => (item=None) changed: [localhost] TASK [Wait for instance(s) deletion to complete] ******************************* ok: [localhost] => (item=None) ok: [localhost] TASK [Delete docker network(s)] ************************************************ PLAY RECAP ********************************************************************* localhost : ok=2 changed=1 unreachable=0 failed=0 --> Scenario: 'default' --> Action: 'dependency' Skipping, missing the requirements file. --> Scenario: 'default' --> Action: 'syntax' playbook: <path>/nginx/molecule/default/playbook.yml --> Scenario: 'default' --> Action: 'create' PLAY [Create] ****************************************************************** TASK [Log into a Docker registry] ********************************************** skipping: [localhost] => (item=None) TASK [Create Dockerfiles from image names] ************************************* changed: [localhost] => (item=None) changed: [localhost] TASK [Discover local Docker images] ******************************************** ok: [localhost] => (item=None) ok: [localhost] TASK [Build an Ansible compatible image] *************************************** changed: [localhost] => (item=None) changed: [localhost] TASK [Create docker network(s)] ************************************************ TASK [Create molecule instance(s)] ********************************************* changed: [localhost] => (item=None) changed: [localhost] TASK [Wait for instance(s) creation to complete] ******************************* changed: [localhost] => (item=None) changed: [localhost] PLAY RECAP ********************************************************************* localhost : ok=5 changed=4 unreachable=0 failed=0 --> Scenario: 'default' --> Action: 'prepare' Skipping, prepare playbook not configured. --> Scenario: 'default' --> Action: 'converge' PLAY [Converge] **************************************************************** TASK [Gathering Facts] ********************************************************* ok: [instance] TASK [nginx : Install nginx] *************************************************** changed: [instance] TASK [nginx : Start nginx] ***************************************************** changed: [instance] PLAY RECAP ********************************************************************* instance : ok=3 changed=2 unreachable=0 failed=0 --> Scenario: 'default' --> Action: 'idempotence' Idempotence completed successfully. --> Scenario: 'default' --> Action: 'side_effect' Skipping, side effect playbook not configured. --> Scenario: 'default' --> Action: 'verify' --> Executing Testinfra tests found in <path>/nginx/molecule/default/tests/... ============================= test session starts ============================== platform darwin -- Python 2.7.15, pytest-4.3.0, py-1.8.0, pluggy-0.9.0 rootdir: <path>/nginx/molecule/default, inifile: plugins: testinfra-1.16.0 collected 4 items tests/test_default.py .... [100%] ========================== 4 passed in 27.23 seconds =========================== Verifier completed successfully. --> Scenario: 'default' --> Action: 'destroy' PLAY [Destroy] ***************************************************************** TASK [Destroy molecule instance(s)] ******************************************** changed: [localhost] => (item=None) changed: [localhost] TASK [Wait for instance(s) deletion to complete] ******************************* changed: [localhost] => (item=None) changed: [localhost] TASK [Delete docker network(s)] ************************************************ PLAY RECAP ********************************************************************* localhost : ok=2 changed=2 unreachable=0 failed=0 

समस्याओं के बिना हमारी सरल भूमिका का परीक्षण किया गया।
यह याद रखने योग्य है कि यदि molecule test के संचालन के दौरान समस्याएं थीं, तो यदि आपने मानक अनुक्रम को नहीं बदला, तो अणु उदाहरण को हटा देगा।

डिबगिंग के लिए निम्न कमांड उपयोगी हैं:

 > molecule --debug <command> # debug info.      . > molecule converge #      . > molecule login #    . > molecule --help #   . 

मौजूदा भूमिका

एक नई भूमिका को मौजूदा भूमिका में जोड़ने से निम्नलिखित कमांड के साथ भूमिका निर्देशिका होती है :

 #     > molecule init scenarion --help #    > molecule init scenario -r <role_name> -s <scenario_name> 

यदि यह भूमिका में पहली स्क्रिप्ट है, तो -s को छोड़ा जा सकता है क्योंकि default स्क्रिप्ट बनाई जाएगी।

निष्कर्ष

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

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