rtc

Documentation

Overview

Package rtc implements runtime-configurator (RTC) based targets.

Index

• type Targets
  • func New(pb *configpb.TargetsConf, localProject string, l *logger.Logger) (*Targets, error)
  • func (t *Targets) List() []string
  • func (t *Targets) Resolve(name string, ipVer int) (net.IP, error)

Types

type Targets

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

Targets implements the lister interface to provide RTC based target listing. Provides a means of listing targets stored in a Runtime Configuration value set. For information on how the RTC API works, see https://cloud.google.com/deployment-manager/runtime-configurator/reference/rest/

Each variable in RTC is a key/val pair. When listing targets, we assume the variables in the rtcservice.Config are laid out as <Hostname : RtcTargetInfo> where RtcTargetInfo is a base64 encoded RtcTargetInfo protobuf. The hostnames are listed, with one of their addresses assigned as a solve address. If groupTag is empty, no filtering by groupTag occurs. Otherwise, only variables with a group_tag matching an element of groupTag will be listed.

Note that this only provides a means to list targets stored in an RTC config. It does not provide means to maintain this list. When listing, however, Targets will ignore sufficiently old RTC entries, as configured by "exp_msec" in the TargetsConf protobuf.

func New

func New(pb *configpb.TargetsConf, localProject string, l *logger.Logger) (*Targets, error)

New returns an rtc resolver / lister, given a defining protobuf.

func (*Targets) List

func (t *Targets) List() []string

List produces a list of targets found in the RTC configuration for this project. It ignores all sufficiently old RTC entries, as configured by "exp_msec" in the TargetsConf protobuf. Then entries will be filtered by group names, if "groups" was non-empty. If there is an empty intersection between "groups" and the groups in RtcTargetInfo, the entry will be filtered out.

func (*Targets) Resolve

func (t *Targets) Resolve(name string, ipVer int) (net.IP, error)

Resolve returns the address that was associated with a given hostname. ipVer is currently ignored.