config

Documentation

Index

• type Asset
• type Config
  • func New() *Config
• type Debug
• type DriverCommon
• type DriverEOS
• type DriverOwnCloud
• type DriverS3
• type FrontendPort
• type Gateway
• type LDAP
• type LDAPSchema
• type Log
• type OCDav
• type OIDC
• type Port
• type PublicStorage
• type Reva
• type Sharing
• type StorageConfig
• type StoragePort
• type StorageRegistry
• type Tracing
• type UserRest
• type Users

Types

type Asset

type Asset struct {
	Path string
}

Asset defines the available asset configuration.

type Config

type Config struct {
	File    string
	Log     Log
	Debug   Debug
	Reva    Reva
	Tracing Tracing
	Asset   Asset
}

Config combines all available configuration parts.

func New

func New() *Config

New initializes a new configuration with or without defaults.

type Debug

type Debug struct {
	Addr   string
	Token  string
	Pprof  bool
	Zpages bool
}

Debug defines the available debug configuration.

type DriverCommon

type DriverCommon struct {
	// Root is the absolute path to the location of the data
	Root string
	//ShareFolder defines the name of the folder jailing all shares
	ShareFolder string
	// UserLayout contains the template used to construct
	// the internal path, eg: `{{substr 0 1 .Username}}/{{.Username}}`
	UserLayout string
	// EnableHome enables the creation of home directories.
	EnableHome bool
}

DriverCommon defines common driver configuration options.

type DriverEOS

type DriverEOS struct {
	DriverCommon

	// ShadowNamespace for storing shadow data
	ShadowNamespace string

	// UploadsNamespace for storing upload data
	UploadsNamespace string

	// Location of the eos binary.
	// Default is /usr/bin/eos.
	EosBinary string

	// Location of the xrdcopy binary.
	// Default is /usr/bin/xrdcopy.
	XrdcopyBinary string

	// URL of the Master EOS MGM.
	// Default is root://eos-example.org
	MasterURL string

	// URI of the EOS MGM grpc server
	// Default is empty
	GrpcURI string

	// URL of the Slave EOS MGM.
	// Default is root://eos-example.org
	SlaveURL string

	// Location on the local fs where to store reads.
	// Defaults to os.TempDir()
	CacheDirectory string

	// Enables logging of the commands executed
	// Defaults to false
	EnableLogging bool

	// ShowHiddenSysFiles shows internal EOS files like
	// .sys.v# and .sys.a# files.
	ShowHiddenSysFiles bool

	// ForceSingleUserMode will force connections to EOS to use SingleUsername
	ForceSingleUserMode bool

	// UseKeyTabAuth changes will authenticate requests by using an EOS keytab.
	UseKeytab bool

	// SecProtocol specifies the xrootd security protocol to use between the server and EOS.
	SecProtocol string

	// Keytab specifies the location of the keytab to use to authenticate to EOS.
	Keytab string

	// SingleUsername is the username to use when SingleUserMode is enabled
	SingleUsername string

	// gateway service to use for uid lookups
	GatewaySVC string
}

DriverEOS defines the available EOS driver configuration.

type DriverOwnCloud

type DriverOwnCloud struct {
	DriverCommon

	UploadInfoDir string
	Redis         string
	Scan          bool
}

DriverOwnCloud defines the available ownCloud storage driver configuration.

type DriverS3

type DriverS3 struct {
	DriverCommon

	Region    string
	AccessKey string
	SecretKey string
	Endpoint  string
	Bucket    string
}

DriverS3 defines the available S3 storage driver configuration.

type FrontendPort

type FrontendPort struct {
	Port

	DatagatewayPrefix string
	OCDavPrefix       string
	OCSPrefix         string
}

FrontendPort defines the available frontend configuration.

type Gateway

type Gateway struct {
	Port
	CommitShareToStorageGrant  bool
	CommitShareToStorageRef    bool
	ShareFolder                string
	LinkGrants                 string
	DisableHomeCreationOnLogin bool
}

Gateway defines the available gateway configuration.

type LDAP

type LDAP struct {
	Hostname        string
	Port            int
	BaseDN          string
	LoginFilter     string
	UserFilter      string
	AttributeFilter string
	FindFilter      string
	GroupFilter     string
	BindDN          string
	BindPassword    string
	IDP             string
	Schema          LDAPSchema
}

LDAP defines the available ldap configuration.

type LDAPSchema

type LDAPSchema struct {
	UID         string
	Mail        string
	DisplayName string
	CN          string
	UIDNumber   string
	GIDNumber   string
}

LDAPSchema defines the available ldap schema configuration.

