আমরা ইতিমধ্যে সম্পর্কে কথা বলেছি ট্যারান্টুল কার্টিজ, যা আপনাকে বিতরণ করা অ্যাপ্লিকেশন বিকাশ করতে এবং সেগুলি প্যাকেজ করতে দেয়। কিছুই অবশিষ্ট নেই: এই অ্যাপ্লিকেশনগুলি কীভাবে স্থাপন এবং পরিচালনা করতে হয় তা শিখুন। চিন্তা করবেন না, আমরা সবকিছু ভেবেছি! আমরা Tarantool কার্টিজের সাথে কাজ করার জন্য সব সেরা অনুশীলনগুলি একত্রিত করেছি এবং লিখেছি উত্তরযোগ্য ভূমিকা, যা প্যাকেজটিকে সার্ভারে পচিয়ে দেবে, দৃষ্টান্তগুলি শুরু করবে, তাদের একটি ক্লাস্টারে একত্রিত করবে, অনুমোদন কনফিগার করবে, বুটস্ট্র্যাপ vshard, স্বয়ংক্রিয় ব্যর্থতা সক্ষম করবে এবং ক্লাস্টার কনফিগারেশন প্যাচ করবে।

মজাদার? তারপর কাটার নিচে জিজ্ঞেস করি, আমরা সব খুলে দেখাব।

একটি উদাহরণ দিয়ে শুরু করা যাক

আমরা আমাদের ভূমিকার কার্যকারিতার শুধুমাত্র অংশ কভার করব। আপনি সর্বদা এর সমস্ত বৈশিষ্ট্য এবং ইনপুট পরামিতিগুলির একটি সম্পূর্ণ বিবরণ খুঁজে পেতে পারেন৷ ডকুমেন্টেশন. তবে একশোবার দেখার চেয়ে একবার চেষ্টা করা ভাল, তাই আসুন একটি ছোট অ্যাপ্লিকেশন স্থাপন করি।

ট্যারান্টুল কার্টিজ আছে টিউটোরিয়াল একটি ছোট কার্টিজ অ্যাপ্লিকেশন তৈরি করতে যা ব্যাঙ্ক গ্রাহকদের এবং তাদের অ্যাকাউন্ট সম্পর্কে তথ্য সঞ্চয় করে এবং HTTP এর মাধ্যমে ডেটা পরিচালনার জন্য একটি API প্রদান করে। এটি করার জন্য, অ্যাপ্লিকেশন দুটি সম্ভাব্য ভূমিকা বর্ণনা করে: api и storageযে দৃষ্টান্ত বরাদ্দ করা যেতে পারে.

কার্টিজ নিজেই প্রক্রিয়াগুলি কীভাবে শুরু করবেন সে সম্পর্কে কিছু বলে না, এটি কেবল ইতিমধ্যে চলমান উদাহরণগুলি কনফিগার করার ক্ষমতা সরবরাহ করে। ব্যবহারকারীকে বাকিটা নিজে করতে হবে: কনফিগারেশন ফাইলগুলি পচন, পরিষেবাগুলি শুরু করুন এবং টপোলজি সেট আপ করুন। তবে আমরা এই সব করব না, উত্তর আমাদের জন্য এটি করবে।

কথা থেকে কাজে

সুতরাং, আসুন দুটি ভার্চুয়াল মেশিনে আমাদের অ্যাপ্লিকেশন স্থাপন করি এবং একটি সাধারণ টপোলজি সেট আপ করি:

• প্রতিরূপ app-1 ভূমিকা পালন করবে apiযার ভূমিকা অন্তর্ভুক্ত vshard-router. এখানে একটি মাত্র উদাহরণ থাকবে।
• প্রতিরূপ সেট storage-1 ভূমিকা বাস্তবায়ন করে storage (এবং একই সময়ে vshard-storage), এখানে আমরা বিভিন্ন মেশিন থেকে দুটি উদাহরণ যোগ করি।

