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

दिलचस्प? तो कृपया, कट के तहत, हम आपको बताएंगे और आपको सब कुछ दिखाएंगे।

चलिए एक उदाहरण से शुरू करते हैं

हम अपनी भूमिका की कार्यक्षमता का केवल एक भाग ही देखेंगे। आप हमेशा इसकी सभी क्षमताओं और इनपुट मापदंडों का पूरा विवरण पा सकते हैं प्रलेखन. लेकिन इसे सौ बार देखने की तुलना में एक बार प्रयास करना बेहतर है, तो आइए एक छोटा एप्लिकेशन तैनात करें।

टारनटूल कार्ट्रिज है ट्यूटोरियल एक छोटा कार्ट्रिज एप्लिकेशन बनाना जो बैंक ग्राहकों और उनके खातों के बारे में जानकारी संग्रहीत करता है, और HTTP के माध्यम से डेटा प्रबंधन के लिए एक एपीआई भी प्रदान करता है। इसे प्राप्त करने के लिए, परिशिष्ट दो संभावित भूमिकाओं का वर्णन करता है: api и storage, जिसे उदाहरणों को सौंपा जा सकता है।

कार्ट्रिज स्वयं प्रक्रियाओं को लॉन्च करने के तरीके के बारे में कुछ नहीं कहता है, यह केवल पहले से चल रहे उदाहरणों को कॉन्फ़िगर करने की क्षमता प्रदान करता है। उपयोगकर्ता को बाकी काम स्वयं करना होगा: कॉन्फ़िगरेशन फ़ाइलों को व्यवस्थित करना, सेवाएँ प्रारंभ करना और टोपोलॉजी को कॉन्फ़िगर करना। लेकिन हम यह सब नहीं करेंगे; Ansible हमारे लिए यह करेगा।

शब्दों से कर्मों तक

तो, आइए अपने एप्लिकेशन को दो वर्चुअल मशीनों पर तैनात करें और एक सरल टोपोलॉजी सेट करें:

• प्रतिकृतिसेट app-1 भूमिका को क्रियान्वित करेंगे api, जिसमें भूमिका शामिल है vshard-router. यहां केवल एक ही उदाहरण होगा.
• प्रतिकृतिसेट storage-1 भूमिका को क्रियान्वित करता है storage (और उस समय पर ही vshard-storage), यहां हम विभिन्न मशीनों से दो उदाहरण जोड़ेंगे।

चलाने के लिए हमें जिस उदाहरण की आवश्यकता है आवारा и Ansible (संस्करण 2.8 या पुराना)।

भूमिका स्वयं में है Ansible गैलेक्सी. यह एक भंडार है जो आपको अपना काम साझा करने और तैयार भूमिकाओं का उपयोग करने की अनुमति देता है।

आइए एक उदाहरण के साथ रिपॉजिटरी को क्लोन करें:

$ git clone https://github.com/dokshina/deploy-tarantool-cartridge-app.git
$ cd deploy-tarantool-cartridge-app && git checkout 1.0.0

हम वर्चुअल मशीनें बढ़ाते हैं:

$ vagrant up

टारनटूल कार्ट्रिज को स्थापित करने योग्य भूमिका:

$ ansible-galaxy install tarantool.cartridge,1.0.1

स्थापित भूमिका लॉन्च करें:

$ ansible-playbook -i hosts.yml playbook.yml

हम प्लेबुक के निष्पादन पूरा होने की प्रतीक्षा करते हैं, पर जाएँ http://localhost:8181/admin/cluster/dashboard और परिणाम का आनंद लें:

आप डेटा अपलोड कर सकते हैं. बिल्कुल सटीक?

अब आइए जानें कि इसके साथ कैसे काम करना है, और साथ ही टोपोलॉजी में एक और प्रतिकृति सेट जोड़ें।

आइए इसका पता लगाना शुरू करें

तो क्या हुआ?

हमने दो वर्चुअल मशीनें स्थापित कीं और एक एंसिबल प्लेबुक लॉन्च की, जिसने हमारे क्लस्टर को कॉन्फ़िगर किया। आइए फ़ाइल की सामग्री को देखें playbook.yml:

---
- name: Deploy my Tarantool Cartridge app
  hosts: all
  become: true
  become_user: root
  tasks:
  - name: Import Tarantool Cartridge role
    import_role:
      name: tarantool.cartridge

यहां कुछ भी दिलचस्प नहीं होता है, आइए एक सार्थक भूमिका शुरू करें जिसे कहा जाता है tarantool.cartridge.

