Ansible Role: Tessera

Description

This repository includes an Ansible playbook to install Tessera on a physical server.

Table of Contents

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

Prerequisites

1. Java JDK version 11 or higher
2. Build tools to compile libsodium

Role Variables

Variables are defined in defaults/main.yml. You can modify these by editing the file, using command-line options, or adding variables in your playbook. Most variables control the settings for Tessera's configuration file, which you can find in the documentation.

Recommended Required Role Variables

The table below lists essential variables you should use. If you want to see all variables that can be adjusted, check the full list.

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 config_details and public_key shown above are for demonstration purposes in a development environment only. They should NOT be used in production. Refer to the Tessera documentation for information on generating new keys and using Vault services.

Note: The above command is suitable for development environments only. You will likely need to specify your own peers and server_config based on your needs.

2. Install role from GitHub

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

Create requirements.yml for the 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 setup with: ansible-playbook -v requirements.yml -vvv

License

Apache License

Author Information

ConsenSys, 2021