discovery

Documentation

Overview

Package discovery implements configuration discovery.

Index

• Constants
• func Factories(fs map[string]plugins.Factory) func(*Discovery)
• func Metrics(m metrics.Metrics) func(*Discovery)
• type Config
  • func ParseConfig(bs []byte, services []string) (*Config, error)
• type Discovery
  • func New(manager *plugins.Manager, opts ...func(*Discovery)) (*Discovery, error)
  • func (c *Discovery) Reconfigure(_ context.Context, _ interface{})
  • func (c *Discovery) Start(ctx context.Context) error
  • func (c *Discovery) Stop(ctx context.Context)

Constants

const Name = "discovery"

Name is the discovery plugin name that will be registered with the plugin manager.

Functions

func Factories

func Factories(fs map[string]plugins.Factory) func(*Discovery)

Factories provides a set of factory functions to use for instantiating custom plugins.

func Metrics

func Metrics(m metrics.Metrics) func(*Discovery)

Metrics provides a metrics provider to pass to plugins.

Types

type Config

type Config struct {
	download.Config         // bundle downloader configuration
	Name            *string `json:"name"`               // name of the discovery bundle
	Prefix          *string `json:"prefix,omitempty"`   // Deprecated: use `Resource` instead.
	Decision        *string `json:"decision"`           // the name of the query to run on the bundle to get the config
	Service         string  `json:"service"`            // the name of the service used to download discovery bundle from
	Resource        *string `json:"resource,omitempty"` // the resource path which will be downloaded from the service
	// contains filtered or unexported fields
}

Config represents the configuration for the discovery feature.

func ParseConfig

func ParseConfig(bs []byte, services []string) (*Config, error)

ParseConfig returns a valid Config object with defaults injected.

type Discovery

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

Discovery implements configuration discovery for OPA. When discovery is started it will periodically download a configuration bundle and try to reconfigure the OPA.

func New

func New(manager *plugins.Manager, opts ...func(*Discovery)) (*Discovery, error)

New returns a new discovery plugin.

func (*Discovery) Reconfigure

func (c *Discovery) Reconfigure(_ context.Context, _ interface{})

Reconfigure is a no-op on discovery.

func (*Discovery) Start

func (c *Discovery) Start(ctx context.Context) error

Start starts the dynamic discovery process if configured.

func (*Discovery) Stop

func (c *Discovery) Stop(ctx context.Context)

Stop stops the dynamic discovery process if configured.