server

README

Meta Information

This is a brief overview on how the meta information works for CFS. Note that the behavior and data stored may change over time, but backward compatibility will be preserved if at all possible once the 1.0.0 version is released.

Whether an account exists and is active is outside the scope of CFS. This is currently handled by an external auth system, either OpenStack Keystone or a Keystone-compatible auth system.

CFS tracks the filesystems per account, some meta information about each filesystem, and the addresses granted access to each filesystem.

AID = account identifier
FSID = filesystem identifier

The following lists the group-store heirarchy where this meta information is stored:

/account/<aid>/<fsid>

These are of the type formicproto.MetaAccount2Filesystem, each containing just an FSID. Use /filesystem/<fsid> to lookup additional filesystem information.

/filesystem/<fsid>

These are of the type formicproto.MetaFilesystemEntry, each containing the AID, FSID, and filesystem name.

/filesystem/<fsid>/address/<address>

These are of the type formicproto.MetaFilesystem2Address, each containing an IP address that is allowed access.

Documentation

Overview

Package server provides a server implementation of a single node of a formic cluster.

Index

• type Formic
  • func NewFormic(cfg *FormicConfig) (*Formic, error)
  • func (f *Formic) Shutdown(ctx context.Context) error
  • func (f *Formic) Startup(ctx context.Context) error
• type FormicConfig

Types

type Formic

type Formic struct {
	// contains filtered or unexported fields
}

func NewFormic

func NewFormic(cfg *FormicConfig) (*Formic, error)

func (*Formic) Shutdown

func (f *Formic) Shutdown(ctx context.Context) error

func (*Formic) Startup

func (f *Formic) Startup(ctx context.Context) error

type FormicConfig

type FormicConfig struct {
	NodeID                int
	GRPCAddressIndex      int
	GroupGRPCAddressIndex int
	ValueGRPCAddressIndex int
	GRPCCertFile          string
	GRPCKeyFile           string
	CAFile                string
	Scale                 float64
	Ring                  ring.Ring
	RingPath              string
	AuthURL               string
	AuthUser              string
	AuthPassword          string
	SkipAuth              bool
	Logger                *zap.Logger
}