envoy

Documentation

Index

• Constants
• func CurrentVersion(homeDir string) (v version.Version, source string, err error)
• func InstallIfNeeded(ctx context.Context, o *globals.GlobalOpts) (string, error)
• func NewGetVersions(envoyVersionsURL string, p version.Platform, v string) version.GetReleaseVersions
• func VersionUsageList() string
• func WriteCurrentVersion(v version.Version, homeDir string) error
• type Runtime
  • func NewRuntime(opts *globals.RunOpts) *Runtime
  • func (r *Runtime) GetAdminAddress() (string, error)
  • func (r *Runtime) GetRunDir() string
  • func (r *Runtime) RegisterShutdownHook(f func(context.Context) error)
  • func (r *Runtime) Run(ctx context.Context, args []string) error
  • func (r *Runtime) String() string

Constants

const (

	// CurrentVersionWorkingDirFile is used for stable "versions" and "help" output
	CurrentVersionWorkingDirFile = "$PWD/.envoy-version"
	// CurrentVersionHomeDirFile is used for stable "versions" and "help" output
	CurrentVersionHomeDirFile = "$FUNC_E_HOME/version"
)

Functions

func CurrentVersion

func CurrentVersion(homeDir string) (v version.Version, source string, err error)

CurrentVersion returns the first version in priority of VersionUsageList and its source or an error. The "source" and error messages returned include unexpanded variables to clarify the intended context. In the case no version was found, the version returned will be nil, not an error.

func InstallIfNeeded

func InstallIfNeeded(ctx context.Context, o *globals.GlobalOpts) (string, error)

InstallIfNeeded downloads an Envoy binary corresponding to globals.GlobalOpts and returns a path to it or an error.

func NewGetVersions

func NewGetVersions(envoyVersionsURL string, p version.Platform, v string) version.GetReleaseVersions

NewGetVersions creates a new Envoy versions fetcher. TODO: validate the data before returning it!

func VersionUsageList

func VersionUsageList() string

VersionUsageList is the priority order of Envoy version sources. This includes unresolved variables as it is both used statically for markdown generation, and also at runtime.

func WriteCurrentVersion

func WriteCurrentVersion(v version.Version, homeDir string) error

WriteCurrentVersion writes the version to CurrentVersionWorkingDirFile or CurrentVersionHomeDirFile depending on if the former is present.

Types

type Runtime

type Runtime struct {
	Out, Err         io.Writer
	OutFile, ErrFile *os.File

	// FakeInterrupt is exposed for unit tests to pretend "func-e run" received a Ctrl+C or Ctrl+Break.
	// End-to-end tests should kill the func-e process to achieve the same.
	FakeInterrupt context.CancelFunc
	// contains filtered or unexported fields
}

Runtime manages an Envoy lifecycle

func NewRuntime

func NewRuntime(opts *globals.RunOpts) *Runtime

NewRuntime creates a new Runtime that runs envoy in globals.RunOpts RunDir opts allows a user running envoy to control the working directory by ID or path, allowing explicit cleanup.

func (*Runtime) GetAdminAddress

func (r *Runtime) GetAdminAddress() (string, error)

GetAdminAddress returns the current admin address in host:port format, or empty if not yet available. Exported for shutdown.enableEnvoyAdminDataCollection, which is always on due to shutdown.EnableHooks.

func (*Runtime) GetRunDir

func (r *Runtime) GetRunDir() string

GetRunDir returns the run-specific directory files can be written to.

func (*Runtime) RegisterShutdownHook

func (r *Runtime) RegisterShutdownHook(f func(context.Context) error)

RegisterShutdownHook registers the passed functions to be run after Envoy has started and just before func-e instructs Envoy to exit

func (*Runtime) Run

func (r *Runtime) Run(ctx context.Context, args []string) error

Run execs the binary at the path with the args passed. It is a blocking function that can be shutdown via SIGINT.

func (*Runtime) String

func (r *Runtime) String() string

String is only used in tests. It is slow, but helps when debugging CI failures