type Log

type Log struct {
	Level  string
	Pretty bool
	Color  bool
}

Log defines the available logging configuration.

type OCDav

type OCDav struct {
	WebdavNamespace   string
	DavFilesNamespace string
}

OCDav defines the available ocdav configuration.

type OIDC

type OIDC struct {
	Issuer   string
	Insecure bool
	IDClaim  string
	UIDClaim string
	GIDClaim string
}

OIDC defines the available OpenID Connect configuration.

type Port

type Port struct {
	// MaxCPUs can be a number or a percentage
	MaxCPUs  string
	LogLevel string
	// Network can be tcp, udp or unix
	Network string
	// Addr to listen on, hostname:port (0.0.0.0:9999 for all interfaces) or socket (/var/run/reva/sock)
	Addr string
	// Protocol can be grpc or http
	Protocol string
	// URL is used by the gateway and registries (eg http://localhost:9100 or https://cloud.example.com)
	URL string
	// DebugAddr for the debug endpoint to bind to
	DebugAddr string
	// Services can be used to give a list of services that should be started on this port
	Services []string
	// Config can be used to configure the reva instance.
	// Services and Protocol will be ignored if this is used
	Config map[string]interface{}
}

Port defines the available port configuration.

type PublicStorage

type PublicStorage struct {
	StoragePort

	PublicShareProviderAddr string
	UserProviderAddr        string
}

PublicStorage configures a public storage provider

type Reva

type Reva struct {
	// JWTSecret used to sign jwt tokens between services
	JWTSecret       string
	TransferSecret  string
	TransferExpires int
	OIDC            OIDC
	LDAP            LDAP
	UserRest        UserRest
	OCDav           OCDav
	Storages        StorageConfig
	// Ports are used to configure which services to start on which port
	Frontend            FrontendPort
	DataGateway         Port
	Gateway             Gateway
	StorageRegistry     StorageRegistry
	Users               Users
	AuthProvider        Users
	AuthBasic           Port
	AuthBearer          Port
	Sharing             Sharing
	StorageRoot         StoragePort
	StorageRootData     StoragePort
	StorageHome         StoragePort
	StorageHomeData     StoragePort
	StorageEOS          StoragePort
	StorageEOSData      StoragePort
	StorageOC           StoragePort
	StorageOCData       StoragePort
	StorageS3           StoragePort
	StorageS3Data       StoragePort
	StorageWND          StoragePort
	StorageWNDData      StoragePort
	StorageCustom       StoragePort
	StorageCustomData   StoragePort
	StoragePublicLink   PublicStorage
	StorageMetadata     StoragePort
	StorageMetadataData StoragePort
	// Configs can be used to configure the reva instance.
	// Services and Ports will be ignored if this is used
	Configs map[string]interface{}
	// chunking and resumable upload config (TUS)
	UploadMaxChunkSize       int
	UploadHTTPMethodOverride string
	UploadDisableTus         bool
}

Reva defines the available reva configuration.

type Sharing

type Sharing struct {
	Port
	UserDriver   string
	UserJSONFile string
	PublicDriver string
}

Sharing defines the available sharing configuration.

type StorageConfig

type StorageConfig struct {
	Home     DriverCommon
	EOS      DriverEOS
	Local    DriverCommon
	OwnCloud DriverOwnCloud
	S3       DriverS3
	Common   DriverCommon
}

StorageConfig combines all available storage driver configuration parts.

type StoragePort

type StoragePort struct {
	Port
	Driver           string
	MountPath        string
	MountID          string
	ExposeDataServer bool
	DataServerURL    string

	// for HTTP ports with only one http service
	Prefix     string
	TempFolder string
}

StoragePort defines the available storage configuration.

type StorageRegistry

type StorageRegistry struct {
	Driver string
	// HomeProvider is the path in the global namespace that the static storage registry uses to determine the home storage
	HomeProvider string
	Rules        []string
}

StorageRegistry defines the available storage registry configuration

type Tracing

type Tracing struct {
	Enabled   bool
	Type      string
	Endpoint  string
	Collector string
	Service   string
}

Tracing defines the available tracing configuration.

type UserRest

type UserRest struct {
	ClientID                  string
	ClientSecret              string
	RedisAddress              string
	RedisUsername             string
	RedisPassword             string
	IDProvider                string
	APIBaseURL                string
	OIDCTokenEndpoint         string
	TargetAPI                 string
	UserGroupsCacheExpiration int
}

UserRest defines the user REST driver specification.

type Users

type Users struct {
	Port
	Driver string
	JSON   string
}

Users defines the available users configuration.