vulcan

package

v0.7.0 Latest Latest Go to latest Published: Dec 22, 2014 License: Apache-2.0, Apache-2.0 Imports: 9 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Repository

github.com/3ko/vulcand

Links

Open Source Insights

README ¶

Reverse proxy library

Vulcan is a low level library that provides reverse proxy functionality to golang programs

Docs: http://www.vulcanproxy.com
Used by: https://github.com/mailgun/vulcand

Features

Load balancing
Request routing
Error detection and failure recovery
Connection and rate limiting
Pluggable middlewares

Status

Hardening and covering by tests, use at own risk

Documentation ¶

Overview ¶

This package contains the reverse proxy that implements http.HandlerFunc

Index ¶

type Options
type Proxy
- func NewProxy(router route.Router) (*Proxy, error)
- func NewProxyWithOptions(router route.Router, o Options) (*Proxy, error)
- func (p *Proxy) GetRouter() route.Router
- func (p *Proxy) ServeHTTP(w http.ResponseWriter, r *http.Request)

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Options ¶

type Options struct {
	// Takes a status code and formats it into proxy response
	ErrorFormatter errors.Formatter
}

type Proxy ¶

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

func NewProxy ¶

func NewProxy(router route.Router) (*Proxy, error)

Creates a proxy with a given router

func NewProxyWithOptions ¶

func NewProxyWithOptions(router route.Router, o Options) (*Proxy, error)

Creates reverse proxy that acts like http request handler

func (*Proxy) GetRouter ¶

func (p *Proxy) GetRouter() route.Router

func (*Proxy) ServeHTTP ¶

func (p *Proxy) ServeHTTP(w http.ResponseWriter, r *http.Request)

Accepts requests, round trips it to the endpoint, and writes back the response.

Source Files ¶

View all Source files

proxy.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
circuitbreaker Circuit breakers start in the Standby state first, observing responses and watching location metrics.	Circuit breakers start in the Standby state first, observing responses and watching location metrics.
endpoint Endpoints - final destination of the http request	Endpoints - final destination of the http request
errors Utility functions for producing errorneous http responses	Utility functions for producing errorneous http responses
headers Constants with common HTTP headers	Constants with common HTTP headers
limit Interfaces for request limiting	Interfaces for request limiting
connlimit Simultaneous connection limiter	Simultaneous connection limiter
tokenbucket Tokenbucket based request rate limiter	Tokenbucket based request rate limiter
loadbalance Load balancers control how requests are distributed among multiple endpoints.	Load balancers control how requests are distributed among multiple endpoints.
roundrobin Dynamic weighted round robin load balancer	Dynamic weighted round robin load balancer
location Interfaces for location - round trip the http request to backends	Interfaces for location - round trip the http request to backends
httploc HTTP location with load balancing and pluggable middlewares	HTTP location with load balancing and pluggable middlewares
metrics In memory request performance metrics	In memory request performance metrics
middleware Middlewares can modify or intercept requests and responses	Middlewares can modify or intercept requests and responses
netutils Network related utilities	Network related utilities
request Wrapper around http.Request with additional features	Wrapper around http.Request with additional features
route Route the request to a location	Route the request to a location
exproute see http://godoc.org/github.com/mailgun/route for documentation on the language	see http://godoc.org/github.com/mailgun/route for documentation on the language
hostroute Route the request by hostname	Route the request by hostname
pathroute Route the request by path	Route the request by path
template Package template consolidates various templating utilities used throughout different parts of vulcan.	Package template consolidates various templating utilities used throughout different parts of vulcan.
testutils
threshold Package threshold contains predicates that can define various request thresholds Examples: * RequestMethod() == "GET" triggers action when request method equals "GET" * IsNetworkError() - triggers action on network errors * RequestMethod() == "GET" && Attempts <= 2 && (IsNetworkError() \|\| ResponseCode() == 408) This predicate triggers for GET requests with maximum 2 attempts on network errors or when upstream returns special http response code 408	Package threshold contains predicates that can define various request thresholds Examples: * RequestMethod() == "GET" triggers action when request method equals "GET" * IsNetworkError() - triggers action on network errors * RequestMethod() == "GET" && Attempts <= 2 && (IsNetworkError() \|\| ResponseCode() == 408) This predicate triggers for GET requests with maximum 2 attempts on network errors or when upstream returns special http response code 408