Documentation ¶
Index ¶
- Constants
- func CanonicalDomain(domain string) string
- func MatchDomain(domain string, certDomain string) bool
- type AccessLog
- type AccessLogFields
- type AccessLogFilters
- type Auth
- type Backend
- type Basic
- type Buckets
- type Buffering
- type CircuitBreaker
- type ClientTLS
- type Cluster
- type ConfigMessage
- type Configuration
- type Configurations
- type Constraint
- type Constraints
- type DNSResolvers
- type Datadog
- type Digest
- type Domain
- type Domains
- type ErrorPage
- type FieldHeaderNames
- type FieldHeaders
- type FieldNames
- type Forward
- type Frontend
- type HTTPCodeRanges
- type Headers
- type HealthCheck
- type InfluxDB
- type InternalRouter
- type LoadBalancer
- type LoadBalancerMethod
- type MaxConn
- type Metrics
- type Prometheus
- type Rate
- type RateLimit
- type Redirect
- type ResponseForwarding
- type Route
- type Server
- type ServerRoute
- type Statistics
- type Statsd
- type StatusCodes
- type Stickiness
- type Store
- type TLSCLientCertificateDNInfos
- type TLSClientCertificateInfos
- type TLSClientHeaders
- type TraefikLog
- type Users
- type WhiteList
Constants ¶
const ( // AccessLogKeep is the keep string value AccessLogKeep = "keep" // AccessLogDrop is the drop string value AccessLogDrop = "drop" // AccessLogRedact is the redact string value AccessLogRedact = "redact" )
Variables ¶
This section is empty.
Functions ¶
func CanonicalDomain ¶ added in v1.1.0
CanonicalDomain returns a lower case domain with trim space
func MatchDomain ¶ added in v1.6.0
MatchDomain return true if a domain match the cert domain
Types ¶
type AccessLog ¶ added in v1.4.0
type AccessLog struct { FilePath string `json:"file,omitempty" description:"Access log file path. Stdout is used when omitted or empty" export:"true"` Format string `json:"format,omitempty" description:"Access log format: json | common" export:"true"` Filters *AccessLogFilters `json:"filters,omitempty" description:"Access log filters, used to keep only specific access logs" export:"true"` Fields *AccessLogFields `json:"fields,omitempty" description:"AccessLogFields" export:"true"` BufferingSize int64 `` /* 126-byte string literal not displayed */ }
AccessLog holds the configuration settings for the access logger (middlewares/accesslog).
type AccessLogFields ¶ added in v1.6.0
type AccessLogFields struct { DefaultMode string `json:"defaultMode,omitempty" description:"Default mode for fields: keep | drop" export:"true"` Names FieldNames `json:"names,omitempty" description:"Override mode for fields" export:"true"` Headers *FieldHeaders `json:"headers,omitempty" description:"Headers to keep, drop or redact" export:"true"` }
AccessLogFields holds configuration for access log fields
func (*AccessLogFields) Keep ¶ added in v1.6.0
func (f *AccessLogFields) Keep(field string) bool
Keep check if the field need to be kept or dropped
func (*AccessLogFields) KeepHeader ¶ added in v1.6.0
func (f *AccessLogFields) KeepHeader(header string) string
KeepHeader checks if the headers need to be kept, dropped or redacted and returns the status
type AccessLogFilters ¶ added in v1.6.0
type AccessLogFilters struct { StatusCodes StatusCodes `json:"statusCodes,omitempty" description:"Keep access logs with status codes in the specified range" export:"true"` RetryAttempts bool `json:"retryAttempts,omitempty" description:"Keep access logs when at least one retry happened" export:"true"` MinDuration parse.Duration `json:"duration,omitempty" description:"Keep access logs when request took longer than the specified duration" export:"true"` }
AccessLogFilters holds filters configuration
type Auth ¶ added in v1.1.0
type Auth struct { Basic *Basic `json:"basic,omitempty" export:"true"` Digest *Digest `json:"digest,omitempty" export:"true"` Forward *Forward `json:"forward,omitempty" export:"true"` HeaderField string `json:"headerField,omitempty" export:"true"` }
Auth holds authentication configuration (BASIC, DIGEST, users)
type Backend ¶
type Backend struct { Servers map[string]Server `json:"servers,omitempty"` CircuitBreaker *CircuitBreaker `json:"circuitBreaker,omitempty"` LoadBalancer *LoadBalancer `json:"loadBalancer,omitempty"` MaxConn *MaxConn `json:"maxConn,omitempty"` HealthCheck *HealthCheck `json:"healthCheck,omitempty"` Buffering *Buffering `json:"buffering,omitempty"` ResponseForwarding *ResponseForwarding `json:"forwardingResponse,omitempty"` }
Backend holds backend configuration.
type Basic ¶ added in v1.1.0
type Basic struct { Users `json:"-" mapstructure:"," dynamodbav:"users,omitempty"` UsersFile string `json:"usersFile,omitempty"` RemoveHeader bool `json:"removeHeader,omitempty"` }
Basic HTTP basic authentication
type Buckets ¶ added in v1.2.0
type Buckets []float64
Buckets holds Prometheus Buckets
func (*Buckets) Set ¶ added in v1.2.0
Set adds strings elem into the the parser it splits str on "," and ";" and apply ParseFloat to string
type Buffering ¶ added in v1.6.0
type Buffering struct { MaxRequestBodyBytes int64 `json:"maxRequestBodyBytes,omitempty"` MemRequestBodyBytes int64 `json:"memRequestBodyBytes,omitempty"` MaxResponseBodyBytes int64 `json:"maxResponseBodyBytes,omitempty"` MemResponseBodyBytes int64 `json:"memResponseBodyBytes,omitempty"` RetryExpression string `json:"retryExpression,omitempty"` }
Buffering holds request/response buffering configuration/
type CircuitBreaker ¶
type CircuitBreaker struct {
Expression string `json:"expression,omitempty"`
}
CircuitBreaker holds circuit breaker configuration.
type ClientTLS ¶ added in v1.4.0
type ClientTLS struct { CA string `description:"TLS CA" json:"ca,omitempty"` CAOptional bool `description:"TLS CA.Optional" json:"caOptional,omitempty"` Cert string `description:"TLS cert" json:"cert,omitempty"` Key string `description:"TLS key" json:"-" dynamodbav:"key,omitempty"` InsecureSkipVerify bool `description:"TLS insecure skip verify" json:"insecureSkipVerify,omitempty"` }
ClientTLS holds TLS specific configurations as client CA, Cert and Key can be either path or file contents
type Cluster ¶ added in v1.1.0
type Cluster struct { Node string `description:"Node name" export:"true"` Store *Store `export:"true"` }
Cluster holds cluster config
type ConfigMessage ¶
type ConfigMessage struct { ProviderName string Configuration *Configuration }
ConfigMessage hold configuration information exchanged between parts of traefik.
type Configuration ¶
type Configuration struct { Backends map[string]*Backend `json:"backends,omitempty"` Frontends map[string]*Frontend `json:"frontends,omitempty"` TLS []*traefiktls.Configuration `json:"-"` }
Configuration of a provider.
type Configurations ¶ added in v1.4.0
type Configurations map[string]*Configuration
Configurations is for currentConfigurations Map
type Constraint ¶
type Constraint struct { Key string `export:"true"` // MustMatch is true if operator is "==" or false if operator is "!=" MustMatch bool `export:"true"` // TODO: support regex Regex string `export:"true"` }
Constraint hold a parsed constraint expression
func NewConstraint ¶
func NewConstraint(exp string) (*Constraint, error)
NewConstraint receive a string and return a *Constraint, after checking syntax and parsing the constraint expression
func (*Constraint) MarshalText ¶ added in v1.1.0
func (c *Constraint) MarshalText() (text []byte, err error)
MarshalText encodes the receiver into UTF-8-encoded text and returns the result.
func (*Constraint) MatchConstraintWithAtLeastOneTag ¶
func (c *Constraint) MatchConstraintWithAtLeastOneTag(tags []string) bool
MatchConstraintWithAtLeastOneTag tests a constraint for one single service
func (*Constraint) String ¶
func (c *Constraint) String() string
func (*Constraint) UnmarshalText ¶ added in v1.1.0
func (c *Constraint) UnmarshalText(text []byte) error
UnmarshalText define how unmarshal in TOML parsing
type Constraints ¶
type Constraints []*Constraint
Constraints holds a Constraint parser
func (*Constraints) SetValue ¶
func (cs *Constraints) SetValue(val interface{})
SetValue sets []*Constraint into the parser
func (*Constraints) String ¶
func (cs *Constraints) String() string
String returns []*Constraint in string
func (*Constraints) Type ¶
func (cs *Constraints) Type() string
Type exports the Constraints type as a string
type DNSResolvers ¶ added in v1.7.4
type DNSResolvers []string
DNSResolvers is a list of DNSes that we will try to resolve the challenged FQDN against
func (*DNSResolvers) Get ¶ added in v1.7.4
func (r *DNSResolvers) Get() interface{}
Get return the DNSResolvers list
func (*DNSResolvers) Set ¶ added in v1.7.4
func (r *DNSResolvers) Set(value string) error
Set is the method to set the flag value, part of the flag.Value interface. Set's argument is a string to be parsed to set the flag. It's a comma-separated list, so we split it.
func (*DNSResolvers) SetValue ¶ added in v1.7.4
func (r *DNSResolvers) SetValue(val interface{})
SetValue sets the DNSResolvers list
func (*DNSResolvers) String ¶ added in v1.7.4
func (r *DNSResolvers) String() string
String is the method to format the flag's value, part of the flag.Value interface. The String method's output will be used in diagnostics.
func (*DNSResolvers) Type ¶ added in v1.7.4
func (r *DNSResolvers) Type() string
Type is type of the struct
type Datadog ¶ added in v1.4.0
type Datadog struct { Address string `description:"DataDog's address"` PushInterval string `description:"DataDog push interval" export:"true"` }
Datadog contains address and metrics pushing interval configuration
type Digest ¶ added in v1.1.0
type Digest struct { Users `json:"-" mapstructure:"," dynamodbav:"users,omitempty"` UsersFile string `json:"usersFile,omitempty"` RemoveHeader bool `json:"removeHeader,omitempty"` }
Digest HTTP authentication
type Domain ¶ added in v1.6.0
Domain holds a domain name with SANs
func (*Domain) ToStrArray ¶ added in v1.6.0
ToStrArray convert a domain into an array of strings
type Domains ¶ added in v1.6.0
type Domains []Domain
Domains parse []Domain
type ErrorPage ¶ added in v1.4.0
type ErrorPage struct { Status []string `json:"status,omitempty"` Backend string `json:"backend,omitempty"` Query string `json:"query,omitempty"` }
ErrorPage holds custom error page configuration
type FieldHeaderNames ¶ added in v1.6.0
FieldHeaderNames holds maps of fields with specific mode
func (*FieldHeaderNames) Get ¶ added in v1.6.0
func (f *FieldHeaderNames) Get() interface{}
Get return the FieldHeaderNames map
func (*FieldHeaderNames) Set ¶ added in v1.6.0
func (f *FieldHeaderNames) Set(value string) error
Set is the method to set the flag value, part of the flag.Value interface. Set's argument is a string to be parsed to set the flag. It's a space-separated list, so we split it.
func (*FieldHeaderNames) SetValue ¶ added in v1.6.0
func (f *FieldHeaderNames) SetValue(val interface{})
SetValue sets the FieldHeaderNames map with val
func (*FieldHeaderNames) String ¶ added in v1.6.0
func (f *FieldHeaderNames) String() string
String is the method to format the flag's value, part of the flag.Value interface. The String method's output will be used in diagnostics.
type FieldHeaders ¶ added in v1.6.0
type FieldHeaders struct { DefaultMode string `json:"defaultMode,omitempty" description:"Default mode for fields: keep | drop | redact" export:"true"` Names FieldHeaderNames `json:"names,omitempty" description:"Override mode for headers" export:"true"` }
FieldHeaders holds configuration for access log headers
type FieldNames ¶ added in v1.6.0
FieldNames holds maps of fields with specific mode
func (*FieldNames) Get ¶ added in v1.6.0
func (f *FieldNames) Get() interface{}
Get return the FieldNames map
func (*FieldNames) Set ¶ added in v1.6.0
func (f *FieldNames) Set(value string) error
Set is the method to set the flag value, part of the flag.Value interface. Set's argument is a string to be parsed to set the flag. It's a space-separated list, so we split it.
func (*FieldNames) SetValue ¶ added in v1.6.0
func (f *FieldNames) SetValue(val interface{})
SetValue sets the FieldNames map with val
func (*FieldNames) String ¶ added in v1.6.0
func (f *FieldNames) String() string
String is the method to format the flag's value, part of the flag.Value interface. The String method's output will be used in diagnostics.
type Forward ¶ added in v1.4.0
type Forward struct { Address string `description:"Authentication server address" json:"address,omitempty"` TLS *ClientTLS `description:"Enable TLS support" json:"tls,omitempty" export:"true"` TrustForwardHeader bool `description:"Trust X-Forwarded-* headers" json:"trustForwardHeader,omitempty" export:"true"` AuthResponseHeaders []string `description:"Headers to be forwarded from auth response" json:"authResponseHeaders,omitempty"` }
Forward authentication
type Frontend ¶
type Frontend struct { EntryPoints []string `json:"entryPoints,omitempty" hash:"ignore"` Backend string `json:"backend,omitempty"` Routes map[string]Route `json:"routes,omitempty" hash:"ignore"` PassHostHeader bool `json:"passHostHeader,omitempty"` PassTLSCert bool `json:"passTLSCert,omitempty"` // Deprecated use PassTLSClientCert instead PassTLSClientCert *TLSClientHeaders `json:"passTLSClientCert,omitempty"` Priority int `json:"priority"` BasicAuth []string `json:"basicAuth"` // Deprecated WhitelistSourceRange []string `json:"whitelistSourceRange,omitempty"` // Deprecated WhiteList *WhiteList `json:"whiteList,omitempty"` Headers *Headers `json:"headers,omitempty"` Errors map[string]*ErrorPage `json:"errors,omitempty"` RateLimit *RateLimit `json:"ratelimit,omitempty"` Redirect *Redirect `json:"redirect,omitempty"` Auth *Auth `json:"auth,omitempty"` }
Frontend holds frontend configuration.
type HTTPCodeRanges ¶ added in v1.6.0
type HTTPCodeRanges [][2]int
HTTPCodeRanges holds HTTP code ranges
func NewHTTPCodeRanges ¶ added in v1.6.0
func NewHTTPCodeRanges(strBlocks []string) (HTTPCodeRanges, error)
NewHTTPCodeRanges creates HTTPCodeRanges from a given []string. Break out the http status code ranges into a low int and high int for ease of use at runtime
func (HTTPCodeRanges) Contains ¶ added in v1.6.0
func (h HTTPCodeRanges) Contains(statusCode int) bool
Contains tests whether the passed status code is within one of its HTTP code ranges.
type Headers ¶ added in v1.4.0
type Headers struct { CustomRequestHeaders map[string]string `json:"customRequestHeaders,omitempty"` CustomResponseHeaders map[string]string `json:"customResponseHeaders,omitempty"` AllowedHosts []string `json:"allowedHosts,omitempty"` HostsProxyHeaders []string `json:"hostsProxyHeaders,omitempty"` SSLRedirect bool `json:"sslRedirect,omitempty"` SSLTemporaryRedirect bool `json:"sslTemporaryRedirect,omitempty"` SSLHost string `json:"sslHost,omitempty"` SSLProxyHeaders map[string]string `json:"sslProxyHeaders,omitempty"` SSLForceHost bool `json:"sslForceHost,omitempty"` STSSeconds int64 `json:"stsSeconds,omitempty"` STSIncludeSubdomains bool `json:"stsIncludeSubdomains,omitempty"` STSPreload bool `json:"stsPreload,omitempty"` ForceSTSHeader bool `json:"forceSTSHeader,omitempty"` FrameDeny bool `json:"frameDeny,omitempty"` CustomFrameOptionsValue string `json:"customFrameOptionsValue,omitempty"` ContentTypeNosniff bool `json:"contentTypeNosniff,omitempty"` BrowserXSSFilter bool `json:"browserXssFilter,omitempty"` CustomBrowserXSSValue string `json:"customBrowserXSSValue,omitempty"` ContentSecurityPolicy string `json:"contentSecurityPolicy,omitempty"` PublicKey string `json:"publicKey,omitempty"` ReferrerPolicy string `json:"referrerPolicy,omitempty"` IsDevelopment bool `json:"isDevelopment,omitempty"` }
Headers holds the custom header configuration
func (*Headers) HasCustomHeadersDefined ¶ added in v1.4.0
HasCustomHeadersDefined checks to see if any of the custom header elements have been set
func (*Headers) HasSecureHeadersDefined ¶ added in v1.4.0
HasSecureHeadersDefined checks to see if any of the secure header elements have been set
type HealthCheck ¶ added in v1.2.0
type HealthCheck struct { Scheme string `json:"scheme,omitempty"` Path string `json:"path,omitempty"` Port int `json:"port,omitempty"` Interval string `json:"interval,omitempty"` Hostname string `json:"hostname,omitempty"` Headers map[string]string `json:"headers,omitempty"` }
HealthCheck holds HealthCheck configuration
type InfluxDB ¶ added in v1.5.0
type InfluxDB struct { Address string `description:"InfluxDB address"` Protocol string `description:"InfluxDB address protocol (udp or http)"` PushInterval string `description:"InfluxDB push interval" export:"true"` Database string `description:"InfluxDB database used when protocol is http" export:"true"` RetentionPolicy string `description:"InfluxDB retention policy used when protocol is http" export:"true"` }
InfluxDB contains address and metrics pushing interval configuration
type InternalRouter ¶ added in v1.7.0
InternalRouter router used by server to register internal routes (/api, /ping ...)
type LoadBalancer ¶
type LoadBalancer struct { Method string `json:"method,omitempty"` Sticky bool `json:"sticky,omitempty"` // Deprecated: use Stickiness instead Stickiness *Stickiness `json:"stickiness,omitempty"` }
LoadBalancer holds load balancing configuration.
type LoadBalancerMethod ¶
type LoadBalancerMethod uint8
LoadBalancerMethod holds the method of load balancing to use.
const ( // Wrr (default) = Weighted Round Robin Wrr LoadBalancerMethod = iota // Drr = Dynamic Round Robin Drr )
func NewLoadBalancerMethod ¶
func NewLoadBalancerMethod(loadBalancer *LoadBalancer) (LoadBalancerMethod, error)
NewLoadBalancerMethod create a new LoadBalancerMethod from a given LoadBalancer.
type MaxConn ¶
type MaxConn struct { Amount int64 `json:"amount,omitempty"` ExtractorFunc string `json:"extractorFunc,omitempty"` }
MaxConn holds maximum connection configuration
type Metrics ¶ added in v1.2.0
type Metrics struct { Prometheus *Prometheus `description:"Prometheus metrics exporter type" export:"true"` Datadog *Datadog `description:"DataDog metrics exporter type" export:"true"` StatsD *Statsd `description:"StatsD metrics exporter type" export:"true"` InfluxDB *InfluxDB `description:"InfluxDB metrics exporter type"` }
Metrics provides options to expose and send Traefik metrics to different third party monitoring systems
type Prometheus ¶ added in v1.2.0
type Prometheus struct { Buckets Buckets `description:"Buckets for latency metrics" export:"true"` EntryPoint string `description:"EntryPoint" export:"true"` }
Prometheus can contain specific configuration used by the Prometheus Metrics exporter
type Rate ¶ added in v1.5.0
type Rate struct { Period flaeg.Duration `json:"period,omitempty"` Average int64 `json:"average,omitempty"` Burst int64 `json:"burst,omitempty"` }
Rate holds a rate limiting configuration for a specific time period
type RateLimit ¶ added in v1.5.0
type RateLimit struct { RateSet map[string]*Rate `json:"rateset,omitempty"` ExtractorFunc string `json:"extractorFunc,omitempty"` }
RateLimit holds a rate limiting configuration for a given frontend
type Redirect ¶ added in v1.5.0
type Redirect struct { EntryPoint string `json:"entryPoint,omitempty"` Regex string `json:"regex,omitempty"` Replacement string `json:"replacement,omitempty"` Permanent bool `json:"permanent,omitempty"` }
Redirect configures a redirection of an entry point to another, or to an URL
type ResponseForwarding ¶ added in v1.7.4
type ResponseForwarding struct {
FlushInterval string `json:"flushInterval,omitempty"`
}
ResponseForwarding holds configuration for the forward of the response
type Route ¶
type Route struct {
Rule string `json:"rule,omitempty"`
}
Route holds route configuration.
type ServerRoute ¶ added in v1.6.0
type ServerRoute struct { Route *mux.Route StripPrefixes []string StripPrefixesRegex []string AddPrefix string ReplacePath string ReplacePathRegex string }
ServerRoute holds ServerRoute configuration.
type Statistics ¶ added in v1.2.0
type Statistics struct {
RecentErrors int `description:"Number of recent errors logged" export:"true"`
}
Statistics provides options for monitoring request and response stats
type Statsd ¶ added in v1.4.0
type Statsd struct { Address string `description:"StatsD address"` PushInterval string `description:"StatsD push interval" export:"true"` }
Statsd contains address and metrics pushing interval configuration
type StatusCodes ¶ added in v1.6.0
type StatusCodes []string
StatusCodes holds status codes ranges to filter access log
func (*StatusCodes) Set ¶ added in v1.6.0
func (s *StatusCodes) Set(str string) error
Set adds strings elem into the the parser it splits str on , and ;
func (*StatusCodes) SetValue ¶ added in v1.6.0
func (s *StatusCodes) SetValue(val interface{})
SetValue sets StatusCodes into the parser
func (*StatusCodes) String ¶ added in v1.6.0
func (s *StatusCodes) String() string
String return slice in a string
type Stickiness ¶ added in v1.4.0
type Stickiness struct { CookieName string `json:"cookieName,omitempty"` Secure bool `json:"secure,omitempty"` HTTPOnly bool `json:"httpOnly,omitempty"` SameSite string `json:"sameSite,omitempty"` }
Stickiness holds sticky session configuration.
type Store ¶ added in v1.1.0
type Store struct { store.Store // like this "prefix" (without the /) Prefix string `export:"true"` }
Store holds KV store cluster config
type TLSCLientCertificateDNInfos ¶ added in v1.7.7
type TLSCLientCertificateDNInfos struct { Country bool `description:"Add Country info in header" json:"country"` Province bool `description:"Add Province info in header" json:"province"` Locality bool `description:"Add Locality info in header" json:"locality"` Organization bool `description:"Add Organization info in header" json:"organization"` CommonName bool `description:"Add CommonName info in header" json:"commonName"` SerialNumber bool `description:"Add SerialNumber info in header" json:"serialNumber"` DomainComponent bool `description:"Add Domain Component info in header" json:"domainComponent"` }
TLSCLientCertificateDNInfos holds the client TLS certificate distinguished name infos configuration cf https://tools.ietf.org/html/rfc3739
type TLSClientCertificateInfos ¶ added in v1.7.0
type TLSClientCertificateInfos struct { NotAfter bool `description:"Add NotAfter info in header" json:"notAfter"` NotBefore bool `description:"Add NotBefore info in header" json:"notBefore"` Sans bool `description:"Add Sans info in header" json:"sans"` Subject *TLSCLientCertificateDNInfos `description:"Add Subject info in header" json:"subject,omitempty"` Issuer *TLSCLientCertificateDNInfos `description:"Add Issuer info in header" json:"issuer,omitempty"` }
TLSClientCertificateInfos holds the client TLS certificate infos configuration
type TLSClientHeaders ¶ added in v1.7.0
type TLSClientHeaders struct { PEM bool `description:"Enable header with escaped client pem" json:"pem"` Infos *TLSClientCertificateInfos `description:"Enable header with configured client cert infos" json:"infos,omitempty"` }
TLSClientHeaders holds the TLS client cert headers configuration.
type TraefikLog ¶ added in v1.5.0
type TraefikLog struct { FilePath string `json:"file,omitempty" description:"Traefik log file path. Stdout is used when omitted or empty"` Format string `json:"format,omitempty" description:"Traefik log format: json | common"` }
TraefikLog holds the configuration settings for the traefik logger.