lameduck

Documentation

Overview

Package lameduck implements a lameducks provider. Lameduck provider fetches lameducks from the RTC (Runtime Configurator) service. This functionality allows an operator to do hitless VM upgrades. If a target is set to be in lameduck by the operator, it is taken out of the targets list.

Index

• func InitDefaultLister(optsProto *configpb.Options, lister Lister, l *logger.Logger) error
• type Lister
  • func GetDefaultLister() (Lister, error)
• type Service
  • func NewService(optsProto *configpb.Options, c *http.Client, l *logger.Logger) (*Service, error)
  • func (ldSvc *Service) Lameduck(name string) error
  • func (ldSvc *Service) List() ([]string, error)
  • func (ldSvc *Service) Unlameduck(name string) error

Functions

func InitDefaultLister

func InitDefaultLister(optsProto *configpb.Options, lister Lister, l *logger.Logger) error

InitDefaultLister initializes the package using the given arguments. If a lister is given in the arguments, global.lister is set to that, otherwise a new lameduck service is created using the config options, and global.lister is set to that service. Initiating the package from a given lister is useful for testing pacakges that depend on this package.

Types

type Lister

type Lister interface {
	List() ([]string, error)
}

Lister is an interface for getting current lameducks.

func GetDefaultLister

func GetDefaultLister() (Lister, error)

GetDefaultLister returns the global Lister. If global lister is uninitialized, it returns an error.

type Service

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

Service provides methods to do lameduck operations on VMs.

func NewService

func NewService(optsProto *configpb.Options, c *http.Client, l *logger.Logger) (*Service, error)

NewService creates a new lameduck Service using the provided config options and an oauth2 enabled *http.Client; if the client is set to nil, an oauth enabled client is created automatically using GCP default credentials.

func (*Service) Lameduck

func (ldSvc *Service) Lameduck(name string) error

Lameduck puts the target in lameduck mode.

func (*Service) List

func (ldSvc *Service) List() ([]string, error)

List returns the targets that are in lameduck mode.

func (*Service) Unlameduck

func (ldSvc *Service) Unlameduck(name string) error

Unlameduck removes the target from lameduck mode.