すでに話しました タランツール カートリッジを使用すると、分散アプリケーションを開発してパッケージ化できます。 あとは、これらのアプリケーションを展開して管理する方法を学ぶだけです。 心配しないでください、私たちはすべてを考えました！ Tarantool カートリッジを使用するためのすべてのベスト プラクティスをまとめ、次のように書きました。 ansible-roleこれにより、パッケージがサーバーに分解され、インスタンスが起動され、それらがクラスターに結合され、認証の構成、vshard のブートストラップ、自動フェイルオーバーの有効化、クラスター構成へのパッチ適用が行われます。

面白い？ それから私はカットの下で尋ねます、私たちはすべてを話して見せます。

例から始めましょう

私たちの役割の機能の一部のみを説明します。 すべての機能と入力パラメータの完全な説明は、次の場所でいつでも見つけることができます。 ドキュメンテーション。 ただし、XNUMX 回見るよりも XNUMX 回試してみる方が良いため、小さなアプリケーションをデプロイしてみましょう。

タランツール カートリッジには、 チュートリアル 銀行の顧客とその口座に関する情報を保存し、HTTP 経由でデータを管理するための API も提供する小さなカートリッジ アプリケーションを作成します。 これを行うために、アプリケーションでは XNUMX つの可能な役割を記述します。 api и storageインスタンスに割り当てることができます。

カートリッジ自体はプロセスの開始方法については何も説明せず、すでに実行中のインスタンスを構成する機能のみを提供します。 残りの作業はユーザーが自分で行う必要があります。構成ファイルを分解し、サービスを開始し、トポロジをセットアップします。 ただし、これらすべてを私たちが行うのではなく、Ansible が代わりに行います。

言葉から行動へ

そこで、アプリケーションを XNUMX 台の仮想マシンにデプロイし、単純なトポロジをセットアップしましょう。

• レプリカセット app-1 役割を果たします apiこれには役割も含まれます vshard-router。 ここにはインスタンスが XNUMX つだけあります。
• レプリカセット storage-1 役割を実装します storage (そして同時に vshard-storage)、ここでは異なるマシンから XNUMX つのインスタンスを追加します。

例を実行するには、次のものが必要です 浮浪者 и 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

Tarantool カートリッジの Ansible ロールをインストールします。

$ ansible-galaxy install tarantool.cartridge,1.0.1

インストールされた役割を実行します。

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

プレイブックの実行が終了するのを待っています。 http://localhost:8181/admin/cluster/dashboard そしてその結果を楽しんでください:

データを流し込むことができます。 クールですよね？

ここで、これを操作し、同時に別のレプリカ セットをトポロジに追加する方法を考えてみましょう。

私たちは理解し始めます

どうしたの？

XNUMX つの VM を起動し、クラスターをセットアップする Ansible プレイブックを実行しました。 ファイルの中身を見てみましょう 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

ここでは何も興味深いことは起こりません。ansible-role と呼ばれるロールを開始します。 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 が管理するインフラストラクチャ ノード。 ホストごとに、接続パラメーター (次のように) を指定できます。 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 XNUMX つの仮想マシンの場合。 そしてセクションでは 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。 さらに XNUMX つのインスタンスを追加しましょう。 storage-2-replica 最初の仮想マシン上と storage-2 XNUMX 番目:

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 プレイブックを実行します。

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

オプションに注目 --limit。 各クラスター インスタンスは Ansible の用語ではホストであるため、プレイブックの実行時にどのインスタンスを構成する必要があるかを明示的に指定できます。

ウェブ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 haltVM の使用が完了したら、VM を停止します。

ボンネットの下には何があるのでしょうか？

ここでは、実験中に Ansible ロールの内部で何が起こったかについて詳しく説明します。

カートリッジ アプリケーションの展開を段階的に見てみましょう。

パッケージのインストールとインスタンスの起動

まず、パッケージをサーバーに配信してインストールする必要があります。 これで、このロールは RPM および DEB パッケージで動作できるようになりました。

次に、インスタンスを起動します。 ここではすべてが非常に単純です。各インスタンスは個別です。 systemd-サービス。 私は例について話しています。

$ systemctl start myapp@storage-1

このコマンドはインスタンスを起動します storage-1 アプリケーション myapp。 起動されたインスタンスはそのインスタンスを探します。 構成 в /etc/tarantool/conf.d/。 インスタンスのログは次を使用して表示できます。 journald.

ユニットファイル /etc/systemd/system/[email protected] systemd サービスはパッケージとともに提供されます。

Ansible にはパッケージのインストールと systemd サービスの管理のためのモジュールが組み込まれていますが、ここでは何も新しいものを発明していません。

クラスタートポロジーの構成

そしてここから最も興味深いことが始まります。 同意します。パッケージをインストールして実行するために特別な Ansible ロールをわざわざ使用するのは奇妙です。 systemd-サービス。

クラスターは手動でセットアップできます。

• 最初のオプション: Web UI を開いてボタンをクリックします。 複数のインスタンスを XNUMX 回だけ起動する場合には、これは非常に適しています。
• XNUMX 番目のオプション: GraphQl API を使用できます。 ここでは、たとえば Python でスクリプトを作成するなど、すでに何かを自動化できます。
• XNUMX 番目のオプション (精神的に強い人向け): サーバーに移動し、次を使用してインスタンスの XNUMX つに接続します。 tarantoolctl connect そして、Lua モジュールを使用して必要な操作をすべて実行します cartridge.

私たちの発明の主なタスクはこれを行うことであり、作業の中で最も難しい部分です。

Ansible を使用すると、独自のモジュールを作成し、それをロールで使用できます。 私たちの役割は、これらのモジュールを使用してクラスターのさまざまなコンポーネントを管理します。

使い方？ 宣言型構成でクラスターの望ましい状態を記述し、ロールによって各モジュールの構成セクションが入力として提供されます。 モジュールはクラスターの現在の状態を受け取り、それを入力と比較します。 次に、いずれかのインスタンスのソケットを通じてコードが実行され、クラスターが目的の状態になります。

結果

今日は、Tarantool カートリッジにアプリケーションをデプロイし、単純なトポロジをセットアップする方法を説明し、示しました。 これを行うために、Ansible を使用しました。Ansible は、使いやすく、多くのインフラストラクチャ ノード (この場合はクラスター インスタンス) を同時に構成できる強力なツールです。

上記では、Ansible を使用してクラスター構成を記述する多くの方法のうちの XNUMX つを取り上げました。 次に進む準備ができたとわかったら、学習してください ベストプラクティス プレイブックを書くため。 トポロジを管理するには、次の方法が便利です。 group_vars и host_vars.

トポロジからインスタンスを永久に削除 (追放) する方法、vshard をブートストラップする方法、自動フェイルオーバー モードを管理する方法、認可を構成する方法、およびクラスター構成にパッチを適用する方法を間もなく説明します。 その間は自分で勉強することもできます ドキュメンテーション クラスターパラメーターを変更して実験してください。

何かがうまくいかない場合は、必ず 知らせる その問題について私たちに。 早速分解していきます！

出所： habr.com