configuration

README

Insolar – Configuration

Package provides configuration params for all Insolar components and helper for config resources management.

Configuration

Configuration struct is a root registry for all components config. It provides constructor method NewConfiguration() which creates new instance of configuration object filled with default values.

Each root level Insolar component has a constructor with config as argument. Each components should have its own config struct with the same name in this package. Each config struct should have constructor which returns instance with default params.

Holder

Package also provides Holder to easily manage config resources. It based on Viper config solution for Golang and helps to Marshal\Unmarshal config structs, manage files, ENV and command line variables.

Holder provides functionality to merge configuration from different sources.

Merge priority

1. command line flags
2. ENV variables
3. yaml file
4. Default config

Manage configuration from cli

Insolar cli tool helps user to manage configuration.

insolar config --help

Documentation

Overview

Package configuration holds configuration for all components in Insolar host binary It allows also helps to manage config resources using Holder

Usage:

package main

import (
	"github.com/insolar/insolar/configuration"
	"fmt"
)

func main() {
	holder := configuration.NewHolder()
	fmt.Printf("Default configuration:\n %+v\n", holder.Configuration)
	holder.SaveAs("insolar.yml")
}

Index

• func ToString(in interface{}) string
• type BuiltIn
• type Configuration
  • func NewConfiguration() Configuration
• type GoPlugin
• type Holder
  • func NewHolder() Holder
  • func (c *Holder) Load() error
  • func (c *Holder) LoadEnv() error
  • func (c *Holder) LoadFromFile(path string) error
  • func (c *Holder) Save() error
  • func (c *Holder) SaveAs(path string) error
• type HostNetwork
  • func NewHostNetwork() HostNetwork
• type Ledger
  • func NewLedger() Ledger
• type Log
  • func NewLog() Log
• type LogicRunner
  • func NewLogicRunner() LogicRunner
• type Node
• type NodeNetwork
  • func NewNodeNetwork() NodeNetwork
• type Pulsar
  • func NewPulsar() Pulsar
• type Service
• type ServiceNetwork
  • func NewServiceNetwork() ServiceNetwork
• type Stats
  • func NewStats() Stats
• type Transport

Functions

func ToString

func ToString(in interface{}) string

ToString converts any configuration struct to yaml string

Types

type BuiltIn

type BuiltIn struct{}

type Configuration

type Configuration struct {
	Host        HostNetwork
	Node        NodeNetwork
	Service     ServiceNetwork
	Ledger      Ledger
	Log         Log
	Stats       Stats
	LogicRunner LogicRunner
	Pulsar      Pulsar
}

Configuration contains configuration params for all Insolar components

func NewConfiguration

func NewConfiguration() Configuration

NewConfiguration creates new default configuration

type GoPlugin

type GoPlugin struct {
	RunnerListen   string // ip:port of ginsider connectivity socket
	RunnerPath     string // path to gincider executable
	RunnerCodePath string // path where ginsider caches code
	MainListen     string // ip:port of main system connectivity socket
}

type Holder

type Holder struct {
	Configuration Configuration
	// contains filtered or unexported fields
}

Holder provides methods to manage configuration

func NewHolder

func NewHolder() Holder

NewHolder creates new Holder with default configuration

func (*Holder) Load

func (c *Holder) Load() error

Load method reads configuration from default file path

func (*Holder) LoadEnv

func (c *Holder) LoadEnv() error

LoadEnv overrides configuration with env variables

func (*Holder) LoadFromFile

func (c *Holder) LoadFromFile(path string) error

LoadFromFile method reads configuration from particular file path

func (*Holder) Save

func (c *Holder) Save() error

Save method writes configuration to default file path

func (*Holder) SaveAs

func (c *Holder) SaveAs(path string) error

SaveAs method writes configuration to particular file path

type HostNetwork

type HostNetwork struct {
	Transport      Transport
	BootstrapHosts []string
	IsRelay        bool // set if node must be relay explicit
}

HostNetwork holds configuration for HostNetwork

func NewHostNetwork

func NewHostNetwork() HostNetwork

NewHostNetwork creates new default HostNetwork configuration

type Ledger

type Ledger struct {
	// DataDirectory is a directory where database's files live.
	DataDirectory string
	// TxRetriesOnConflict defines how many retries on transaction conflicts
	// storage update methods should do.
	TxRetriesOnConflict int
}

Ledger holds configuration for ledger.

func NewLedger

func NewLedger() Ledger

NewLedger creates new default Ledger configuration.

type Log

type Log struct {
	Level   string
	Adapter string
}

Log holds configuration for logging

func NewLog

func NewLog() Log

NewLog creates new default configuration for logging

type LogicRunner

type LogicRunner struct {
	BuiltIn  *BuiltIn
	GoPlugin *GoPlugin
}

func NewLogicRunner

func NewLogicRunner() LogicRunner

type Node

type Node struct {
	NodeID      string
	HostID      string
	ReferenceID string
}

Node holds configuration for one Node

type NodeNetwork

type NodeNetwork struct {
	Nodes []*Node
}

NodeNetwork holds configuration for NodeNetwork

func NewNodeNetwork

func NewNodeNetwork() NodeNetwork

NewNodeNetwork creates new default NodeNetwork configuration

type Pulsar

type Pulsar struct {
	Type           string
	ListenAddress  string
	NodesAddresses []string
}

Stats holds configuration for pulsar node

func NewPulsar

func NewPulsar() Pulsar

NewPulsar creates new default configuration for pulsar node

type Service

type Service struct {
}

Service is configuration struct for servicenetwork.Service.

type ServiceNetwork

type ServiceNetwork struct {
	Service Service
}

ServiceNetwork is configuration for ServiceNetwork.

func NewServiceNetwork

func NewServiceNetwork() ServiceNetwork

NewServiceNetwork creates a new ServiceNetwork configuration.

type Stats

type Stats struct {
	ListenAddress string
}

Stats holds configuration for stats publishing

func NewStats

func NewStats() Stats

NewStats creates new default configuration for stats publishing

type Transport

type Transport struct {
	// protocol type UTP or KCP
	Protocol string
	// Address to listen
	Address string
	// if true transport will use network traversal technique(like STUN) to get PublicAddress
	BehindNAT bool
}

Transport holds transport protocol configuration for HostNetwork