উদাহরণ চালানোর জন্য, আমাদের প্রয়োজন জাগ্রত и Ansible (সংস্করণ 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আপনার কাজ শেষ হলে VM বন্ধ করতে।

হুডের নীচে কী আছে?

এখানে আমি আমাদের পরীক্ষা-নিরীক্ষার সময় উত্তরযোগ্য ভূমিকার আড়ালে কী ঘটেছিল সে সম্পর্কে আরও কথা বলব।

আসুন ধাপে ধাপে একটি কার্টিজ অ্যাপ্লিকেশন স্থাপনের দিকে নজর দেওয়া যাক।

প্যাকেজ ইনস্টল এবং দৃষ্টান্ত শুরু

প্রথমে আপনাকে সার্ভারে প্যাকেজটি সরবরাহ করতে হবে এবং এটি ইনস্টল করতে হবে। এখন ভূমিকা 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 এবং Lua মডিউল দিয়ে সমস্ত প্রয়োজনীয় ম্যানিপুলেশন সঞ্চালন করুন cartridge.

আমাদের উদ্ভাবনের প্রধান কাজটি এটি করা, আপনার জন্য কাজের সবচেয়ে কঠিন অংশ।

Ansible আপনাকে আপনার নিজের মডিউল লিখতে এবং একটি ভূমিকায় এটি ব্যবহার করতে দেয়। আমাদের ভূমিকা ক্লাস্টারের বিভিন্ন উপাদান পরিচালনা করতে এই মডিউলগুলি ব্যবহার করে।

কিভাবে এটা কাজ করে? আপনি একটি ঘোষণামূলক কনফিগারে ক্লাস্টারের পছন্দসই অবস্থা বর্ণনা করেন এবং ভূমিকা প্রতিটি মডিউলকে তার কনফিগারেশন বিভাগকে ইনপুট হিসাবে দেয়। মডিউল ক্লাস্টারের বর্তমান অবস্থা গ্রহণ করে এবং ইনপুটের সাথে তুলনা করে। এর পরে, একটি উদাহরণের সকেটের মাধ্যমে একটি কোড চালানো হয়, যা ক্লাস্টারটিকে পছন্দসই অবস্থায় নিয়ে আসে।

ফলাফল

আজকে আমরা বলেছি এবং দেখিয়েছি কিভাবে ট্যারান্টুল কার্টিজে আপনার অ্যাপ্লিকেশন স্থাপন করতে হয় এবং একটি সাধারণ টপোলজি সেট আপ করতে হয়। এটি করার জন্য, আমরা Ansible ব্যবহার করেছি, একটি শক্তিশালী টুল যা ব্যবহার করা সহজ এবং আপনাকে একই সাথে অনেকগুলি অবকাঠামো নোড কনফিগার করতে দেয় (আমাদের ক্ষেত্রে, এগুলি ক্লাস্টার উদাহরণ)।

উপরে, আমরা Ansible ব্যবহার করে ক্লাস্টার কনফিগারেশন বর্ণনা করার অনেক উপায়ের একটি নিয়ে আলোচনা করেছি। একবার আপনি জানবেন যে আপনি এগিয়ে যাওয়ার জন্য প্রস্তুত, শিখুন সেরা অভ্যাস প্লেবুক লেখার জন্য। আপনি এর সাথে টপোলজি পরিচালনা করা আরও সুবিধাজনক বলে মনে করতে পারেন group_vars и host_vars.

খুব শীঘ্রই আমরা আপনাকে বলব কিভাবে টপোলজি, বুটস্ট্র্যাপ vshard থেকে দৃষ্টান্তগুলিকে স্থায়ীভাবে অপসারণ (বহিষ্কার) করা যায়, স্বয়ংক্রিয় ব্যর্থতা মোড পরিচালনা করা যায়, অনুমোদন কনফিগার করা যায় এবং ক্লাস্টার কনফিগারেশন প্যাচ করা যায়। এর মধ্যে, আপনি নিজেরাই পড়াশোনা করতে পারেন ডকুমেন্টেশন এবং ক্লাস্টার পরামিতি পরিবর্তনের সাথে পরীক্ষা করুন।

যদি কিছু কাজ না করে, নিশ্চিত হন জানানো সমস্যা সম্পর্কে আমাদের। আমরা দ্রুত এটি ভেঙে ফেলব!

উত্স: www.habr.com