vhost

README

vhost

Simple couchdb database config based vhost handling

Getting started

handler = vhost.Middleware(gdb)

Database

Uses the _admin database for vhost configurations.

Every vhost needs a goydb.vhost: prefix. A vhost can have proxy configurations for reverse and db (database) proxing.

The vhost will be reacting to all specified domains.

Attachments can be used to serve static content at the root of the vhost.

{
    "_id": "goydb.vhost:example",
    "_attachments": {
        "app.zip": {
            "content_type": "application/x-zip-compressed",
            "revpos": 0,
            "digest": "21d318cbe5645a50257d1062d9dffb64",
            "length": 712001,
            "stub": true
        }
    },
    "_rev": "0-db20aa37f912a2d765a6197b0246b1e9",
    "domains": [
        "app.example.com",
        "app.example.internal"
    ],
    "proxy": {
        "/_session": {
            "target": "https://sessions.example.com/",
            "type": "reverse"
        },
        "/other": {
            "stripPrefix": true,
            "target": "https://other.example.com/dms/",
            "type": "reverse"
        },
        "/db": {
            "target": "appdb",
            "type": "db"
        }
    },
    "static": "app.zip"
}

Documentation

Index

• Constants
• func Middleware(gdb goydb.Goydb) http.Handler
• func NewProxyDBHandler(prefix, targetDB string, c *VirtualHost) http.Handler
• type VirtualHost
  • func (c *VirtualHost) FindAllVHosts(ctx context.Context) ([]*model.VirtualHostConfiguration, error)
  • func (c *VirtualHost) Middleware() func(next http.Handler) http.Handler
  • func (c *VirtualHost) RebuildHandler() error
  • func (c *VirtualHost) Run(ctx context.Context)
  • func (c *VirtualHost) ServeHTTP(w http.ResponseWriter, r *http.Request)

Constants

const (
	VirtualHostDB     = "_admin"
	VirtualHostPrefix = "goydb.vhost:"
	VirtualHostFiles  = "files.zip"
)

Functions

func Middleware

func Middleware(gdb goydb.Goydb) http.Handler

Middleware to handle virtual hosts

func NewProxyDBHandler

func NewProxyDBHandler(prefix, targetDB string, c *VirtualHost) http.Handler

Types

type VirtualHost

type VirtualHost struct {
	Storage port.Storage
	// contains filtered or unexported fields
}

VirtualHost Virtual host implements a http middleware. The middleware is configured using the vhost configration in the _admin database.

func (*VirtualHost) FindAllVHosts

func (c *VirtualHost) FindAllVHosts(ctx context.Context) ([]*model.VirtualHostConfiguration, error)

FindAllVHosts find all virtual host configurations in the database

func (*VirtualHost) Middleware

func (c *VirtualHost) Middleware() func(next http.Handler) http.Handler

func (*VirtualHost) RebuildHandler

func (c *VirtualHost) RebuildHandler() error

func (*VirtualHost) Run

func (c *VirtualHost) Run(ctx context.Context)

func (*VirtualHost) ServeHTTP

func (c *VirtualHost) ServeHTTP(w http.ResponseWriter, r *http.Request)