ecadlabs.tezos_node

役割名

このAnsibleの役割は、AnsibleユーザーにとってTezosノードの展開を迅速かつ簡単にすることを目指しています。

この役割は多くのパラメータを持ち、ユーザーが異なるTezosネットワーク（mainnet/ithacanet/jakartanetなど）や、ブロック遷移をサポートするためのさまざまな経済プロトコルのためにノードをデプロイできるようにしています。

ブートストラップ戦略として、ジェネシスから同期する方法と、迅速なブートストラッピングのためにスナップショットをインポートする方法の2つがサポートされています。

この役割はTezosノードのバージョン13に対してテストされています。

この役割はTezosのキーを管理しません

要件

Docker（Debian Busterでテスト済み）

インストール

ansible-galaxy install ecadlabs.tezos_node

役割の変数

利用可能な変数は以下にリストされています。デフォルト値も含まれています（defaults/main.ymlを参照）。

プロビジョニングしたいTezosネットワーク。この変数にはデフォルト値がないため、必ず設定する必要があります。通常、値はjakartanetまたはmainnetです。tezos_networkの値は、Dockerコンテナの名前付け、Dockerネットワークの名前付け、使用するTezosネットワークの選択、スナップショットのインポートが期待されるネットワークからのものであることを検証するために使用されます。

tezos_network:

ホスト上のTezosノードのデータディレクトリが存在する場所。この役割はDockerボリュームよりもDockerバインドマウントを使用します。

node_data_dir: "/srv/tezos/{{ network_name }}_node"

ホスト上のTezosクライアント設定が存在する場所。このディレクトリにはtezos-clientコマンドによって使用されるクライアント設定とキーが含まれます。

client_data_dir: "/srv/tezos/{{ network_name }}_client"

使用するTezosのDockerイメージ。

octez_version: v13.0

ノードを操作したい履歴モード。オプションはアーカイブ、フル、またはローリングです。

history_mode: full

スナップショットURLを指定することで、ノードのブートストラップ方法を制御できます。スナップショットをダウンロードしてインポートするにはsnapshot_urlを指定します。各履歴モードに異なるスナップショットがあるため、このスナップショットはノードと同じ履歴モードでなければなりません。提供された値がhttp://またはhttps://で始まる場合、役割はそのURLからスナップショットをダウンロードします。提供された値が/var/tmp/a_tezos_snapshotのようなUnixファイルパスの場合、役割はAnsibleホストマシンからターゲットにスナップショットをコピーします。

snapshot_url: https://mainnet.xtz-shots.io/rolling # https://xtz-shots.io/ を参照

ノードの初期インポートに使用されるスナップショットファイルのパスまたはURL。このスナップショットはターゲットホストのファイルシステムにダウンロードされ、インポートプロセスを担当する短命のDockerイメージにマウントされます。

    snapshot_tmp_file: /tmp/snapshot

依存関係

なし（ただし、dockerがインストールされていることを確認してください。geerlingguy.dockerがうまく動作します）

例のプレイブック

mainnet用：

- hosts: servers
  roles:
    - role: ecadlabs.tezos_node
      snapshot_url: https://mainnet.xtz-shots.io/rolling # https://xtz-shots.io/ を参照
      history_mode: rolling
      tezos_network: mainnet
      snapshot_tmp_file: /tmp/snapshot