consensys.lodestar

Ansible Role: lodestar

Description

This Ansible role installs, configures, and runs Lodestar.

Table of Contents

Supported Platforms

* MacOS
* Debian
* Ubuntu
* Redhat (CentOS/Fedora)
* Amazon

Dependencies

  • Docker

Role Variables:

You can override all variables stored in the defaults/main.yml file. Most of these are configuration options. For more details, check the Lodestar documents.

Name Default Value Description
lodestar_version unset REQUIRED The version of Lodestar to install and run.
lodestar_user lodestar The user for Lodestar.
lodestar_group lodestar The group for Lodestar.
lodestar_base_dir /opt/lodestar The base path for installation.
lodestar_config_dir /etc/lodestar The directory for the default configuration.
lodestar_data_dir /opt/lodestar/data The directory for data storage.
lodestar_log_dir /var/log/lodestar The directory for logs.
lodestar_log_level "info" The level of logging.
lodestar_network mainnet Predefined network settings.
lodestar_jwt_auth_file "/etc/jwt-secret.hex" The path to the JWT file.
lodestar_validator_enabled "False" Indicates if validator mode is enabled (you need to manage secrets and keys).
lodestar_execution_urls "http://127.0.0.1:8551" The execution URL for the ELC (Ethereum Layer Consensus).
lodestar_validator_beaconnodes "http://lodestar-beacon:9596" The beacon endpoint for the validator.
lodestar_checkpoint_sync_url "https://beaconstate-{{lodestar_network}}.chainsafe.io" URL for checkpoint synchronization to speed up processes.
lodestar_default_fee_recipient "" The address for the default fee recipient.
lodestar_keystores_dir "/config/keys" The directory for validator keys.
lodestar_secrets_dir "/config/secrets" The directory for validator secrets.
lodestar_enable_doppelganger_protection True By default, doppelganger protection is enabled.
lodestar_validator_force False Allows opening validators even if a lock file exists (use with caution).

Keys/Secrets

Make sure to place your own keys and secrets in the configuration directory specified by lodestar_config_dir.

Example Playbook

  1. Default setup: Install the role from Galaxy:

    ansible-galaxy install consensys.lodestar
    

    Create a requirements.yml file as follows: Replace x.y.z with the version you want to use:

    ---
    - hosts: localhost
      connection: local
      force_handlers: True
    
      roles:
      - role: consensys.lodestar
        vars:
          lodestar_version: x.y.z
    

    Run the playbook with:

    ansible-playbook -v /path/to/requirements.yml
    
  2. Install via GitHub:

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

    Create a requirements.yml file as follows: Replace x.y.z with the version you want to use:

    ---
    - hosts: localhost
      connection: local
      force_handlers: True
    
      roles:
      - role: ansible-role-lodestar
        vars:
          lodestar_version: x.y.z
    

    Run the playbook with:

    ansible-playbook -v /path/to/requirements.yml
    

License

Apache

Author Information

Consensys, 2023

Informazioni sul progetto

lodestar is an open-source ethereum 2 client

Installa
ansible-galaxy install consensys.lodestar
Licenza
Unknown
Download
1.4k
Proprietario
Consensys is the software engineering leader of the blockchain space. Our full-stack Ethereum products help developers build next-generation networks.