Consul Service Resolver Failover Not Triggering

You encounter a consul configuration issue that prevents your workflow from completing. This guide walks through the fix step by step.

Wrong ❌

apiVersion: consul.hashicorp.com/v1alpha1
kind: ServiceResolver
metadata: { name: my-service }
spec:
  defaultSubset: primary
  subsets:
    primary: { filter: "Service.Meta.zone == us-east-1" }
    failover: { filter: "Service.Meta.zone == us-west-1" }
    # Missing failover configuration

Wrong Output

Primary fails but failover never triggers. Requests fail instead of routing to secondary.

Right ✅

apiVersion: consul.hashicorp.com/v1alpha1
kind: ServiceResolver
metadata: { name: my-service }
spec:
  defaultSubset: primary
  subsets:
    primary: { filter: "Service.Meta.zone == us-east-1" }
    failover: { filter: "Service.Meta.zone == us-west-1" }
  failover:
    primary:
      service: my-service
      serviceSubset: failover
      datacenters: ["dc2"]

Right Output

Primary fails -> traffic routes to failover subset. Recovers automatically.

Prevention

• Configure failover with explicit service and subset targets.
• Use datacenters for cross-dc failover.
• Test by scaling primary subset to zero.
• Monitor failover events in Consul logs.
• Set realistic health check intervals.

DodaTech applies similar defensive patterns across Doda Browser, DodaZIP, and Durga Antivirus Pro infrastructure for production reliability.

Common Mistakes with resolver config

1. Mixing let bindings with <- bindings in do notation, producing type errors
2. Overlapping type class instances that cause GHC to reject the program with ambiguous dispatch errors
3. Non-exhaustive pattern matches that compile with warnings then crash at runtime

These mistakes appear frequently in real-world CONSUL code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

This quick fix is part of the DodaTech infrastructure engineering series. Learn more at DodaTech tutorials.