Golang (proto)

This extension has the qualified name envoy.router.cluster_specifier_plugin.golang

Note

This extension is only available in contrib images.

Note

This extension is functional but has not had substantial production burn time, use only with this caveat.

This extension is not hardened and should only be used in deployments where both the downstream and upstream are trusted.

Tip

This extension extends and can be used with the following extension category:

• envoy.router.cluster_specifier_plugin

Warning

This API feature is currently work-in-progress. API features marked as work-in-progress are not considered stable, are not covered by the threat model, are not supported by the security team, and are subject to breaking changes. Do not use this feature without understanding each of the previous points.

For an overview of the Golang cluster specifier please see the configuration reference documentation.

extensions.router.cluster_specifier.golang.v3alpha.Config

[extensions.router.cluster_specifier.golang.v3alpha.Config proto]

Tip

This extension category has the following known extensions:

• envoy.router.cluster_specifier_plugin.lua

The following extensions are available in contrib images only:

• envoy.router.cluster_specifier_plugin.golang

{
  "library_id": ...,
  "library_path": ...,
  "default_cluster": ...,
  "config": {...}
}

library_id

(string, REQUIRED) Globally unique ID for a dynamic library file.

library_path

(string, REQUIRED) Path to a dynamic library implementing the ClusterSpecifier API interface.

default_cluster

(string, REQUIRED) Default cluster.

It will be used when the specifier interface return empty string or panic.

config

(Any) Configuration for the Go cluster specifier plugin.

Note

This configuration is only parsed in the go cluster specifier, and is therefore not validated by Envoy.

See the StreamFilter API for more information about how the plugin’s configuration data can be accessed.