सभी सबसे महत्वपूर्ण चीजें (अर्थात्, क्लस्टर कॉन्फ़िगरेशन) स्थित हैं सूची-फ़ाइल hosts.yml:

---
all:
  vars:
    # common cluster variables
    cartridge_app_name: getting-started-app
    cartridge_package_path: ./getting-started-app-1.0.0-0.rpm  # path to package

    cartridge_cluster_cookie: app-default-cookie  # cluster cookie

    # common ssh options
    ansible_ssh_private_key_file: ~/.vagrant.d/insecure_private_key
    ansible_ssh_common_args: '-o IdentitiesOnly=yes -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no'

  # INSTANCES
  hosts:
    storage-1:
      config:
        advertise_uri: '172.19.0.2:3301'
        http_port: 8181

    app-1:
      config:
        advertise_uri: '172.19.0.3:3301'
        http_port: 8182

    storage-1-replica:
      config:
        advertise_uri: '172.19.0.3:3302'
        http_port: 8183

  children:
    # GROUP INSTANCES BY MACHINES
    host1:
      vars:
        # first machine connection options
        ansible_host: 172.19.0.2
        ansible_user: vagrant

      hosts:  # instances to be started on the first machine
        storage-1:

    host2:
      vars:
        # second machine connection options
        ansible_host: 172.19.0.3
        ansible_user: vagrant

      hosts:  # instances to be started on the second machine
        app-1:
        storage-1-replica:

    # GROUP INSTANCES BY REPLICA SETS
    replicaset_app_1:
      vars:  # replica set configuration
        replicaset_alias: app-1
        failover_priority:
          - app-1  # leader
        roles:
          - 'api'

      hosts:  # replica set instances
        app-1:

    replicaset_storage_1:
      vars:  # replica set configuration
        replicaset_alias: storage-1
        weight: 3
        failover_priority:
          - storage-1  # leader
          - storage-1-replica
        roles:
          - 'storage'

      hosts:   # replica set instances
        storage-1:
        storage-1-replica:

हमें बस यह सीखना है कि इस फ़ाइल की सामग्री को बदलकर इंस्टेंस और प्रतिकृतियों को कैसे प्रबंधित किया जाए। आगे हम इसमें नए सेक्शन जोड़ेंगे। भ्रमित न होने के लिए उन्हें कहां जोड़ें, आप इस फ़ाइल के अंतिम संस्करण को देख सकते हैं, hosts.updated.yml, जो उदाहरण भंडार में है।

उदाहरण प्रबंधन

अन्सिबल शब्दों में, प्रत्येक इंस्टेंस एक होस्ट है (हार्डवेयर सर्वर के साथ भ्रमित नहीं होना चाहिए), यानी। इंफ्रास्ट्रक्चर नोड जिसे Ansible प्रबंधित करेगा। प्रत्येक होस्ट के लिए हम कनेक्शन पैरामीटर निर्दिष्ट कर सकते हैं (जैसे ansible_host и ansible_user), साथ ही इंस्टेंस कॉन्फ़िगरेशन। उदाहरणों का विवरण अनुभाग में है hosts.

आइए इंस्टेंस कॉन्फ़िगरेशन को देखें storage-1:

all:
  vars:
    ...

  # INSTANCES
  hosts:
    storage-1:
      config:
        advertise_uri: '172.19.0.2:3301'
        http_port: 8181

  ...

परिवर्तनशील में config हमने उदाहरण पैरामीटर निर्दिष्ट किए - advertise URI и HTTP port.
नीचे उदाहरण पैरामीटर हैं app-1 и storage-1-replica.

हमें Ansible को प्रत्येक उदाहरण के लिए कनेक्शन पैरामीटर बताने की आवश्यकता है। उदाहरणों को वर्चुअल मशीन समूहों में समूहित करना तर्कसंगत लगता है। इस प्रयोजन के लिए, उदाहरणों को समूहों में संयोजित किया जाता है host1 и host2, और अनुभाग में प्रत्येक समूह में vars मान दर्शाए गए हैं ansible_host и ansible_user एक वर्चुअल मशीन के लिए. और अनुभाग में hosts - होस्ट (उर्फ उदाहरण) जो इस समूह में शामिल हैं:

all:
  vars:
    ...
  hosts:
    ...
  children:
    # GROUP INSTANCES BY MACHINES
    host1:
      vars:
        # first machine connection options
        ansible_host: 172.19.0.2
        ansible_user: vagrant
       hosts:  # instances to be started on the first machine
        storage-1:

     host2:
      vars:
        # second machine connection options
        ansible_host: 172.19.0.3
        ansible_user: vagrant
       hosts:  # instances to be started on the second machine
        app-1:
        storage-1-replica:

