http

Documentation

Overview

Package http provides an HTTP frontend for the agent baker service. This is a simple HTTP server that routes requests to the appropriate backend agent baker service.

Usage is simple:

verMap, err := versions.New()
if err != nil {
	panic(err)
}

serv, err := New(verMap)
if err != nil {
	panic(err)
}

panic(serv.ListenAndServe(*addr))

Index

• type Option
• type Server
  • func New(mapping versions.Mapping, options ...Option) (*Server, error)
  • func (s *Server) ListenAndServe(addr string) error
• type VersionedReq

Types

type Option

type Option func(*Server) error

Option is an option for the New() constructor. This is currently unused.

type Server

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

Server provides an HTTP frontend that routes requests to the appropriate backend agent baker service.

func New

func New(mapping versions.Mapping, options ...Option) (*Server, error)

New creates a new Server.

func (*Server) ListenAndServe

func (s *Server) ListenAndServe(addr string) error

ListenAndServe starts the server on the given address. This is a blocking call. It returns an error if the server fails to start. addr should be a string in the format "host:port".

type VersionedReq

type VersionedReq[T any] struct {
	// ABVersion is the Agent Baker version. This must be set to a valid version
	// or "latest".
	ABVersion versions.Version
	// Req is the request to be sent to the agent baker service.
	Req T
}

VersionedReq is a request that includes an Agent Baker version.