Ansible role for Nim-Codex node configuration https://github.com/status-im/nim-codex
Go to file
Eric Mastro cca801adcd
update build command `make exec` to `make`
2023-03-14 14:22:26 +11:00
defaults add --nat flag to specify public IP address 2022-11-08 13:18:01 +01:00
handlers First commit 2022-04-04 14:50:03 +02:00
meta First commit 2022-04-04 14:50:03 +02:00
tasks repointing `info` to `/debug/info` 2022-11-15 22:40:15 -06:00
templates update build command `make exec` to `make` 2023-03-14 14:22:26 +11:00
README.md update remaining dagger references to codex 2022-09-20 23:40:51 +02:00

README.md

Description

This role provisions a nim Codex installation.

Introduction

The role will:

Ports

The service exposes two ports by default:

  • 9000 - LibP2P peering port. Must ALWAYS be public.
  • 5052 - REST API port. Must NEVER be public.

Installation

Add to your requirements.yml file:

- name: infra-role-nim-codex
  src: git+git@github.com:status-im/infra-role-nim-codex
  scm: git

Configuration

The crucial settings are:

# branch which should be built
nim_codex_repo_branch: 'stable'
# optional setting for debug mode
nim_codex_log_level: 'DEBUG'

Management

Service

Assuming the main branch was built you can manage the service with:

sudo systemctl start codex-main
sudo systemctl status codex-main
sudo systemctl stop codex-main

You can view logs under:

tail -f /data/codex-main/logs/service.log

All node data is located in /data/codex-main/data.

Builds

A timer will be installed to build the image:

 > sudo systemctl list-units --type=service '*codex-*'
  UNIT                                LOAD   ACTIVE SUB     DESCRIPTION
  codex-prater-stable.service   loaded active running Codex (stable)

To rebuild the image:

 > sudo systemctl start build-codex-main

To check full build logs use:

journalctl -u build-codex-main.service

Requirements

Due to being part of Status infra this role assumes availability of certain things:

  • The iptables-persistent module