Већ смо говорили о Тарантоол Цартридге, што вам омогућава да развијете дистрибуиране апликације и пакујете их. Све што је преостало је да научите како да примените ове апликације и управљате њима. Не брините, све смо покрили! Саставили смо све најбоље праксе за рад са Тарантоол Цартридге-ом и писали ансибле-роле, који ће дистрибуирати пакет серверима, покретати инстанце, ујединити их у кластер, конфигурисати ауторизацију, боотстрап всхард, омогућити аутоматско пребацивање на грешку и закрпити конфигурацију кластера.

Занимљиво? Онда, молим вас, испод реза, све ћемо вам рећи и показати.

Почнимо са примером

Погледаћемо само део функционалности наше улоге. Увек можете пронаћи комплетан опис свих његових могућности и улазних параметара документација. Али боље је покушати једном него видети сто пута, па хајде да применимо малу апликацију.

Тарантоол Цартридге има Приручник да направите малу апликацију Цартридге која чува информације о клијентима банке и њиховим рачунима, а такође обезбеђује АПИ за управљање подацима преко ХТТП-а. Да би се то постигло, додатак описује две могуће улоге: 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_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.

Морамо да кажемо Ансибле-у параметре везе за сваку инстанцу. Чини се логичним груписати инстанце у групе виртуелних машина. У ту сврху, инстанце се комбинују у групе 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. Пошто је свака инстанца кластера домаћин у Ансибле терминима, можемо експлицитно навести које инстанце треба да се конфигуришу приликом извршавања плаибоок-а.

Враћамо се на веб кориснички интерфејс 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да зауставите виртуелне машине када завршите са радом са њима.

А шта је испод хаубе?

Овде ћу вам рећи више о томе шта се дешавало испод хаубе ансибле улоге током наших експеримената.

Погледајмо корак по корак примену апликације Цартридге.

Инсталирање пакета и почетне инстанце

Прво морате испоручити пакет на сервер и инсталирати га. Тренутно улога може да ради са РПМ и ДЕБ пакетима.

Затим покрећемо инстанце. Овде је све врло једноставно: свака инстанца је засебна systemd-сервис. даћу вам пример:

$ systemctl start myapp@storage-1

Ова команда ће покренути инстанцу storage-1 апликације myapp. Покренута инстанца ће тражити своје конфигурацију в /etc/tarantool/conf.d/. Дневници инстанци се могу прегледати помоћу journald.

Јединична датотека /etc/systemd/system/[email protected] за системску услугу биће испоручен заједно са пакетом.

Ансибле има уграђене модуле за инсталирање пакета и управљање системским услугама; овде нисмо измислили ништа ново.

Постављање топологије кластера

Овде забава почиње. Слажем се, било би чудно замарати се посебном улогом Ансибле за инсталирање пакета и покретање systemd-услуге.

Можете ручно да конфигуришете кластер:

• Прва опција: отворите веб кориснички интерфејс и кликните на дугмад. Прилично је погодан за једнократно покретање неколико инстанци.
• Друга опција: можете користити ГрапхКл АПИ. Овде већ можете нешто аутоматизовати, на пример, написати скрипту у Пајтону.
• Трећа опција (за јаке воље): идите на сервер, повежите се на једну од инстанци користећи tarantoolctl connect и извршите све потребне манипулације са Луа модулом cartridge.

Главни задатак нашег проналаска је да урадимо управо овај, најтежи део посла за вас.

Ансибле вам омогућава да напишете сопствени модул и користите га у улози. Наша улога користи такве модуле за управљање различитим компонентама кластера.

Како то ради? Ви описујете жељено стање кластера у декларативној конфигурацији, а улога даје сваком модулу свој одељак за конфигурацију као улаз. Модул прима тренутно стање кластера и упоређује га са оним што је примљено као улаз. Затим се кроз сокет једне од инстанци покреће код, који доводи кластер у жељено стање.

Резултати

Данас смо рекли и показали како да примените своју апликацију на Тарантоол Цартридге и поставите једноставну топологију. Да бисмо то урадили, користили смо Ансибле - моћан алат који је једноставан за коришћење и који вам омогућава да истовремено конфигуришете многе инфраструктурне чворове (у нашем случају, инстанце кластера).

Изнад смо погледали један од многих начина да опишемо конфигурацију кластера користећи Ансибле. Када осетите да сте спремни да кренете даље, истражите најбоље праксе о писању играоница. Можда ће вам бити лакше управљати својом топологијом користећи group_vars и host_vars.

Ускоро ћемо вам рећи како да трајно избришете (избаците) инстанце из топологије, покренете всхард, управљате аутоматским режимом преласка на грешку, конфигуришете ауторизацију и закрпите конфигурацију кластера. У међувремену, можете сами да учите документација и експериментисати са променом параметара кластера.

Ако нешто не ради, обавезно информисати нас о проблему. Брзо ћемо све средити!

Извор: ввв.хабр.цом