transformation

Documentation

Index

• Constants
• Variables
• func NewInvalidSpanTransformerError(message string) error
• func TranslateTransformation(glooTransform *transformation.Transformation, ...) (*envoytransformation.Transformation, error)
• type ExtractorError
  • func NewExtractorError(message, name string, mode transformation.Extraction_Mode) *ExtractorError
  • func (e *ExtractorError) Error() string
• type Plugin
  • func NewPlugin() *Plugin
  • func (p *Plugin) ConvertTransformation(ctx context.Context, t *transformation.Transformations, ...) (*envoytransformation.RouteTransformations, error)
  • func (p *Plugin) HttpFilters(params plugins.Params, listener *v1.HttpListener) ([]plugins.StagedHttpFilter, error)
  • func (p *Plugin) Init(params plugins.InitParams)
  • func (p *Plugin) Name() string
  • func (p *Plugin) ProcessRoute(params plugins.RouteParams, in *v1.Route, out *envoy_config_route_v3.Route) error
  • func (p *Plugin) ProcessVirtualHost(params plugins.VirtualHostParams, in *v1.VirtualHost, ...) error
  • func (p *Plugin) ProcessWeightedDestination(params plugins.RouteActionParams, in *v1.WeightedDestination, ...) error
  • func (p *Plugin) UpstreamHttpFilters(params plugins.Params, listener *v1.HttpListener) ([]plugins.StagedUpstreamHttpFilter, error)
• type TranslateTransformationFn

Constants

const (
	ExtensionName      = "transformation"
	FilterName         = "io.solo.transformation"
	WaitFilterName     = "io.solo.wait"
	RegularStageNumber = 0
	EarlyStageNumber   = 1
	AwsStageNumber     = 2
	PostRoutingNumber  = 3
)

const (
	ErrMsgReplacementTextSetWhenNotNeeded = "replacement text should not be set"
	ErrMsgReplacementTextNotSetWhenNeeded = "replacement text must be set"
	ErrMsgSubgroupSetWhenNotNeeded        = "subgroup should not be set"
)

Variables

var (
	UnknownTransformationType = func(transformation interface{}) error {
		return fmt.Errorf("unknown transformation type %T", transformation)
	}
)

Functions

func NewInvalidSpanTransformerError

func NewInvalidSpanTransformerError(message string) error

func TranslateTransformation

func TranslateTransformation(glooTransform *transformation.Transformation,
	settingsEscapeCharacters *wrapperspb.BoolValue,
	stagedEscapeCharacters *wrapperspb.BoolValue) (*envoytransformation.Transformation, error)

Types

type ExtractorError

type ExtractorError struct {
	Message string // The error message
	Name    string // The name of the extractor causing the error
	Mode    string // (optional) The (stringified) mode of the extractor causing the error
}

ExtractorError represents an error related to extractor configuration.

func NewExtractorError

func NewExtractorError(message, name string, mode transformation.Extraction_Mode) *ExtractorError

Helper functions to create specific ExtractorError instances.

func (*ExtractorError) Error

func (e *ExtractorError) Error() string

implements the error interface for ExtractorError.

type Plugin

type Plugin struct {
	RequireEarlyTransformation bool
	TranslateTransformation    TranslateTransformationFn
	// contains filtered or unexported fields
}

This Plugin is exported only because it is utilized by the enterprise implementation We would prefer if the plugin were not exported and instead the required translation methods were exported.

func NewPlugin

func NewPlugin() *Plugin

func (*Plugin) ConvertTransformation

func (p *Plugin) ConvertTransformation(
	ctx context.Context,
	t *transformation.Transformations,
	stagedTransformations *transformation.TransformationStages,
) (*envoytransformation.RouteTransformations, error)

func (*Plugin) HttpFilters

func (p *Plugin) HttpFilters(params plugins.Params, listener *v1.HttpListener) ([]plugins.StagedHttpFilter, error)

HttpFilters emits the desired set of filters. Either 0, 1 or if earlytransformation is needed then 2 staged filters

func (*Plugin) Init

func (p *Plugin) Init(params plugins.InitParams)

Init attempts to set the plugin back to a clean slate state.

func (*Plugin) Name

func (p *Plugin) Name() string

func (*Plugin) ProcessRoute

func (p *Plugin) ProcessRoute(params plugins.RouteParams, in *v1.Route, out *envoy_config_route_v3.Route) error

func (*Plugin) ProcessVirtualHost

func (p *Plugin) ProcessVirtualHost(
	params plugins.VirtualHostParams,
	in *v1.VirtualHost,
	out *envoy_config_route_v3.VirtualHost,
) error

func (*Plugin) ProcessWeightedDestination

func (p *Plugin) ProcessWeightedDestination(
	params plugins.RouteActionParams,
	in *v1.WeightedDestination,
	out *envoy_config_route_v3.WeightedCluster_ClusterWeight,
) error

func (*Plugin) UpstreamHttpFilters

func (p *Plugin) UpstreamHttpFilters(params plugins.Params, listener *v1.HttpListener) ([]plugins.StagedUpstreamHttpFilter, error)

type TranslateTransformationFn

type TranslateTransformationFn func(*transformation.Transformation, *wrapperspb.BoolValue, *wrapperspb.BoolValue) (*envoytransformation.Transformation, error)