config

Documentation

Index

• func LogConfig(config *Config)
• func Validate(config *Config) error
• type ArtifactsServer
• type Auth
• type Cache
• type Config
  • func LoadConfig() (*Config, error)
• type Daemon
• type General
• type GitLab
• type Listeners
• type Log
• type MultiStringFlag
  • func (s *MultiStringFlag) Len() int
  • func (s *MultiStringFlag) Set(value string) error
  • func (s *MultiStringFlag) Split() (result []string)
  • func (s *MultiStringFlag) String() string
• type Sentry
• type TLS
• type ZipServing

Functions

func LogConfig

func LogConfig(config *Config)

func Validate

func Validate(config *Config) error

Validate values populated in Config

Types

type ArtifactsServer

type ArtifactsServer struct {
	URL            string
	TimeoutSeconds int
}

ArtifactsServer groups settings related to configuring Artifacts server

type Auth

type Auth struct {
	Secret       string
	ClientID     string
	ClientSecret string
	RedirectURI  string
	Scope        string
}

Auth groups settings related to configuring Authentication with GitLab

type Cache

type Cache struct {
	CacheExpiry          time.Duration
	CacheCleanupInterval time.Duration
	EntryRefreshTimeout  time.Duration
	RetrievalTimeout     time.Duration
	MaxRetrievalInterval time.Duration
	MaxRetrievalRetries  int
}

Cache configuration for GitLab API

type Config

type Config struct {
	General         General
	ArtifactsServer ArtifactsServer
	Authentication  Auth
	Daemon          Daemon
	GitLab          GitLab
	Listeners       Listeners
	Log             Log
	Sentry          Sentry
	TLS             TLS
	Zip             ZipServing

	// Fields used to share information between files. These are not directly
	// set by command line flags, but rather populated based on info from them.
	// ListenMetrics points to a file descriptor of a socket, whose address is
	// specified by `Config.General.MetricsAddress`.
	ListenMetrics uintptr

	// These fields contain the raw strings passed for listen-http,
	// listen-https, listen-proxy and listen-https-proxyv2 settings. It is used
	// by appmain() to create listeners, and the pointers to these listeners
	// gets assigned to Config.Listeners.* fields
	ListenHTTPStrings         MultiStringFlag
	ListenHTTPSStrings        MultiStringFlag
	ListenProxyStrings        MultiStringFlag
	ListenHTTPSProxyv2Strings MultiStringFlag
}

Config stores all the config options relevant to GitLab Pages.

func LoadConfig

func LoadConfig() (*Config, error)

LoadConfig parses configuration settings passed as command line arguments or via config file, and populates a Config object with those values

type Daemon

type Daemon struct {
	UID           uint
	GID           uint
	InplaceChroot bool
	EnableJail    bool
}

Daemon groups settings related to configuring GitLab Pages daemon

type General

type General struct {
	Domain                    string
	DomainConfigurationSource string
	MaxConns                  int
	MetricsAddress            string
	RedirectHTTP              bool
	RootCertificate           []byte
	RootDir                   string
	RootKey                   []byte
	StatusPath                string

	DisableCrossOriginRequests bool
	InsecureCiphers            bool
	PropagateCorrelationID     bool

	ShowVersion bool

	CustomHeaders []string
}

General groups settings that are general to GitLab Pages and can not be categorized under other head.

type GitLab

type GitLab struct {
	PublicServer       string
	InternalServer     string
	APISecretKey       []byte
	ClientHTTPTimeout  time.Duration
	JWTTokenExpiration time.Duration
	Cache              Cache
	EnableDisk         bool
}

GitLab groups settings related to configuring GitLab client used to interact with GitLab API

type Listeners

type Listeners struct {
	HTTP         []uintptr
	HTTPS        []uintptr
	Proxy        []uintptr
	HTTPSProxyv2 []uintptr
}

Listeners groups settings related to configuring various listeners (HTTP, HTTPS, Proxy, HTTPSProxyv2)

type Log

type Log struct {
	Format  string
	Verbose bool
}

Log groups settings related to configuring logging

type MultiStringFlag

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

MultiStringFlag implements the flag.Value interface and allows a string flag to be specified multiple times on the command line.

e.g.: -listen-http 127.0.0.1:80 -listen-http [::1]:80

func (*MultiStringFlag) Len

func (s *MultiStringFlag) Len() int

func (*MultiStringFlag) Set

func (s *MultiStringFlag) Set(value string) error

Set appends the value to the list of parameters

func (*MultiStringFlag) Split

func (s *MultiStringFlag) Split() (result []string)

Split each flag

func (*MultiStringFlag) String

func (s *MultiStringFlag) String() string

String returns the list of parameters joined with a commas (",")

type Sentry

type Sentry struct {
	DSN         string
	Environment string
}

Sentry groups settings related to configuring Sentry

type TLS

type TLS struct {
	MinVersion uint16
	MaxVersion uint16
}

TLS groups settings related to configuring TLS

type ZipServing

type ZipServing struct {
	ExpirationInterval time.Duration
	CleanupInterval    time.Duration
	RefreshInterval    time.Duration
	OpenTimeout        time.Duration
	AllowedPaths       []string
	// TODO: this is a temporary workaround for https://gitlab.com/gitlab-org/gitlab/-/issues/326117#note_546346101
	// where daemon-inplace-chroot=true fails to serve zip archives when pages_serve_with_zip_file_protocol is enabled
	// To be removed along with chroot support https://gitlab.com/gitlab-org/gitlab-pages/-/issues/561
	ChrootPath string
}

ZipServing groups settings to be used by the zip VFS opening and caching