आम्ही याबद्दल आधीच बोललो आहोत टारनटूल काडतूस, जे तुम्हाला वितरित अनुप्रयोग विकसित करण्यास आणि त्यांचे पॅकेज करण्यास अनुमती देते. हे ऍप्लिकेशन कसे उपयोजित करायचे आणि ते कसे व्यवस्थापित करायचे हे शिकणे बाकी आहे. काळजी करू नका, आम्ही हे सर्व कव्हर केले आहे! आम्ही Tarantool Cartridge सोबत काम करण्यासाठी सर्व उत्तम पद्धती एकत्र ठेवल्या आणि लिहिले उत्तरदायी भूमिका, जे सर्व्हरवर पॅकेज वितरित करेल, उदाहरणे लाँच करेल, त्यांना क्लस्टरमध्ये एकत्र करेल, अधिकृतता कॉन्फिगर करेल, vshard बूटस्ट्रॅप करेल, स्वयंचलित फेलओव्हर सक्षम करेल आणि क्लस्टर कॉन्फिगरेशन पॅच करेल.

मनोरंजक? मग कृपया, कट अंतर्गत, आम्ही तुम्हाला सांगू आणि सर्वकाही दाखवू.

चला एका उदाहरणाने सुरुवात करूया

आम्ही फक्त आमच्या भूमिकेच्या कार्यक्षमतेचा काही भाग पाहू. आपण नेहमी त्याच्या सर्व क्षमता आणि इनपुट पॅरामीटर्सचे संपूर्ण वर्णन शोधू शकता दस्तऐवजीकरण. परंतु शंभर वेळा पाहण्यापेक्षा एकदा प्रयत्न करणे चांगले आहे, म्हणून चला एक छोटा अनुप्रयोग उपयोजित करूया.

टारनटूल काडतूस आहे ट्यूटोरियल एक लहान कार्ट्रिज ऍप्लिकेशन तयार करण्यासाठी जे बँक क्लायंट आणि त्यांच्या खात्यांबद्दल माहिती संग्रहित करते आणि HTTP द्वारे डेटा व्यवस्थापनासाठी API देखील प्रदान करते. हे साध्य करण्यासाठी, परिशिष्ट दोन संभाव्य भूमिकांचे वर्णन करते: api и storage, जे उदाहरणांना नियुक्त केले जाऊ शकते.

कार्ट्रिज स्वतः प्रक्रिया कशा सुरू करायच्या याबद्दल काहीही सांगत नाही, ते फक्त आधीपासून चालू असलेल्या घटना कॉन्फिगर करण्याची क्षमता प्रदान करते. वापरकर्त्याने बाकीचे स्वतः केले पाहिजे: कॉन्फिगरेशन फाइल्सची व्यवस्था करा, सेवा सुरू करा आणि टोपोलॉजी कॉन्फिगर करा. पण आम्ही हे सर्व करणार नाही; उत्तरदायी हे आमच्यासाठी करेल.

शब्दांपासून कृतीपर्यंत

तर, चला आमचा अर्ज दोन व्हर्च्युअल मशीनवर तैनात करू आणि एक साधी टोपोलॉजी सेट करू:

• प्रतिकृती app-1 भूमिका राबवेल api, ज्यामध्ये भूमिका समाविष्ट आहे vshard-router. इथे एकच उदाहरण असेल.
• प्रतिकृती storage-1 भूमिका अंमलात आणते storage (आणि त्याच वेळी vshard-storage), येथे आपण वेगवेगळ्या मशीनमधील दोन उदाहरणे जोडू.

आम्हाला आवश्यक उदाहरण चालविण्यासाठी भटक्या и उत्तर द्या (आवृत्ती 2.8 किंवा जुनी).

भूमिका स्वतः मध्ये आहे उत्तरदायी दीर्घिका. हे एक भांडार आहे जे तुम्हाला तुमचे कार्य सामायिक करण्यास आणि तयार भूमिका वापरण्याची परवानगी देते.

उदाहरणासह रेपॉजिटरी क्लोन करू:

$ 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. प्रत्येक क्लस्टर उदाहरण उत्तरदायी अटींमध्ये होस्ट असल्याने, प्लेबुक कार्यान्वित करताना कोणती उदाहरणे कॉन्फिगर करावीत हे आम्ही स्पष्टपणे निर्दिष्ट करू शकतो.

वेब UI वर परत जात आहे 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: इतर क्लस्टर पॅरामीटर्सचे व्यवस्थापन (vshard बूटस्ट्रॅपिंग, ऑटोमॅटिक फेलओव्हर मोड, ऑथोरायझेशन पॅरामीटर्स आणि अॅप्लिकेशन कॉन्फिगरेशन).

