Ansible Role: Tessera

Description

This repo contains an Ansible playbook to deploy Tessera on a bare-metal server.

Table of Contents

• Prerequisites
• Role Variables
  • Recommended Required Role Variables
  • Full List of Role Variables
• Example Usage
• Licence
• Author Information

Prerequisites

1. Java JDK 11+
2. Build tools for building libsodium

Role Variables

Variables are defined in defaults/main.yml and can be directly overriden by editing the file, passing in command-line parameters, or vars in a playbook. The majority of the variables are options pertaining to the configuration file for Tessera, which can be found in its docs.

Recommended Required Role Variables

The below table lists the recommended role variables that should be used. Please see the second table if you would like to see the entire list of variables that can be modified.

Full List of Role Variables

Example Usage

1. Install role from Ansible Galaxy

ansible-galaxy install consensys.tessera

Create the requirements.yml with required variables

- hosts: localhost
  connection: local
  force_handlers: True

  roles:
    - role: consensys.tessera
      vars:
        besu_version: 21.10.2
        tessera_version: 21.10.0
        config_details: '["data":{"bytes":"Wl+...........tA="},"type":"unlocked"}]'
        public_key: BUL.....3Bo=

Note: The above config_details and public_key information is for demonstration purposes only in a dev environment. They should NOT be used in production. Please see Tessera docs on how to generate new keys and use Vault services.

Note: The above command should only be used for dev environments. Usually you would need to specify your own peers and server_config to meet your requirements.

2. Install role from Github

ansible-galaxy install git+https://github.com/consensys/ansible-role-tessera.git

Create requirements.yml for Github installed role

- hosts: localhost
  connection: local
  force_handlers: True

  roles:
    - role: ansible-role-tessera
      vars:
        besu_version: 21.10.2
        tessera_version: 21.10.0
        config_details: '["data":{"bytes":"Wl+...........tA="},"type":"unlocked"}]'
        public_key: BUL.....3Bo=

3. Run the result with the following: ansible-playbook -v requirements.yml -vvv

Licence

Apache

Author Information

ConsenSys, 2021