Kubernetes Env

The kubernetesenv adapter extracts information from a Kubernetes environmentand produces attributes that can be used in downstream adapters.

This adapter supports the kubernetes template.

Params

Configuration parameters for the kubernetes adapter. These paramscontrol the manner in which the kubernetes adapter discovers andgenerates values related to pod information.

The adapter works by looking up pod information by UIDs (of theform: “kubernetes://pod.namespace”). It expects that the UIDs will besupplied in an input map for three distinct traffic classes (source,destination, and origin).

For all valid UIDs supplied, this adapter generates outputvalues containing information about the related pods.

FieldTypeDescriptionRequired
kubeconfigPathstring
File path to discover kubeconfig. For in-cluster configuration,this should be left unset. For local configuration, this shouldbe set to the path of a kubeconfig file that can be used toreach a kubernetes API server.

NOTE: The kubernetesenv adapter will use the value of the KUBECONFIG environment variablein the case where it is set (overriding any value configuredthrough this proto).

Default: “” (unset)
No
cacheRefreshDurationDuration
Controls the resync period of the Kubernetes cluster info cache.The cache will watch for events and every so often completely resync.This controls how frequently the complete resync occurs.

Default: 5 minutes
No
clusterRegistriesNamespacestring
Namespace of the secret created for multicluster support.

Details on multicluster and the Kubernetes secret required toaccess the remote cluster’s credentials can be found inmulticluster install.

NOTE: If cluster_registries_namespace is not set then the environmentvariable POD_NAMESPACE is checked/used. If POD_NAMESPACE is notset then cluster_registries_namespace defaults to “istio-system”.

Default: “istio-system”
No