आम्ही कामाचा कोणता भाग करू इच्छितो हे आम्ही स्पष्टपणे निर्दिष्ट करू शकतो, नंतर भूमिका उर्वरित कार्ये वगळेल. आमच्या बाबतीत, आम्हाला फक्त टोपोलॉजीसह कार्य करायचे आहे, म्हणून आम्ही निर्दिष्ट केले 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 मध्ये पॅकेजेस स्थापित करण्यासाठी आणि सिस्टमड सेवा व्यवस्थापित करण्यासाठी अंगभूत मॉड्यूल आहेत; आम्ही येथे काहीही नवीन शोध लावलेले नाही.

क्लस्टर टोपोलॉजी सेट करणे

इथूनच मजा सुरू होते. सहमत आहे, पॅकेजेस स्थापित करण्यासाठी आणि चालविण्यासाठी विशेष उत्तरदायी भूमिकेसह त्रास देणे विचित्र होईल systemd-सेवा.

तुम्ही क्लस्टर स्वहस्ते कॉन्फिगर करू शकता:

• पहिला पर्याय: वेब UI उघडा आणि बटणावर क्लिक करा. हे अनेक उदाहरणांच्या एक-वेळच्या प्रारंभासाठी अगदी योग्य आहे.
• दुसरा पर्याय: तुम्ही GraphQl API वापरू शकता. येथे आपण आधीपासूनच काहीतरी स्वयंचलित करू शकता, उदाहरणार्थ, पायथनमध्ये स्क्रिप्ट लिहा.
• तिसरा पर्याय (जोरदार इच्छेसाठी): सर्व्हरवर जा, वापरून एका उदाहरणाशी कनेक्ट करा tarantoolctl connect आणि लुआ मॉड्यूलसह ​​सर्व आवश्यक हाताळणी करा cartridge.

आमच्या शोधाचे मुख्य कार्य हे नक्की करणे आहे, तुमच्यासाठी कामाचा सर्वात कठीण भाग.

Ansible तुम्हाला तुमचे स्वतःचे मॉड्यूल लिहिण्याची आणि भूमिकेत वापरण्याची परवानगी देते. आमची भूमिका विविध क्लस्टर घटक व्यवस्थापित करण्यासाठी अशा मॉड्यूल्सचा वापर करते.

हे कसे कार्य करते? तुम्ही क्लस्टरच्या इच्छित स्थितीचे वर्णनात्मक कॉन्फिगरेशनमध्ये वर्णन करता आणि भूमिका प्रत्येक मॉड्यूलला त्याचे कॉन्फिगरेशन विभाग इनपुट म्हणून प्रदान करते. मॉड्युल क्लस्टरची सद्यस्थिती प्राप्त करते आणि इनपुट म्हणून प्राप्त झालेल्या गोष्टीशी त्याची तुलना करते. पुढे, एका उदाहरणाच्या सॉकेटद्वारे कोड लॉन्च केला जातो, जो क्लस्टरला इच्छित स्थितीत आणतो.

परिणाम

आज आम्ही तुमचा अर्ज Tarantool Cartridge वर कसा तैनात करायचा आणि एक साधी टोपोलॉजी कशी सेट करायची ते सांगितले आणि दाखवले. हे करण्यासाठी, आम्ही अँसिबल वापरले - एक शक्तिशाली साधन जे वापरण्यास सोपे आहे आणि आपल्याला एकाच वेळी अनेक पायाभूत सुविधा नोड्स कॉन्फिगर करण्याची परवानगी देते (आमच्या बाबतीत, क्लस्टर उदाहरणे).

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

टोपोलॉजी, बूटस्ट्रॅप व्हीशार्ड, स्वयंचलित फेलओव्हर मोड व्यवस्थापित करणे, अधिकृतता कॉन्फिगर करणे आणि क्लस्टर कॉन्फिगर पॅच कसे करायचे ते आम्ही तुम्हाला लवकरच कसे हटवायचे (हकलून लावायचे) सांगू. दरम्यान, तुम्ही स्वतः अभ्यास करू शकता दस्तऐवजीकरण आणि क्लस्टर पॅरामीटर्स बदलण्याचा प्रयोग करा.

काहीतरी कार्य करत नसल्यास, खात्री करा मला कळवा आम्हाला समस्येबद्दल. आम्ही त्वरीत सर्वकाही क्रमवारी लावू!

स्त्रोत: www.habr.com