ecadlabs.tezos_node

Nazwa Roli

Ta Rola Ansible ma na celu szybkie i łatwe wdrożenie węzła Tezos dla użytkowników Ansible.

Rola jest mocno parametryzowana, co umożliwia użytkownikom wdrażanie węzłów dla różnych sieci Tezos (mainnet/ithacanet/jakartanet itd.) oraz różnych protokołów ekonomicznych do wsparcia przejść blokowych.

Obsługiwane są dwie strategie bootstrapowania: synchronizacja od początku (genesis) lub importowanie zrzutu (snapshot) dla szybkiego bootstrapowania.

Rola była testowana z Wersją 13 Węzła Tezos.

Ta rola nie zarządza żadnymi kluczami Tezos

Wymagania

Docker (Testowane na Debianie Buster)

Instalacja

ansible-galaxy install ecadlabs.tezos_node

Zmienne Roli

Dostępne zmienne są wymienione poniżej z domyślnymi wartościami (patrz defaults/main.yml):

Sieć Tezos, którą chcesz skonfigurować. Ta zmienna nie ma wartości domyślnej, więc musisz ją ustawić. Typowe wartości to jakartanet lub mainnet. Wartość tezos_network jest używana w kilku celach: do nadawania nazw kontenerom dockera, nadawania nazw sieci dockera, wyboru, której sieci Tezos użyć oraz do weryfikacji, że import zrzutu jest z odpowiedniej sieci.

tezos_network:

Lokalizacja, gdzie na hoście będzie znajdować się katalog danych węzłów Tezos. Ta rola używa montowania bindów Docker zamiast wolumenów dockera.

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

Lokalizacja na hoście, gdzie będzie znajdować się konfiguracja klienta Tezos. Ten katalog zawiera konfigurację klienta i klucze używane przez polecenie tezos-client.

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

Obraz docker Tezos, który chcesz użyć.

octez_version: v13.0

Tryb historii, w którym chcesz uruchomić swój węzeł. Opcje to archiwalny, pełny lub rolujący.

history_mode: full

Podanie URL zrzutu kontroluje, jak twój węzeł będzie bootstrapowany. Określ snapshot_url, aby rola pobrała i zaimportowała zrzut. Ponieważ istnieją różne zrzuty dla każdego trybu historii, ten zrzut musi mieć ten sam tryb historii co węzeł. Jeśli podana wartość zaczyna się od http:// lub https://, rola pobierze zrzut z tego URL. Jeśli podana wartość to ścieżka do pliku Unix, na przykład /var/tmp/a_tezos_snapshot, rola skopiuje zrzut z maszyny hosta Ansible do celu.

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

Ścieżka lub URL do pliku zrzutu, który będzie użyty do początkowego importu twojego węzła. Zrzut zostanie pobrany do systemu plików hosta docelowego i zamontowany przez wolumen do krótkotrwałego obrazu dockera odpowiedzialnego za proces importu.

    snapshot_tmp_file: /tmp/snapshot

Zależności

Brak (ale upewnij się, że masz zainstalowany docker, geerlingguy.docker działa dobrze)

Przykładowy Playbook

Dla mainnet:

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