Ansible Role: zend (Horizen)

This role installs and runs Horizen's zend in a container on Ubuntu servers.

Requirements

• Docker must be installed.
• The Zend P2P port should be open (see zend_port_p2p below).

Role Variables

Here are the variables you can use, along with their default values (see defaults/main.yml):

zend_ver: latest

The version of zend to install. Check the zen-node tags on Docker Hub for valid version names.

zend_user_name: zenops
zend_group_name: zenops

The name of the user and group that will own the zend_dir and run zend. If they don't exist, they will be created as a system user and group.

zend_port_p2p: "9033"
zend_port_rpc: "8231"

Ports that zend uses for P2P and RPC. The P2P port is accessible from the internet. The RPC port is not accessible from the internet.

zend_dir: /mnt/horizen

The absolute path to the directory that will be used in the container. This corresponds to ~/.zen in normal operation.

zend_svc_name: zend
zend_svc_enabled: yes

Settings for the systemd service for zend.

zend_docker_host: unix:///var/run/docker.sock
zend_docker_ctr_name: zend
zend_docker_ctr_stop_timeout: 600
zend_docker_net_name: ZenNet
zend_docker_net_subnet: 172.42.0.0/24
zend_docker_net_gateway: 172.42.0.254
zend_docker_ipv4: 172.42.0.1

Variables to set up Docker.

zend_zcash_srcvol: zcash-params

The source Docker volume to store zcash parameters from zen-fetch-params.

zend_ipv4: ''
zend_ipv6: ''

External IP addresses for zend.

zend_tls_cert_path: ''
zend_tls_key_path: ''
zend_tls_cert_dir: /etc/letsencrypt/live/{{ inventory_hostname }}

Paths for optional server certificate and private key files. If zend_tls_cert_path or zend_tls_key_path is empty or doesn't exist, it checks zend_tls_cert_dir for cert.pem and privkey.pem. This role does not create or renew the server certificate. It changes the group of the certificate files' parent directory to zend_group_name.

Dependencies

• None

Example Playbook

- hosts: zend
  roles:
    - role: aschult5.zend
      become: yes

See Also

• aschult5.zen_nodetracker
• aschult5.horizen

License

MIT

Author Information

This role was created in 2019 by Andrew Schultz for use with Nodeler.