हामीले पहिले नै कुरा गरिसकेका छौं Tarantool कारतूस, जसले तपाईंलाई वितरित अनुप्रयोगहरू विकास गर्न र तिनीहरूलाई प्याकेज गर्न अनुमति दिन्छ। यी सबै अनुप्रयोगहरू कसरी डिप्लोय गर्ने र तिनीहरूलाई व्यवस्थित गर्ने भनेर सिक्न बाँकी छ। चिन्ता नगर्नुहोस्, हामीले यो सबै कभर गरेका छौं! हामीले Tarantool Cartridge सँग काम गर्ने सबै उत्तम अभ्यासहरू सँगै राख्यौं र लेख्यौं उत्तरदायी भूमिका, जसले सर्भरहरूमा प्याकेज वितरण गर्नेछ, उदाहरणहरू सुरु गर्नेछ, तिनीहरूलाई क्लस्टरमा एकजुट गर्नेछ, प्राधिकरण कन्फिगर गर्नेछ, बुटस्ट्र्याप vshard, स्वचालित फेलओभर सक्षम गर्नेछ र क्लस्टर कन्फिगरेसन प्याच गर्नेछ।

रोचक? त्यसोभए, कृपया, काट अन्तर्गत, हामी तपाईंलाई बताउनेछौं र तपाईंलाई सबै कुरा देखाउनेछौं।

एउटा उदाहरणबाट सुरु गरौं

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

Tarantool कार्ट्रिज छ ट्यूटोरियल एउटा सानो कार्ट्रिज एप्लिकेसन सिर्जना गर्न जसले बैंक ग्राहकहरू र तिनीहरूको खाताहरू बारे जानकारी भण्डारण गर्दछ, र HTTP मार्फत डाटा व्यवस्थापनको लागि API प्रदान गर्दछ। यो प्राप्त गर्न, परिशिष्टले दुई सम्भावित भूमिकाहरू वर्णन गर्दछ: api и storage, जसलाई उदाहरणहरूमा तोक्न सकिन्छ।

कार्ट्रिज आफैले प्रक्रियाहरू कसरी सुरू गर्ने भन्ने बारे केही बोल्दैन, यसले पहिले नै चलिरहेको उदाहरणहरू कन्फिगर गर्ने क्षमता प्रदान गर्दछ। प्रयोगकर्ताले बाँकी आफैं गर्नुपर्छ: कन्फिगरेसन फाइलहरू व्यवस्थित गर्नुहोस्, सेवाहरू सुरू गर्नुहोस् र टोपोलोजी कन्फिगर गर्नुहोस्। तर हामी यो सबै गर्दैनौं; उत्तरदायीले यो हाम्रो लागि गर्नेछ।

शब्द देखि कर्म सम्म

त्यसोभए, हाम्रो अनुप्रयोगलाई दुई भर्चुअल मेसिनहरूमा डिप्लोय गरौं र एक साधारण टोपोलोजी सेट अप गरौं:

• प्रतिकृति सेट app-1 भूमिकालाई कार्यान्वयन गर्नेछ api, जसमा भूमिका समावेश छ vshard-router। यहाँ एउटा मात्र उदाहरण हुनेछ।
• प्रतिकृति सेट storage-1 भूमिका लागू गर्दछ storage (र एकै समयमा vshard-storage), यहाँ हामी विभिन्न मेसिनहरूबाट दुई उदाहरणहरू थप्नेछौं।

हामीलाई चाहिने उदाहरण चलाउन ब्यवहार и अज्ञात (संस्करण २.८ वा पुरानो)।

भूमिका आफैमा छ उत्तरदायी ग्यालेक्सी। यो एक भण्डार हो जसले तपाईंलाई आफ्नो काम साझा गर्न र तयार भूमिकाहरू प्रयोग गर्न अनुमति दिन्छ।

एउटा उदाहरणको साथ भण्डार क्लोन गरौं:

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

हामी भर्चुअल मेसिनहरू बढाउँछौं:

$ vagrant up

Tarantool कारतूस उत्तरदायी भूमिका स्थापना गर्नुहोस्:

$ 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 सेवाहरू प्रबन्ध गर्नका लागि निर्मित मोड्युलहरू छन्; हामीले यहाँ केहि नयाँ आविष्कार गरेका छैनौं।

क्लस्टर टोपोलोजी स्थापना गर्दै

यहाँ रमाइलो सुरु हुन्छ। सहमत हुनुहोस्, प्याकेजहरू स्थापना गर्न र चलाउनको लागि विशेष उत्तरदायी भूमिकाको साथ चिन्ता गर्नु अनौठो हुनेछ systemd- सेवाहरू।

तपाईं म्यानुअल रूपमा क्लस्टर कन्फिगर गर्न सक्नुहुन्छ:

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

हाम्रो आविष्कारको मुख्य कार्य भनेको ठ्याक्कै यो गर्नु हो, तपाईंको लागि कामको सबैभन्दा कठिन भाग।

Ansible ले तपाईंलाई आफ्नै मोड्युल लेख्न र भूमिकामा प्रयोग गर्न अनुमति दिन्छ। हाम्रो भूमिकाले विभिन्न क्लस्टर कम्पोनेन्टहरू व्यवस्थापन गर्न त्यस्ता मोड्युलहरू प्रयोग गर्दछ।

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

परिणामहरू

आज हामीले Tarantool Cartridge मा तपाइँको आवेदन कसरी डिप्लोय गर्ने र एक साधारण टोपोलोजी सेट अप गर्ने भनेर बतायौँ र देखायौँ। यो गर्नको लागि, हामीले Ansible - एक शक्तिशाली उपकरण प्रयोग गर्‍यौं जुन प्रयोग गर्न सजिलो छ र तपाईंलाई एकै साथ धेरै पूर्वाधार नोडहरू कन्फिगर गर्न अनुमति दिन्छ (हाम्रो अवस्थामा, क्लस्टर उदाहरणहरू)।

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

धेरै चाँडै हामी तपाइँलाई टोपोलोजी, बुटस्ट्र्याप vshard, स्वचालित फेलओभर मोड व्यवस्थापन, प्राधिकरण कन्फिगर र क्लस्टर कन्फिगर प्याचबाट कसरी स्थायी रूपमा मेटाउने (निकाला) उदाहरणहरू बताउनेछौं। यस बीचमा, तपाईं आफ्नो अध्ययन गर्न सक्नुहुन्छ कागजात र क्लस्टर प्यारामिटरहरू परिवर्तन गरेर प्रयोग गर्नुहोस्।

यदि केहि काम गर्दैन भने, निश्चित हुनुहोस् मलाई थाहा दिनु समस्याको बारेमा हामीलाई। हामी छिट्टै सबै कुरा मिलाउनेछौं!

स्रोत: www.habr.com