diff --git a/docs/content/reference/dynamic-configuration/file.toml b/docs/content/reference/dynamic-configuration/file.toml
index 0aad383d6..08c45f0b7 100644
--- a/docs/content/reference/dynamic-configuration/file.toml
+++ b/docs/content/reference/dynamic-configuration/file.toml
@@ -95,6 +95,12 @@
secure = true
httpOnly = true
sameSite = "foobar"
+ [http.services.Service04]
+ [http.services.Service04.failover]
+ service = "foobar"
+ fallback = "foobar"
+
+ [http.services.Service04.failover.healthCheck]
[http.middlewares]
[http.middlewares.Middleware00]
[http.middlewares.Middleware00.addPrefix]
diff --git a/docs/content/reference/dynamic-configuration/file.yaml b/docs/content/reference/dynamic-configuration/file.yaml
index 846e9ea2c..0fa87fa6c 100644
--- a/docs/content/reference/dynamic-configuration/file.yaml
+++ b/docs/content/reference/dynamic-configuration/file.yaml
@@ -95,6 +95,11 @@ http:
secure: true
httpOnly: true
sameSite: foobar
+ Service04:
+ failover:
+ service: foobar
+ fallback: foobar
+ healthCheck: {}
middlewares:
Middleware00:
addPrefix:
diff --git a/docs/content/reference/dynamic-configuration/kv-ref.md b/docs/content/reference/dynamic-configuration/kv-ref.md
index 0df01e697..591052b6b 100644
--- a/docs/content/reference/dynamic-configuration/kv-ref.md
+++ b/docs/content/reference/dynamic-configuration/kv-ref.md
@@ -228,6 +228,9 @@
| `traefik/http/services/Service03/weighted/sticky/cookie/name` | `foobar` |
| `traefik/http/services/Service03/weighted/sticky/cookie/sameSite` | `foobar` |
| `traefik/http/services/Service03/weighted/sticky/cookie/secure` | `true` |
+| `traefik/http/services/Service04/failover/fallback` | `foobar` |
+| `traefik/http/services/Service04/failover/healthCheck` | `` |
+| `traefik/http/services/Service04/failover/service` | `foobar` |
| `traefik/tcp/middlewares/Middleware00/ipWhiteList/sourceRange/0` | `foobar` |
| `traefik/tcp/middlewares/Middleware00/ipWhiteList/sourceRange/1` | `foobar` |
| `traefik/tcp/routers/TCPRouter0/entryPoints/0` | `foobar` |
diff --git a/docs/content/routing/services/index.md b/docs/content/routing/services/index.md
index 6b3d35701..7205177f9 100644
--- a/docs/content/routing/services/index.md
+++ b/docs/content/routing/services/index.md
@@ -1212,6 +1212,139 @@ http:
url = "http://private-ip-server-2/"
```
+### Failover (service)
+
+A failover service job is to forward all requests to a fallback service when the main service becomes unreachable.
+
+!!! info "Relation to HealthCheck"
+
+ The failover service relies on the HealthCheck system to get notified when its main service becomes unreachable,
+ which means HealthCheck needs to be enabled and functional on the main service.
+ However, HealthCheck does not need to be enabled on the failover service itself for it to be functional.
+ It is only required in order to propagate upwards the information when the failover itself becomes down
+ (i.e. both its main and its fallback are down too).
+
+!!! info "Supported Providers"
+
+ This strategy can currently only be defined with the [File](../../providers/file.md) provider.
+
+```yaml tab="YAML"
+## Dynamic configuration
+http:
+ services:
+ app:
+ failover:
+ service: main
+ fallback: backup
+
+ main:
+ loadBalancer:
+ healthCheck:
+ path: /status
+ interval: 10s
+ timeout: 3s
+ servers:
+ - url: "http://private-ip-server-1/"
+
+ backup:
+ loadBalancer:
+ servers:
+ - url: "http://private-ip-server-2/"
+```
+
+```toml tab="TOML"
+## Dynamic configuration
+[http.services]
+ [http.services.app]
+ [http.services.app.failover]
+ service = "main"
+ fallback = "backup"
+
+ [http.services.main]
+ [http.services.main.loadBalancer]
+ [http.services.main.loadBalancer.healthCheck]
+ path = "/health"
+ interval = "10s"
+ timeout = "3s"
+ [[http.services.main.loadBalancer.servers]]
+ url = "http://private-ip-server-1/"
+
+ [http.services.backup]
+ [http.services.backup.loadBalancer]
+ [[http.services.backup.loadBalancer.servers]]
+ url = "http://private-ip-server-2/"
+```
+
+#### Health Check
+
+HealthCheck enables automatic self-healthcheck for this service,
+i.e. if the main and the fallback services become unreachable,
+the information is propagated upwards to its parent.
+
+!!! info "All or nothing"
+
+ If HealthCheck is enabled for a given service, but any of its descendants does
+ not have it enabled, the creation of the service will fail.
+
+ HealthCheck on a Failover service can currently only be defined with the [File](../../providers/file.md) provider.
+
+```yaml tab="YAML"
+## Dynamic configuration
+http:
+ services:
+ app:
+ failover:
+ healthCheck: {}
+ service: main
+ fallback: backup
+
+ main:
+ loadBalancer:
+ healthCheck:
+ path: /status
+ interval: 10s
+ timeout: 3s
+ servers:
+ - url: "http://private-ip-server-1/"
+
+ backup:
+ loadBalancer:
+ healthCheck:
+ path: /status
+ interval: 10s
+ timeout: 3s
+ servers:
+ - url: "http://private-ip-server-2/"
+```
+
+```toml tab="TOML"
+## Dynamic configuration
+[http.services]
+ [http.services.app]
+ [http.services.app.failover.healthCheck]
+ [http.services.app.failover]
+ service = "main"
+ fallback = "backup"
+
+ [http.services.main]
+ [http.services.main.loadBalancer]
+ [http.services.main.loadBalancer.healthCheck]
+ path = "/health"
+ interval = "10s"
+ timeout = "3s"
+ [[http.services.main.loadBalancer.servers]]
+ url = "http://private-ip-server-1/"
+
+ [http.services.backup]
+ [http.services.backup.loadBalancer]
+ [http.services.backup.loadBalancer.healthCheck]
+ path = "/health"
+ interval = "10s"
+ timeout = "3s"
+ [[http.services.backup.loadBalancer.servers]]
+ url = "http://private-ip-server-2/"
+```
+
## Configuring TCP Services
### General
diff --git a/pkg/config/dynamic/http_config.go b/pkg/config/dynamic/http_config.go
index ea4e97964..014cfe205 100644
--- a/pkg/config/dynamic/http_config.go
+++ b/pkg/config/dynamic/http_config.go
@@ -35,6 +35,7 @@ type Service struct {
LoadBalancer *ServersLoadBalancer `json:"loadBalancer,omitempty" toml:"loadBalancer,omitempty" yaml:"loadBalancer,omitempty" export:"true"`
Weighted *WeightedRoundRobin `json:"weighted,omitempty" toml:"weighted,omitempty" yaml:"weighted,omitempty" label:"-" export:"true"`
Mirroring *Mirroring `json:"mirroring,omitempty" toml:"mirroring,omitempty" yaml:"mirroring,omitempty" label:"-" export:"true"`
+ Failover *Failover `json:"failover,omitempty" toml:"failover,omitempty" yaml:"failover,omitempty" label:"-" export:"true"`
}
// +k8s:deepcopy-gen=true
@@ -76,6 +77,15 @@ func (m *Mirroring) SetDefaults() {
// +k8s:deepcopy-gen=true
+// Failover holds the Failover configuration.
+type Failover struct {
+ Service string `json:"service,omitempty" toml:"service,omitempty" yaml:"service,omitempty" export:"true"`
+ Fallback string `json:"fallback,omitempty" toml:"fallback,omitempty" yaml:"fallback,omitempty" export:"true"`
+ HealthCheck *HealthCheck `json:"healthCheck,omitempty" toml:"healthCheck,omitempty" yaml:"healthCheck,omitempty" label:"allowEmpty" file:"allowEmpty" export:"true"`
+}
+
+// +k8s:deepcopy-gen=true
+
// MirrorService holds the MirrorService configuration.
type MirrorService struct {
Name string `json:"name,omitempty" toml:"name,omitempty" yaml:"name,omitempty" export:"true"`
@@ -98,7 +108,7 @@ type WeightedRoundRobin struct {
// +k8s:deepcopy-gen=true
-// WRRService is a reference to a service load-balanced with weighted round robin.
+// WRRService is a reference to a service load-balanced with weighted round-robin.
type WRRService struct {
Name string `json:"name,omitempty" toml:"name,omitempty" yaml:"name,omitempty" export:"true"`
Weight *int `json:"weight,omitempty" toml:"weight,omitempty" yaml:"weight,omitempty" export:"true"`
diff --git a/pkg/config/dynamic/zz_generated.deepcopy.go b/pkg/config/dynamic/zz_generated.deepcopy.go
index be07061df..587048180 100644
--- a/pkg/config/dynamic/zz_generated.deepcopy.go
+++ b/pkg/config/dynamic/zz_generated.deepcopy.go
@@ -285,6 +285,27 @@ func (in *ErrorPage) DeepCopy() *ErrorPage {
return out
}
+// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
+func (in *Failover) DeepCopyInto(out *Failover) {
+ *out = *in
+ if in.HealthCheck != nil {
+ in, out := &in.HealthCheck, &out.HealthCheck
+ *out = new(HealthCheck)
+ **out = **in
+ }
+ return
+}
+
+// DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Failover.
+func (in *Failover) DeepCopy() *Failover {
+ if in == nil {
+ return nil
+ }
+ out := new(Failover)
+ in.DeepCopyInto(out)
+ return out
+}
+
// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (in *ForwardAuth) DeepCopyInto(out *ForwardAuth) {
*out = *in
@@ -1171,6 +1192,11 @@ func (in *Service) DeepCopyInto(out *Service) {
*out = new(Mirroring)
(*in).DeepCopyInto(*out)
}
+ if in.Failover != nil {
+ in, out := &in.Failover, &out.Failover
+ *out = new(Failover)
+ (*in).DeepCopyInto(*out)
+ }
return
}
diff --git a/pkg/provider/kv/kv_test.go b/pkg/provider/kv/kv_test.go
index ba623f4a3..b41fada2a 100644
--- a/pkg/provider/kv/kv_test.go
+++ b/pkg/provider/kv/kv_test.go
@@ -69,6 +69,8 @@ func Test_buildConfiguration(t *testing.T) {
"traefik/http/services/Service03/weighted/services/0/weight": "42",
"traefik/http/services/Service03/weighted/services/1/name": "foobar",
"traefik/http/services/Service03/weighted/services/1/weight": "42",
+ "traefik/http/services/Service04/failover/service": "foobar",
+ "traefik/http/services/Service04/failover/fallback": "foobar",
"traefik/http/middlewares/Middleware08/forwardAuth/authResponseHeaders/0": "foobar",
"traefik/http/middlewares/Middleware08/forwardAuth/authResponseHeaders/1": "foobar",
"traefik/http/middlewares/Middleware08/forwardAuth/authRequestHeaders/0": "foobar",
@@ -688,6 +690,12 @@ func Test_buildConfiguration(t *testing.T) {
},
},
},
+ "Service04": {
+ Failover: &dynamic.Failover{
+ Service: "foobar",
+ Fallback: "foobar",
+ },
+ },
},
},
TCP: &dynamic.TCPConfiguration{
diff --git a/pkg/server/service/loadbalancer/failover/failover.go b/pkg/server/service/loadbalancer/failover/failover.go
new file mode 100644
index 000000000..06d9fecd7
--- /dev/null
+++ b/pkg/server/service/loadbalancer/failover/failover.go
@@ -0,0 +1,140 @@
+package failover
+
+import (
+ "context"
+ "errors"
+ "net/http"
+ "sync"
+
+ "github.com/traefik/traefik/v2/pkg/config/dynamic"
+ "github.com/traefik/traefik/v2/pkg/log"
+)
+
+// Failover is an http.Handler that can forward requests to the fallback handler
+// when the main handler status is down.
+type Failover struct {
+ wantsHealthCheck bool
+ handler http.Handler
+ fallbackHandler http.Handler
+ // updaters is the list of hooks that are run (to update the Failover
+ // parent(s)), whenever the Failover status changes.
+ updaters []func(bool)
+
+ handlerStatusMu sync.RWMutex
+ handlerStatus bool
+
+ fallbackStatusMu sync.RWMutex
+ fallbackStatus bool
+}
+
+// New creates a new Failover handler.
+func New(hc *dynamic.HealthCheck) *Failover {
+ return &Failover{
+ wantsHealthCheck: hc != nil,
+ }
+}
+
+// RegisterStatusUpdater adds fn to the list of hooks that are run when the
+// status of the Failover changes.
+// Not thread safe.
+func (f *Failover) RegisterStatusUpdater(fn func(up bool)) error {
+ if !f.wantsHealthCheck {
+ return errors.New("healthCheck not enabled in config for this failover service")
+ }
+
+ f.updaters = append(f.updaters, fn)
+
+ return nil
+}
+
+func (f *Failover) ServeHTTP(w http.ResponseWriter, req *http.Request) {
+ f.handlerStatusMu.RLock()
+ handlerStatus := f.handlerStatus
+ f.handlerStatusMu.RUnlock()
+
+ if handlerStatus {
+ f.handler.ServeHTTP(w, req)
+ return
+ }
+
+ f.fallbackStatusMu.RLock()
+ fallbackStatus := f.fallbackStatus
+ f.fallbackStatusMu.RUnlock()
+
+ if fallbackStatus {
+ f.fallbackHandler.ServeHTTP(w, req)
+ return
+ }
+
+ http.Error(w, http.StatusText(http.StatusServiceUnavailable), http.StatusServiceUnavailable)
+}
+
+// SetHandler sets the main http.Handler.
+func (f *Failover) SetHandler(handler http.Handler) {
+ f.handlerStatusMu.Lock()
+ defer f.handlerStatusMu.Unlock()
+
+ f.handler = handler
+ f.handlerStatus = true
+}
+
+// SetHandlerStatus sets the main handler status.
+func (f *Failover) SetHandlerStatus(ctx context.Context, up bool) {
+ f.handlerStatusMu.Lock()
+ defer f.handlerStatusMu.Unlock()
+
+ status := "DOWN"
+ if up {
+ status = "UP"
+ }
+
+ if up == f.handlerStatus {
+ // We're still with the same status, no need to propagate.
+ log.FromContext(ctx).Debugf("Still %s, no need to propagate", status)
+ return
+ }
+
+ log.FromContext(ctx).Debugf("Propagating new %s status", status)
+ f.handlerStatus = up
+
+ for _, fn := range f.updaters {
+ // Failover service status is set to DOWN
+ // when main and fallback handlers have a DOWN status.
+ fn(f.handlerStatus || f.fallbackStatus)
+ }
+}
+
+// SetFallbackHandler sets the fallback http.Handler.
+func (f *Failover) SetFallbackHandler(handler http.Handler) {
+ f.fallbackStatusMu.Lock()
+ defer f.fallbackStatusMu.Unlock()
+
+ f.fallbackHandler = handler
+ f.fallbackStatus = true
+}
+
+// SetFallbackHandlerStatus sets the fallback handler status.
+func (f *Failover) SetFallbackHandlerStatus(ctx context.Context, up bool) {
+ f.fallbackStatusMu.Lock()
+ defer f.fallbackStatusMu.Unlock()
+
+ status := "DOWN"
+ if up {
+ status = "UP"
+ }
+
+ if up == f.fallbackStatus {
+ // We're still with the same status, no need to propagate.
+ log.FromContext(ctx).Debugf("Still %s, no need to propagate", status)
+ return
+ }
+
+ log.FromContext(ctx).Debugf("Propagating new %s status", status)
+ f.fallbackStatus = up
+
+ for _, fn := range f.updaters {
+ // Failover service status is set to DOWN
+ // when main and fallback handlers have a DOWN status.
+ fn(f.handlerStatus || f.fallbackStatus)
+ }
+}
diff --git a/pkg/server/service/loadbalancer/failover/failover_test.go b/pkg/server/service/loadbalancer/failover/failover_test.go
new file mode 100644
index 000000000..9f8d38215
--- /dev/null
+++ b/pkg/server/service/loadbalancer/failover/failover_test.go
@@ -0,0 +1,163 @@
+package failover
+
+import (
+ "context"
+ "net/http"
+ "net/http/httptest"
+ "testing"
+
+ "github.com/stretchr/testify/assert"
+ "github.com/stretchr/testify/require"
+ "github.com/traefik/traefik/v2/pkg/config/dynamic"
+)
+
+type responseRecorder struct {
+ *httptest.ResponseRecorder
+ save map[string]int
+ sequence []string
+ status []int
+}
+
+func (r *responseRecorder) WriteHeader(statusCode int) {
+ r.save[r.Header().Get("server")]++
+ r.sequence = append(r.sequence, r.Header().Get("server"))
+ r.status = append(r.status, statusCode)
+ r.ResponseRecorder.WriteHeader(statusCode)
+}
+
+func TestFailover(t *testing.T) {
+ failover := New(&dynamic.HealthCheck{})
+
+ status := true
+ require.NoError(t, failover.RegisterStatusUpdater(func(up bool) {
+ status = up
+ }))
+
+ failover.SetHandler(http.HandlerFunc(func(rw http.ResponseWriter, req *http.Request) {
+ rw.Header().Set("server", "handler")
+ rw.WriteHeader(http.StatusOK)
+ }))
+
+ failover.SetFallbackHandler(http.HandlerFunc(func(rw http.ResponseWriter, req *http.Request) {
+ rw.Header().Set("server", "fallback")
+ rw.WriteHeader(http.StatusOK)
+ }))
+
+ recorder := &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ failover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 1, recorder.save["handler"])
+ assert.Equal(t, 0, recorder.save["fallback"])
+ assert.Equal(t, []int{200}, recorder.status)
+ assert.True(t, status)
+
+ failover.SetHandlerStatus(context.Background(), false)
+
+ recorder = &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ failover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 0, recorder.save["handler"])
+ assert.Equal(t, 1, recorder.save["fallback"])
+ assert.Equal(t, []int{200}, recorder.status)
+ assert.True(t, status)
+
+ failover.SetFallbackHandlerStatus(context.Background(), false)
+
+ recorder = &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ failover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 0, recorder.save["handler"])
+ assert.Equal(t, 0, recorder.save["fallback"])
+ assert.Equal(t, []int{503}, recorder.status)
+ assert.False(t, status)
+}
+
+func TestFailoverDownThenUp(t *testing.T) {
+ failover := New(nil)
+
+ failover.SetHandler(http.HandlerFunc(func(rw http.ResponseWriter, req *http.Request) {
+ rw.Header().Set("server", "handler")
+ rw.WriteHeader(http.StatusOK)
+ }))
+
+ failover.SetFallbackHandler(http.HandlerFunc(func(rw http.ResponseWriter, req *http.Request) {
+ rw.Header().Set("server", "fallback")
+ rw.WriteHeader(http.StatusOK)
+ }))
+
+ recorder := &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ failover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 1, recorder.save["handler"])
+ assert.Equal(t, 0, recorder.save["fallback"])
+ assert.Equal(t, []int{200}, recorder.status)
+
+ failover.SetHandlerStatus(context.Background(), false)
+
+ recorder = &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ failover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 0, recorder.save["handler"])
+ assert.Equal(t, 1, recorder.save["fallback"])
+ assert.Equal(t, []int{200}, recorder.status)
+
+ failover.SetHandlerStatus(context.Background(), true)
+
+ recorder = &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ failover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 1, recorder.save["handler"])
+ assert.Equal(t, 0, recorder.save["fallback"])
+ assert.Equal(t, []int{200}, recorder.status)
+}
+
+func TestFailoverPropagate(t *testing.T) {
+ failover := New(&dynamic.HealthCheck{})
+ failover.SetHandler(http.HandlerFunc(func(rw http.ResponseWriter, req *http.Request) {
+ rw.Header().Set("server", "handler")
+ rw.WriteHeader(http.StatusOK)
+ }))
+ failover.SetFallbackHandler(http.HandlerFunc(func(rw http.ResponseWriter, req *http.Request) {
+ rw.Header().Set("server", "fallback")
+ rw.WriteHeader(http.StatusOK)
+ }))
+
+ topFailover := New(nil)
+ topFailover.SetHandler(failover)
+ topFailover.SetFallbackHandler(http.HandlerFunc(func(rw http.ResponseWriter, req *http.Request) {
+ rw.Header().Set("server", "topFailover")
+ rw.WriteHeader(http.StatusOK)
+ }))
+ err := failover.RegisterStatusUpdater(func(up bool) {
+ topFailover.SetHandlerStatus(context.Background(), up)
+ })
+ require.NoError(t, err)
+
+ recorder := &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ topFailover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 1, recorder.save["handler"])
+ assert.Equal(t, 0, recorder.save["fallback"])
+ assert.Equal(t, 0, recorder.save["topFailover"])
+ assert.Equal(t, []int{200}, recorder.status)
+
+ failover.SetHandlerStatus(context.Background(), false)
+
+ recorder = &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ topFailover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 0, recorder.save["handler"])
+ assert.Equal(t, 1, recorder.save["fallback"])
+ assert.Equal(t, 0, recorder.save["topFailover"])
+ assert.Equal(t, []int{200}, recorder.status)
+
+ failover.SetFallbackHandlerStatus(context.Background(), false)
+
+ recorder = &responseRecorder{ResponseRecorder: httptest.NewRecorder(), save: map[string]int{}}
+ topFailover.ServeHTTP(recorder, httptest.NewRequest(http.MethodGet, "/", nil))
+
+ assert.Equal(t, 0, recorder.save["handler"])
+ assert.Equal(t, 0, recorder.save["fallback"])
+ assert.Equal(t, 1, recorder.save["topFailover"])
+ assert.Equal(t, []int{200}, recorder.status)
+}
diff --git a/pkg/server/service/loadbalancer/wrr/wrr.go b/pkg/server/service/loadbalancer/wrr/wrr.go
index a1fa085aa..d7261d95b 100644
--- a/pkg/server/service/loadbalancer/wrr/wrr.go
+++ b/pkg/server/service/loadbalancer/wrr/wrr.go
@@ -29,7 +29,7 @@ type stickyCookie struct {
// (https://en.wikipedia.org/wiki/Earliest_deadline_first_scheduling)
// Each pick from the schedule has the earliest deadline entry selected.
// Entries have deadlines set at currentDeadline + 1 / weight,
-// providing weighted round robin behavior with floating point weights and an O(log n) pick time.
+// providing weighted round-robin behavior with floating point weights and an O(log n) pick time.
type Balancer struct {
stickyCookie *stickyCookie
wantsHealthCheck bool
@@ -230,6 +230,7 @@ func (b *Balancer) AddService(name string, handler http.Handler, weight *int) {
if weight != nil {
w = *weight
}
+
if w <= 0 { // non-positive weight is meaningless
return
}
diff --git a/pkg/server/service/service.go b/pkg/server/service/service.go
index 93e6f23b5..e2f878594 100644
--- a/pkg/server/service/service.go
+++ b/pkg/server/service/service.go
@@ -23,6 +23,7 @@ import (
"github.com/traefik/traefik/v2/pkg/safe"
"github.com/traefik/traefik/v2/pkg/server/cookie"
"github.com/traefik/traefik/v2/pkg/server/provider"
+ "github.com/traefik/traefik/v2/pkg/server/service/loadbalancer/failover"
"github.com/traefik/traefik/v2/pkg/server/service/loadbalancer/mirror"
"github.com/traefik/traefik/v2/pkg/server/service/loadbalancer/wrr"
"github.com/vulcand/oxy/roundrobin"
@@ -116,6 +117,13 @@ func (m *Manager) BuildHTTP(rootCtx context.Context, serviceName string) (http.H
conf.AddError(err, true)
return nil, err
}
+ case conf.Failover != nil:
+ var err error
+ lb, err = m.getFailoverServiceHandler(ctx, serviceName, conf.Failover)
+ if err != nil {
+ conf.AddError(err, true)
+ return nil, err
+ }
default:
sErr := fmt.Errorf("the service %q does not have any type defined", serviceName)
conf.AddError(sErr, true)
@@ -125,6 +133,53 @@ func (m *Manager) BuildHTTP(rootCtx context.Context, serviceName string) (http.H
return lb, nil
}
+func (m *Manager) getFailoverServiceHandler(ctx context.Context, serviceName string, config *dynamic.Failover) (http.Handler, error) {
+ f := failover.New(config.HealthCheck)
+
+ serviceHandler, err := m.BuildHTTP(ctx, config.Service)
+ if err != nil {
+ return nil, err
+ }
+
+ f.SetHandler(serviceHandler)
+
+ updater, ok := serviceHandler.(healthcheck.StatusUpdater)
+ if !ok {
+ return nil, fmt.Errorf("child service %v of %v not a healthcheck.StatusUpdater (%T)", config.Service, serviceName, serviceHandler)
+ }
+
+ if err := updater.RegisterStatusUpdater(func(up bool) {
+ f.SetHandlerStatus(ctx, up)
+ }); err != nil {
+ return nil, fmt.Errorf("cannot register %v as updater for %v: %w", config.Service, serviceName, err)
+ }
+
+ fallbackHandler, err := m.BuildHTTP(ctx, config.Fallback)
+ if err != nil {
+ return nil, err
+ }
+
+ f.SetFallbackHandler(fallbackHandler)
+
+ // Do not report the health of the fallback handler.
+ if config.HealthCheck == nil {
+ return f, nil
+ }
+
+ fallbackUpdater, ok := fallbackHandler.(healthcheck.StatusUpdater)
+ if !ok {
+ return nil, fmt.Errorf("child service %v of %v not a healthcheck.StatusUpdater (%T)", config.Fallback, serviceName, fallbackHandler)
+ }
+
+ if err := fallbackUpdater.RegisterStatusUpdater(func(up bool) {
+ f.SetFallbackHandlerStatus(ctx, up)
+ }); err != nil {
+ return nil, fmt.Errorf("cannot register %v as updater for %v: %w", config.Fallback, serviceName, err)
+ }
+
+ return f, nil
+}
+
func (m *Manager) getMirrorServiceHandler(ctx context.Context, config *dynamic.Mirroring) (http.Handler, error) {
serviceHandler, err := m.BuildHTTP(ctx, config.Service)
if err != nil {
@@ -164,6 +219,7 @@ func (m *Manager) getWRRServiceHandler(ctx context.Context, serviceName string,
}
balancer.AddService(service.Name, serviceHandler, service.Weight)
+
if config.HealthCheck == nil {
continue
}
diff --git a/webui/src/components/_commons/PanelServiceDetails.vue b/webui/src/components/_commons/PanelServiceDetails.vue
index a6052935b..71a3c54dd 100644
--- a/webui/src/components/_commons/PanelServiceDetails.vue
+++ b/webui/src/components/_commons/PanelServiceDetails.vue
@@ -39,8 +39,9 @@
Main Service
+ class="app-chip app-chip-name app-chip-overflow">
{{ data.mirroring.service }}
+ {{ data.mirroring.service }}
@@ -80,6 +81,34 @@
+
+
+
+
Main Service
+
+ {{ data.failover.service }}
+ {{ data.failover.service }}
+
+
+
+
+
Fallback Service
+
+ {{ data.failover.fallback }}
+ {{ data.failover.fallback }}
+
+
+