हम बदलना शुरू करते हैं hosts.yml. आइए दो और उदाहरण जोड़ें, storage-2-replica पहली वर्चुअल मशीन पर और storage-2 दूसरे पर:

all:
  vars:
    ...

  # INSTANCES
  hosts:
    ...
    storage-2:  # <==
      config:
        advertise_uri: '172.19.0.3:3303'
        http_port: 8184

    storage-2-replica:  # <==
      config:
        advertise_uri: '172.19.0.2:3302'
        http_port: 8185

  children:
    # GROUP INSTANCES BY MACHINES
    host1:
      vars:
        ...
      hosts:  # instances to be started on the first machine
        storage-1:
        storage-2-replica:  # <==

    host2:
      vars:
        ...
      hosts:  # instances to be started on the second machine
        app-1:
        storage-1-replica:
        storage-2:  # <==
  ...

उत्तरदायी प्लेबुक लॉन्च करें:

$ ansible-playbook -i hosts.yml 
                   --limit storage-2,storage-2-replica 
                   playbook.yml

कृपया विकल्प पर ध्यान दें --limit. चूँकि प्रत्येक क्लस्टर इंस्टेंस Ansible शब्दों में एक होस्ट है, हम स्पष्ट रूप से निर्दिष्ट कर सकते हैं कि प्लेबुक निष्पादित करते समय कौन से इंस्टेंस को कॉन्फ़िगर किया जाना चाहिए।

वेब यूआई पर वापस जा रहे हैं http://localhost:8181/admin/cluster/dashboard और हमारे नए उदाहरण देखें:

आइए यहीं न रुकें और टोपोलॉजी प्रबंधन में महारत हासिल करें।

टोपोलॉजी प्रबंधन

आइए अपने नए उदाहरणों को एक प्रतिकृति सेट में संयोजित करें storage-2. आइए एक नया समूह जोड़ें replicaset_storage_2 और इसके अनुरूप इसके चर में प्रतिकृति पैरामीटर का वर्णन करें replicaset_storage_1. अनुभाग में hosts आइए इंगित करें कि इस समूह में कौन से उदाहरण शामिल होंगे (अर्थात, हमारा प्रतिकृति सेट):

---
all:
  vars:
    ...
  hosts:
    ...
  children:
    ...
    # GROUP INSTANCES BY REPLICA SETS
    ...
    replicaset_storage_2:  # <==
      vars:  # replicaset configuration
        replicaset_alias: storage-2
        weight: 2
        failover_priority:
          - storage-2
          - storage-2-replica
        roles:
          - 'storage'

      hosts:   # replicaset instances
        storage-2:
        storage-2-replica:

आइए प्लेबुक फिर से शुरू करें:

$ ansible-playbook -i hosts.yml 
                   --limit replicaset_storage_2 
                   --tags cartridge-replicasets 
                   playbook.yml

पैरामीटर में --limit इस बार हमने उस समूह का नाम पारित किया जो हमारी प्रतिकृति से मेल खाता है।

आइए विकल्प पर विचार करें tags.

हमारी भूमिका क्रमिक रूप से विभिन्न कार्य करती है, जिन्हें निम्नलिखित टैग से चिह्नित किया गया है:

