service

Documentation

Overview

Package service provides the Registry interface and its RESTStorage implementation for storing Service api objects.

Index

• Variables
• func CollectServiceNodePorts(service *api.Service) []int
• func MatchServices(label labels.Selector, field fields.Selector) generic.Matcher
• func ServiceToSelectableFields(service *api.Service) fields.Set
• type ProxyREST
  • func (r *ProxyREST) Connect(ctx api.Context, id string, opts runtime.Object, responder rest.Responder) (http.Handler, error)
  • func (r *ProxyREST) ConnectMethods() []string
  • func (r *ProxyREST) New() runtime.Object
  • func (r *ProxyREST) NewConnectOptions() (runtime.Object, bool, string)
• type REST
  • func (rs *REST) Create(ctx api.Context, obj runtime.Object) (runtime.Object, error)
  • func (rs *REST) Delete(ctx api.Context, id string) (runtime.Object, error)
  • func (rs *REST) Export(ctx api.Context, name string, opts unversioned.ExportOptions) (runtime.Object, error)
  • func (rs *REST) Get(ctx api.Context, id string) (runtime.Object, error)
  • func (rs *REST) List(ctx api.Context, options *api.ListOptions) (runtime.Object, error)
  • func (*REST) New() runtime.Object
  • func (*REST) NewList() runtime.Object
  • func (rs *REST) ResourceLocation(ctx api.Context, id string) (*url.URL, http.RoundTripper, error)
  • func (rs *REST) Update(ctx api.Context, name string, objInfo rest.UpdatedObjectInfo) (runtime.Object, bool, error)
  • func (rs *REST) Watch(ctx api.Context, options *api.ListOptions) (watch.Interface, error)
• type RangeRegistry
• type Registry
  • func NewRegistry(s rest.StandardStorage) Registry
• type ServiceRest
  • func NewStorage(registry Registry, endpoints endpoint.Registry, ...) *ServiceRest

Variables

var StatusStrategy = serviceStatusStrategy{Strategy}

StatusStrategy is the default logic invoked when updating service status.

var Strategy = svcStrategy{api.Scheme, api.SimpleNameGenerator}

Services is the default logic that applies when creating and updating Service objects.

Functions

func CollectServiceNodePorts

func CollectServiceNodePorts(service *api.Service) []int

func MatchServices

func MatchServices(label labels.Selector, field fields.Selector) generic.Matcher

func ServiceToSelectableFields

func ServiceToSelectableFields(service *api.Service) fields.Set

Types

type ProxyREST

type ProxyREST struct {
	ServiceRest    *REST
	ProxyTransport http.RoundTripper
}

ProxyREST implements the proxy subresource for a Service

func (*ProxyREST) Connect

func (r *ProxyREST) Connect(ctx api.Context, id string, opts runtime.Object, responder rest.Responder) (http.Handler, error)

Connect returns a handler for the service proxy

func (*ProxyREST) ConnectMethods

func (r *ProxyREST) ConnectMethods() []string

ConnectMethods returns the list of HTTP methods that can be proxied

func (*ProxyREST) New

func (r *ProxyREST) New() runtime.Object

New returns an empty service resource

func (*ProxyREST) NewConnectOptions

func (r *ProxyREST) NewConnectOptions() (runtime.Object, bool, string)

NewConnectOptions returns versioned resource that represents proxy parameters

type REST

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

REST adapts a service registry into apiserver's RESTStorage model.

func (*REST) Create

func (rs *REST) Create(ctx api.Context, obj runtime.Object) (runtime.Object, error)

func (*REST) Delete

func (rs *REST) Delete(ctx api.Context, id string) (runtime.Object, error)

func (*REST) Export

func (rs *REST) Export(ctx api.Context, name string, opts unversioned.ExportOptions) (runtime.Object, error)

Export returns Service stripped of cluster-specific information. It implements rest.Exporter.

func (*REST) Get

func (rs *REST) Get(ctx api.Context, id string) (runtime.Object, error)

func (*REST) List

func (rs *REST) List(ctx api.Context, options *api.ListOptions) (runtime.Object, error)

func (*REST) New

func (*REST) New() runtime.Object

func (*REST) NewList

func (*REST) NewList() runtime.Object

func (*REST) ResourceLocation

func (rs *REST) ResourceLocation(ctx api.Context, id string) (*url.URL, http.RoundTripper, error)

ResourceLocation returns a URL to which one can send traffic for the specified service.

func (*REST) Update

func (rs *REST) Update(ctx api.Context, name string, objInfo rest.UpdatedObjectInfo) (runtime.Object, bool, error)

func (*REST) Watch

func (rs *REST) Watch(ctx api.Context, options *api.ListOptions) (watch.Interface, error)

Watch returns Services events via a watch.Interface. It implements rest.Watcher.

type RangeRegistry

type RangeRegistry interface {
	// Get returns the latest allocation, an empty object if no allocation has been made,
	// or an error if the allocation could not be retrieved.
	Get() (*api.RangeAllocation, error)
	// CreateOrUpdate should create or update the provide allocation, unless a conflict
	// has occurred since the item was last created.
	CreateOrUpdate(*api.RangeAllocation) error
}

TODO: Move to a general location (as other components may need allocation in future; it's not service specific) RangeRegistry is a registry that can retrieve or persist a RangeAllocation object.

type Registry

type Registry interface {
	ListServices(ctx api.Context, options *api.ListOptions) (*api.ServiceList, error)
	CreateService(ctx api.Context, svc *api.Service) (*api.Service, error)
	GetService(ctx api.Context, name string) (*api.Service, error)
	DeleteService(ctx api.Context, name string) error
	UpdateService(ctx api.Context, svc *api.Service) (*api.Service, error)
	WatchServices(ctx api.Context, options *api.ListOptions) (watch.Interface, error)
	ExportService(ctx api.Context, name string, options unversioned.ExportOptions) (*api.Service, error)
}

Registry is an interface for things that know how to store services.

func NewRegistry

func NewRegistry(s rest.StandardStorage) Registry

NewRegistry returns a new Registry interface for the given Storage. Any mismatched types will panic.

type ServiceRest

type ServiceRest struct {
	Service *REST
	Proxy   *ProxyREST
}

ServiceRest includes storage for services and all sub resources

func NewStorage

func NewStorage(registry Registry, endpoints endpoint.Registry, serviceIPs ipallocator.Interface,
	serviceNodePorts portallocator.Interface, proxyTransport http.RoundTripper) *ServiceRest

NewStorage returns a new REST.