ecadlabs.tezos_node

概述版本洞察

角色名称

这个 Ansible 角色旨在为 Ansible 用户快速轻松地部署 Tezos 节点。

该角色参数化程度高，允许用户为不同的 Tezos 网络（主网/伊萨卡网/雅加达网等）和各种经济协议部署节点，以支持区块切换。

支持两种引导策略，分别是从创世块同步或导入快照以实现快速引导。

该角色已在 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 非常好用）

示例 Playbook

对于主网：

- 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