• cartridge-instances: उदाहरण प्रबंधन (कॉन्फ़िगरेशन, सदस्यता से कनेक्शन);
• cartridge-replicasets: टोपोलॉजी प्रबंधन (प्रतिकृतिसेट प्रबंधन और क्लस्टर से उदाहरणों का स्थायी निष्कासन (निष्कास);
• cartridge-config: अन्य क्लस्टर मापदंडों का प्रबंधन (वीएसहार्ड बूटस्ट्रैपिंग, स्वचालित फेलओवर मोड, प्राधिकरण पैरामीटर और एप्लिकेशन कॉन्फ़िगरेशन)।

हम स्पष्ट रूप से निर्दिष्ट कर सकते हैं कि हम कार्य का कौन सा भाग करना चाहते हैं, फिर भूमिका शेष कार्यों को छोड़ देगी। हमारे मामले में, हम केवल टोपोलॉजी के साथ काम करना चाहते हैं, इसलिए हमने निर्दिष्ट किया cartridge-replicasets.

आइए अपने प्रयासों के परिणाम का मूल्यांकन करें। हमें एक नई प्रतिकृति मिलती है http://localhost:8181/admin/cluster/dashboard.

हुर्रे!

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

दौड़ना मत भूलना vagrant haltजब आप वर्चुअल मशीनों के साथ काम करना समाप्त कर लें तो उन्हें बंद कर दें।

और हुड के नीचे क्या है?

यहां मैं आपको इस बारे में और अधिक बताऊंगा कि हमारे प्रयोगों के दौरान उत्तरदायी भूमिका के तहत क्या हो रहा था।

आइए चरण दर चरण कार्ट्रिज एप्लिकेशन को तैनात करने पर नजर डालें।

पैकेज स्थापित करना और इंस्टेंस शुरू करना

सबसे पहले आपको पैकेज को सर्वर तक पहुंचाना होगा और इसे इंस्टॉल करना होगा। वर्तमान में भूमिका RPM और DEB पैकेज के साथ काम कर सकती है।

आगे हम इंस्टेंसेस लॉन्च करते हैं। यहां सब कुछ बहुत सरल है: प्रत्येक उदाहरण एक अलग है systemd-सेवा। मैं आपको एक उदाहरण देता हूँ:

$ systemctl start myapp@storage-1

यह कमांड इंस्टेंस लॉन्च करेगा storage-1 क्षुधा myapp. लॉन्च किया गया उदाहरण इसकी तलाश करेगा विन्यास в /etc/tarantool/conf.d/. इंस्टेंस लॉग का उपयोग करके देखा जा सकता है journald.

यूनिट फ़ाइल /etc/systemd/system/[email protected] सिस्टमडी सेवा के लिए पैकेज के साथ वितरित किया जाएगा।

Ansible में पैकेज स्थापित करने और सिस्टमडी सेवाओं को प्रबंधित करने के लिए अंतर्निहित मॉड्यूल हैं; हमने यहां कुछ भी नया आविष्कार नहीं किया है।

क्लस्टर टोपोलॉजी की स्थापना

मज़ा यहां शुरू होता है। सहमत हूँ, पैकेज स्थापित करने और चलाने के लिए एक विशेष Ansible भूमिका से परेशान होना अजीब होगा systemd-सरकारी

आप क्लस्टर को मैन्युअल रूप से कॉन्फ़िगर कर सकते हैं:

• पहला विकल्प: वेब यूआई खोलें और बटन पर क्लिक करें। यह कई उदाहरणों की एक बार शुरुआत के लिए काफी उपयुक्त है।
• दूसरा विकल्प: आप GraphQl API का उपयोग कर सकते हैं। यहां आप पहले से ही कुछ स्वचालित कर सकते हैं, उदाहरण के लिए, पायथन में एक स्क्रिप्ट लिखें।
• तीसरा विकल्प (दृढ़ इच्छाशक्ति वालों के लिए): सर्वर पर जाएं, किसी एक इंस्टेंस का उपयोग करके कनेक्ट करें tarantoolctl connect और लुआ मॉड्यूल के साथ सभी आवश्यक जोड़तोड़ करें cartridge.

हमारे आविष्कार का मुख्य कार्य ठीक यही करना है, जो आपके लिए काम का सबसे कठिन हिस्सा है।

Ansible आपको अपना स्वयं का मॉड्यूल लिखने और इसे एक भूमिका में उपयोग करने की अनुमति देता है। हमारी भूमिका विभिन्न क्लस्टर घटकों को प्रबंधित करने के लिए ऐसे मॉड्यूल का उपयोग करती है।

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

परिणाम

आज हमने बताया और दिखाया कि अपने एप्लिकेशन को टारनटूल कार्ट्रिज पर कैसे तैनात करें और एक सरल टोपोलॉजी कैसे सेट करें। ऐसा करने के लिए, हमने Ansible का उपयोग किया - एक शक्तिशाली उपकरण जो उपयोग में आसान है और आपको एक साथ कई बुनियादी ढांचे नोड्स (हमारे मामले में, क्लस्टर उदाहरण) को कॉन्फ़िगर करने की अनुमति देता है।

ऊपर हमने Ansible का उपयोग करके क्लस्टर कॉन्फ़िगरेशन का वर्णन करने के कई तरीकों में से एक को देखा। एक बार जब आप आगे बढ़ने के लिए तैयार महसूस करें, तो अन्वेषण करें सर्वोत्तम प्रथाओं प्लेबुक लिखने पर. आपको अपनी टोपोलॉजी का उपयोग करके प्रबंधित करना आसान हो सकता है group_vars и host_vars.

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

यदि कुछ काम नहीं करता है, तो सुनिश्चित करें बताना हमें समस्या के बारे में. हम सब कुछ जल्दी से सुलझा लेंगे!

स्रोत: www.habr.com