route

Documentation

Index

• func SetPickerStrategy(s string) error
• func SetTable(t Table)
• type Table
  • func GetTable() Table
  • func Parse(r io.Reader) (Table, error)
  • func ParseFile(path string) (Table, error)
  • func ParseString(s string) (Table, error)
  • func (t Table) AddRoute(service, prefix, target string, weight float64, tags []string) error
  • func (t Table) AddRouteWeight(service, prefix string, weight float64, tags []string) error
  • func (t Table) Config(addWeight bool) []string
  • func (t Table) DelRoute(service, prefix, target string) error
  • func (t Table) Lookup(req *http.Request, trace string) *Target
  • func (t Table) String() string
• type Target

Functions

func SetPickerStrategy

func SetPickerStrategy(s string) error

SetPickerStrategy sets the picker function for the proxy.

func SetTable

func SetTable(t Table)

Types

type Table

type Table map[string]routes

Table contains a set of routes grouped by host. The host routes are sorted from most to least specific by sorting the routes in reverse order by path.

func GetTable

func GetTable() Table

func Parse

func Parse(r io.Reader) (Table, error)

Parse loads a routing table from a set of route commands.

The commands are parsed in order and order matters. Deleting a route that has not been created yet yields a different result than the other way around.

Route commands can have the following form:

route add service host/path targetURL
- Add a new route for host/path to targetURL

route del service
- Remove all routes for service

route del service host/path
- Remove all routes for host/path for this service only

route del service host/path targetURL
 - Remove only this route

func ParseFile

func ParseFile(path string) (Table, error)

ParseFile loads a routing table from a file.

func ParseString

func ParseString(s string) (Table, error)

ParseString loads a routing table from a string.

func (Table) AddRoute

func (t Table) AddRoute(service, prefix, target string, weight float64, tags []string) error

AddRoute adds a new route prefix -> target for the given service.

func (Table) AddRouteWeight

func (t Table) AddRouteWeight(service, prefix string, weight float64, tags []string) error

func (Table) Config

func (t Table) Config(addWeight bool) []string

func (Table) DelRoute

func (t Table) DelRoute(service, prefix, target string) error

DelRoute removes one or more routes depending on the arguments. If service, prefix and target are provided then only this route is removed. Are only service and prefix provided then all routes for this service and prefix are removed. This removes all active instances of the service from the route. If only the service is provided then all routes for this service are removed. The service will no longer receive traffic.

func (Table) Lookup

func (t Table) Lookup(req *http.Request, trace string) *Target

Lookup finds a target url based on the current matcher and picker or nil if there is none. It first checks the routes for the host and if none matches then it falls back to generic routes without a host. This is useful for a catch-all '/' rule.

func (Table) String

func (t Table) String() string

String returns the routing table as config file which can be read by Parse() again.

type Target

type Target struct {

	// URL is the endpoint the service instance listens on
	URL *url.URL

	// timer measures throughput and latency of this target
	Timer gometrics.Timer
	// contains filtered or unexported fields
}