mirror of https://github.com/istio/istio.io.git
102 lines
3.4 KiB
HTML
102 lines
3.4 KiB
HTML
---
|
|
WARNING: THIS IS AN AUTO-GENERATED FILE, DO NOT EDIT. PLEASE MODIFY THE ORIGINAL SOURCE IN THE 'https://github.com/istio/istio' REPO
|
|
source_repo: https://github.com/istio/istio
|
|
title: Kubernetes Env
|
|
description: Adapter that extracts information from a Kubernetes environment.
|
|
location: https://istio.io/docs/reference/config/policy-and-telemetry/adapters/kubernetesenv.html
|
|
layout: protoc-gen-docs
|
|
generator: protoc-gen-docs
|
|
supported_templates: kubernetes
|
|
aliases:
|
|
- /docs/reference/config/adapters/kubernetesenv.html
|
|
number_of_entries: 1
|
|
---
|
|
<p>The <code>kubernetesenv</code> adapter extracts information from a Kubernetes environment
|
|
and produces attributes that can be used in downstream adapters.</p>
|
|
|
|
<p>This adapter supports the <a href="/docs/reference/config/policy-and-telemetry/templates/kubernetes/">kubernetes template</a>.</p>
|
|
|
|
<h2 id="Params">Params</h2>
|
|
<section>
|
|
<p>Configuration parameters for the kubernetes adapter. These params
|
|
control the manner in which the kubernetes adapter discovers and
|
|
generates values related to pod information.</p>
|
|
|
|
<p>The adapter works by looking up pod information by UIDs (of the
|
|
form: “kubernetes://pod.namespace”). It expects that the UIDs will be
|
|
supplied in an input map for three distinct traffic classes (source,
|
|
destination, and origin).</p>
|
|
|
|
<p>For all valid UIDs supplied, this adapter generates output
|
|
values containing information about the related pods.</p>
|
|
|
|
<table class="message-fields">
|
|
<thead>
|
|
<tr>
|
|
<th>Field</th>
|
|
<th>Type</th>
|
|
<th>Description</th>
|
|
<th>Required</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr id="Params-kubeconfig_path">
|
|
<td><code>kubeconfigPath</code></td>
|
|
<td><code>string</code></td>
|
|
<td>
|
|
<p>File path to discover <code>kubeconfig</code>. For in-cluster configuration,
|
|
this should be left unset. For local configuration, this should
|
|
be set to the path of a <code>kubeconfig</code> file that can be used to
|
|
reach a kubernetes API server.</p>
|
|
|
|
<p>NOTE: The <code>kubernetesenv</code> adapter will use the value of the <code>KUBECONFIG</code> environment variable
|
|
in the case where it is set (overriding any value configured
|
|
through this proto).</p>
|
|
|
|
<p>Default: “” (unset)</p>
|
|
|
|
</td>
|
|
<td>
|
|
No
|
|
</td>
|
|
</tr>
|
|
<tr id="Params-cache_refresh_duration">
|
|
<td><code>cacheRefreshDuration</code></td>
|
|
<td><code><a href="https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration">google.protobuf.Duration</a></code></td>
|
|
<td>
|
|
<p>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.</p>
|
|
|
|
<p>Default: 5 minutes</p>
|
|
|
|
</td>
|
|
<td>
|
|
No
|
|
</td>
|
|
</tr>
|
|
<tr id="Params-cluster_registries_namespace">
|
|
<td><code>clusterRegistriesNamespace</code></td>
|
|
<td><code>string</code></td>
|
|
<td>
|
|
<p>Namespace of the secret created for multicluster support.</p>
|
|
|
|
<p>Details on multicluster and the Kubernetes secret required to
|
|
access the remote cluster’s credentials can be found in
|
|
<a href="/docs/setup/install/multicluster/">multicluster install</a>.</p>
|
|
|
|
<p>NOTE: If <code>cluster_registries_namespace</code> is not set then the environment
|
|
variable <code>POD_NAMESPACE</code> is checked/used. If <code>POD_NAMESPACE</code> is not
|
|
set then <code>cluster_registries_namespace</code> defaults to “istio-system”.</p>
|
|
|
|
<p>Default: “istio-system”</p>
|
|
|
|
</td>
|
|
<td>
|
|
No
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</section>
|