ecadlabs.tezos_node

Rollenname

Diese Ansible-Rolle zielt darauf ab, die Bereitstellung eines Tezos-Knotens für Ansible-Benutzer schnell und einfach zu gestalten.

Die Rolle ist stark parametrisiert, sodass Benutzer Knoten für verschiedene Tezos-Netzwerke (Mainnet/Ithacanet/Jakartanet usw.) und verschiedene wirtschaftliche Protokolle zur Unterstützung von Blockübergängen bereitstellen können.

Es werden zwei Bootstrap-Strategien unterstützt, nämlich das Synchronisieren von Genesis oder das Importieren eines Snapshots für ein schnelles Bootstrapping.

Die Rolle wurde gegen Version 13 des Tezos-Knotens getestet.

Diese Rolle verwaltet keine Tezos-Schlüssel

Anforderungen

Docker (Getestet auf Debian Buster)

Installation

ansible-galaxy install ecadlabs.tezos_node

Rollenvariablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit Standardwerten (siehe defaults/main.yml):

Das Tezos-Netzwerk, das Sie bereitstellen möchten. Diese Variable hat keinen Standardwert, daher müssen Sie sie festlegen. Typischerweise sind die Werte jakartanet oder mainnet. Der Wert von tezos_network wird für mehrere Zwecke verwendet: Benennung von Docker-Containern, Benennung eines Docker-Netzwerks, Auswahl des Tezos-Netzwerks und Validierung, dass Snapshot-Importe vom erwarteten Netzwerk stammen.

tezos_network:

Der Standort, an dem das Datenverzeichnis der Tezos-Knoten auf dem Host liegen wird. Diese Rolle verwendet Docker-Bind-Mounts anstelle von Docker-Volumes.

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

Der Ort auf dem Host, an dem die Konfiguration des Tezos-Clients liegen wird. Dieses Verzeichnis enthält die Client-Konfiguration und die von dem tezos-client-Befehl verwendeten Schlüssel.

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

Das tezos Docker-Image, das verwendet werden soll.

octez_version: v13.0

Der Historienmodus, in dem Sie Ihren Knoten betreiben möchten. Optionen sind Archiv, voll oder rollierend.

history_mode: full

Durch die Angabe einer Snapshot-URL wird gesteuert, wie Ihr Knoten bootstrappen wird. Geben Sie eine snapshot_url an, damit die Rolle einen Snapshot herunterlädt und importiert. Da es für jeden Historienmodus unterschiedliche Snapshots gibt, muss dieser Snapshot denselben Historienmodus wie der Knoten haben. Wenn der angegebene Wert mit http:// oder https:// beginnt, wird die Rolle einen Snapshot von dieser URL herunterladen. Wenn der angegebene Wert ein Unix-Dateipfad wie /var/tmp/a_tezos_snapshot ist, wird die Rolle den Snapshot vom Ansible-Host auf das Ziel kopieren.

snapshot_url: https://mainnet.xtz-shots.io/rolling # Siehe https://xtz-shots.io/

Der Pfad oder die URL zur Snapshot-Datei, die für den ersten Import Ihres Knotens verwendet wird. Der Snapshot wird in das Dateisystem des Zielhosts heruntergeladen und über ein Volume in ein kurzlebiges Docker-Image, das für den Importprozess verantwortlich ist, eingebunden.

    snapshot_tmp_file: /tmp/snapshot

Abhängigkeiten

Keine (aber stellen Sie sicher, dass Docker installiert ist, geerlingguy.docker funktioniert gut)

Beispiel-Playbook

Für das Mainnet:

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