mirror of https://github.com/istio/istio.io.git
224 lines
109 KiB
HTML
224 lines
109 KiB
HTML
<!doctype html><html lang=zh itemscope itemtype=https://schema.org/WebPage><head><meta charset=utf-8><meta http-equiv=x-ua-compatible content="IE=edge"><meta name=viewport content="width=device-width,initial-scale=1,shrink-to-fit=no"><meta name=theme-color content="#466BB0"><meta name=title content="Mixer Client"><meta name=description content="Configuration state for the Mixer client library."><meta name=keywords content="microservices,services,mesh"><meta property="og:title" content="Mixer Client"><meta property="og:type" content="website"><meta property="og:description" content="Configuration state for the Mixer client library."><meta property="og:url" content="/v1.12/zh/docs/reference/config/policy-and-telemetry/istio.mixer.v1.config.client/"><meta property="og:image" content="https://raw.githubusercontent.com/istio/istio.io/master/static/img/istio-whitelogo-bluebackground-framed.svg"><meta property="og:image:alt" content="Istio Logo"><meta property="og:image:width" content="1024"><meta property="og:image:height" content="1024"><meta property="og:site_name" content="Istio"><meta name=twitter:card content="summary"><meta name=twitter:site content="@IstioMesh"><title>Istioldie 1.12 / Mixer Client</title><script async src="https://www.googletagmanager.com/gtag/js?id=UA-98480406-2"></script><script>window.dataLayer=window.dataLayer||[];function gtag(){dataLayer.push(arguments);}
|
||
gtag('js',new Date());gtag('config','UA-98480406-2');</script><link rel=alternate type=application/rss+xml title="Istio Blog" href=/v1.12/blog/feed.xml><link rel=alternate type=application/rss+xml title="Istio News" href=/v1.12/news/feed.xml><link rel=alternate type=application/rss+xml title="Istio Blog and News" href=/v1.12/feed.xml><link rel="shortcut icon" href=/v1.12/favicons/favicon.ico><link rel=apple-touch-icon href=/v1.12/favicons/apple-touch-icon-180x180.png sizes=180x180><link rel=icon type=image/png href=/v1.12/favicons/favicon-16x16.png sizes=16x16><link rel=icon type=image/png href=/v1.12/favicons/favicon-32x32.png sizes=32x32><link rel=icon type=image/png href=/v1.12/favicons/android-36x36.png sizes=36x36><link rel=icon type=image/png href=/v1.12/favicons/android-48x48.png sizes=48x48><link rel=icon type=image/png href=/v1.12/favicons/android-72x72.png sizes=72x72><link rel=icon type=image/png href=/v1.12/favicons/android-96x96.png sizes=96xW96><link rel=icon type=image/png href=/v1.12/favicons/android-144x144.png sizes=144x144><link rel=icon type=image/png href=/v1.12/favicons/android-192x192.png sizes=192x192><link rel=mask-icon href=/v1.12/favicons/safari-pinned-tab.svg color=#466bb0><link rel=manifest href=/v1.12/manifest.json><meta name=apple-mobile-web-app-title content="Istio"><meta name=application-name content="Istio"><meta name=msapplication-config content="/browserconfig.xml"><meta name=msapplication-TileColor content="#466BB0"><meta name=theme-color content="#466BB0"><link rel=stylesheet href=/v1.12/css/all.css><link rel=preconnect href=https://fonts.gstatic.com><link rel=stylesheet href="https://fonts.googleapis.com/css2?family=Barlow:ital,wght@0,400;0,500;0,600;0,700;1,400;1,600&display=swap"><script src=/v1.12/js/themes_init.min.js></script></head><body class="language-unknown archive-site"><script>const branchName="release-1.12";const docTitle="Mixer Client";const iconFile="\/v1.12/img/icons.svg";const buttonCopy='复制到剪切板';const buttonPrint='打印';const buttonDownload='下载';</script><script src="https://www.google.com/cse/brand?form=search-form" defer></script><script src=/v1.12/js/all.min.js data-manual defer></script><header class=main-navigation><nav class="main-navigation-wrapper container-l"><div class=main-navigation-header><a id=brand href=/v1.12/zh/><span class=logo><svg xmlns="http://www.w3.org/2000/svg" width="128" height="60" viewBox="0 0 128 60"><path d="M58.434 48.823A.441.441.0 0158.3 48.497V22.583a.444.444.0 01.134-.326.446.446.0 01.327-.134h3.527a.447.447.0 01.325.134.447.447.0 01.134.326v25.914a.443.443.0 01-.134.326.444.444.0 01-.325.134h-3.527a.444.444.0 01-.327-.134z"/><path d="m70.969 48.477a6.556 6.556.0 01-2.818-1.955 4.338 4.338.0 01-1-2.78v-.345a.443.443.0 01.134-.326.444.444.0 01.326-.135h3.374a.444.444.0 01.326.135.445.445.0 01.134.326v.077a2.014 2.014.0 001.054 1.667 4.672 4.672.0 002.664.709 4.446 4.446.0 002.492-.633 1.862 1.862.0 00.958-1.591 1.426 1.426.0 00-.786-1.322 12.7 12.7.0 00-2.549-.939l-1.457-.46a21.526 21.526.0 01-3.3-1.227 6.57 6.57.0 01-2.262-1.783 4.435 4.435.0 01-.92-2.894 5.081 5.081.0 012.109-4.275 8.993 8.993.0 015.558-1.591 10.445 10.445.0 014.1.748 6.3 6.3.0 012.722 2.07 5 5 0 01.958 3.009.441.441.0 01-.134.326.441.441.0 01-.325.134h-3.258a.441.441.0 01-.326-.134.443.443.0 01-.134-.326 1.974 1.974.0 00-.978-1.667 4.647 4.647.0 00-2.665-.671 4.741 4.741.0 00-2.435.556 1.724 1.724.0 00-.938 1.553 1.512 1.512.0 00.9 1.4 15.875 15.875.0 003.01 1.055l.843.229a27.368 27.368.0 013.412 1.246 6.67 6.67.0 012.338 1.763 4.387 4.387.0 01.958 2.933 4.988 4.988.0 01-2.146 4.275 9.543 9.543.0 01-5.712 1.552 11.626 11.626.0 01-4.227-.709z"/><path d="m97.039 32.837a.443.443.0 01-.326.135h-3.911a.169.169.0 00-.191.192v9.239a2.951 2.951.0 00.632 2.108 2.7 2.7.0 002.013.652h1.15a.444.444.0 01.325.134.441.441.0 01.134.326v2.875a.471.471.0 01-.459.5l-1.994.039a8 8 0 01-4.524-1.035q-1.495-1.035-1.533-3.91V33.166A.17.17.0 0088.164 32.974H85.978A.441.441.0 0185.652 32.839.441.441.0 0185.518 32.513V29.83a.441.441.0 01.134-.326.444.444.0 01.326-.135h2.186a.169.169.0 00.191-.192v-4.485a.438.438.0 01.134-.326.44.44.0 01.325-.134h3.336a.443.443.0 01.325.134.442.442.0 01.135.326v4.485a.169.169.0 00.191.192h3.911a.446.446.0 01.326.135.446.446.0 01.134.326v2.683a.446.446.0 01-.133.324z"/><path d="m101.694 25.917a2.645 2.645.0 01-.767-1.955 2.65 2.65.0 01.767-1.955 2.65 2.65.0 011.955-.767 2.65 2.65.0 011.955.767 2.652 2.652.0 01.767 1.955 2.647 2.647.0 01-.767 1.955 2.646 2.646.0 01-1.955.767 2.645 2.645.0 01-1.955-.767zm-.211 22.906a.441.441.0 01-.134-.326V29.79a.444.444.0 01.134-.326.446.446.0 01.326-.134h3.527a.446.446.0 01.326.134.445.445.0 01.134.326v18.707a.443.443.0 01-.134.326.443.443.0 01-.326.134h-3.527a.443.443.0 01-.326-.134z"/><path d="m114.019 47.734a8.1 8.1.0 01-3.047-4.255 14.439 14.439.0 01-.652-4.37 14.3 14.3.0 01.614-4.371 7.869 7.869.0 013.066-4.178 9.072 9.072.0 015.252-1.5 8.543 8.543.0 015.041 1.5 7.985 7.985.0 013.009 4.14 12.439 12.439.0 01.69 4.37 13.793 13.793.0 01-.651 4.37 8.255 8.255.0 01-3.028 4.275 8.475 8.475.0 01-5.1 1.553 8.754 8.754.0 01-5.194-1.534zm7.629-3.1a4.536 4.536.0 001.476-2.262 11.335 11.335.0 00.383-3.221 10.618 10.618.0 00-.383-3.22 4.169 4.169.0 00-1.457-2.243 4.066 4.066.0 00-2.531-.785 3.942 3.942.0 00-2.453.785 4.376 4.376.0 00-1.5 2.243 11.839 11.839.0 00-.383 3.22 11.84 11.84.0 00.383 3.221 4.222 4.222.0 001.476 2.262 4.075 4.075.0 002.549.8 3.8 3.8.0 002.44-.809z"/><path d="m15.105 32.057v15.565a.059.059.0 01-.049.059L.069 50.25A.06.06.0 01.005 50.167l14.987-33.47a.06.06.0 01.114.025z"/><path d="m17.631 23.087v24.6a.06.06.0 00.053.059l22.449 2.507a.06.06.0 00.061-.084L17.745.032a.06.06.0 00-.114.024z"/><path d="m39.961 52.548-24.833 7.45a.062.062.0 01-.043.0L.079 52.548a.059.059.0 01.026-.113h39.839a.06.06.0 01.017.113z"/></svg></span></a><button id=hamburger class=main-navigation-toggle aria-label="Open navigation"><svg class="icon menu-hamburger"><use xlink:href="/v1.12/img/icons.svg#menu-hamburger"/></svg></button>
|
||
<button id=menu-close class=main-navigation-toggle aria-label="Close navigation"><svg class="icon menu-close"><use xlink:href="/v1.12/img/icons.svg#menu-close"/></svg></button></div><div id=header-links class=main-navigation-links-wrapper><ul class=main-navigation-links><li class=main-navigation-links-item><a class="main-navigation-links-link has-dropdown"><span>关于</span><svg class="icon dropdown-arrow"><use xlink:href="/v1.12/img/icons.svg#dropdown-arrow"/></svg></a><ul class=main-navigation-links-dropdown><li class=main-navigation-links-dropdown-item><a href=/v1.12/zh/about/service-mesh class=main-navigation-links-link>服务网格</a></li><li class=main-navigation-links-dropdown-item><a href=/v1.12/zh/about/solutions class=main-navigation-links-link>解决方案</a></li><li class=main-navigation-links-dropdown-item><a href=/v1.12/zh/about/case-studies class=main-navigation-links-link>案例学习</a></li><li class=main-navigation-links-dropdown-item><a href=/v1.12/zh/about/ecosystem class=main-navigation-links-link>生态系统</a></li><li class=main-navigation-links-dropdown-item><a href=/v1.12/zh/about/deployment class=main-navigation-links-link>部署</a></li><li class=main-navigation-links-dropdown-item><a href=/v1.12/zh/about/faq class=main-navigation-links-link>FAQ</a></li></ul></li><li class=main-navigation-links-item><a href=/v1.12/zh/blog/ class=main-navigation-links-link><span>博客</span></a></li><li class=main-navigation-links-item><a href=/v1.12/zh/news/ class=main-navigation-links-link><span>新闻</span></a></li><li class=main-navigation-links-item><a href=/v1.12/zh/get-involved/ class=main-navigation-links-link><span>加入我们</span></a></li><li class=main-navigation-links-item><a href=/v1.12/zh/docs/ class=main-navigation-links-link><span>文档</span></a></li></ul><div class=main-navigation-footer><button id=search-show class=search-show title="搜索 istio.io" aria-label=搜索><svg class="icon magnifier"><use xlink:href="/v1.12/img/icons.svg#magnifier"/></svg></button>
|
||
<a href=/v1.12/zh/docs/setup/getting-started class="btn btn--primary" id=try-istio>试用 Istio</a></div></div><form id=search-form class=search name=cse role=search><input type=hidden name=cx value=002184991200833970123:iwwf17ikgf4>
|
||
<input type=hidden name=ie value=utf-8>
|
||
<input type=hidden name=hl value=zh>
|
||
<input type=hidden id=search-page-url value=/zh/search>
|
||
<input id=search-textbox class="search-textbox form-control" name=q type=search aria-label="搜索 istio.io" placeholder=搜索>
|
||
<button id=search-close title=取消搜索 type=reset aria-label=取消搜索><svg class="icon menu-close"><use xlink:href="/v1.12/img/icons.svg#menu-close"/></svg></button></form></nav></header><div class=banner-container></div><main class="primary container has-sidebar has-toc docs"><div id=sidebar-container class=sidebar-container><nav id=sidebar aria-label="Section Navigation"><button id=sidebar-close class="main-navigation-toggle sidebar-close" aria-label="Close sidebar"><svg class="icon menu-close"><use xlink:href="/v1.12/img/icons.svg#menu-close"/></svg></button><div class=sidebar-nav><div class=search><form id=search-docs-form name=cse role=search><input type=hidden name=ie value=utf-8>
|
||
<input type=hidden name=hl value=en>
|
||
<input type=hidden id=search-docs-url value=/v1.12/search>
|
||
<input id=search-docs-textbox class=form-control name=docs-search type=search aria-label="搜索 istio.io" placeholder=搜索>
|
||
<button id=search-show2 class=search-show title="搜索 istio.io" aria-label=搜索><svg class="icon magnifier"><use xlink:href="/v1.12/img/icons.svg#magnifier"/></svg></button></form></div><div class=card><div class="body default" aria-labelledby=header0><ul role=tree aria-expanded=true aria-labelledby=header0><li role=treeitem aria-label=概念><a class=main title="一些概念，理解它们有助于您更好地了解 Istio 系统的不同部分及其使用的抽象。" href=/v1.12/zh/docs/concepts/>概念</a><ul role=group aria-expanded=true class=leaf-section><li role=none><a role=treeitem title="介绍 Istio，它要解决的问题，高层面的架构和设计目标。" href=/v1.12/zh/docs/concepts/what-is-istio/>Istio 是什么？</a></li><li role=none><a role=treeitem title="描述 Istio 多样的流量路由和控制特性。" href=/v1.12/zh/docs/concepts/traffic-management/>流量管理</a></li><li role=none><a role=treeitem title="讲述 Istio 的 WebAssembly 插件系统。" href=/v1.12/zh/docs/concepts/wasm/>扩展性</a></li><li role=none><a role=treeitem title="描述 Istio 的授权与认证功能。" href=/v1.12/zh/docs/concepts/security/>安全</a></li><li role=none><a role=treeitem title="描述 Istio 提供的遥测和监控特性。" href=/v1.12/zh/docs/concepts/observability/>可观察性</a></li></ul></li><li role=treeitem aria-label=安装><a class=main title="关于如何在 Kubernetes 集群中安装 Istio 控制平面和添加虚拟机到 mesh 中的说明。" href=/v1.12/zh/docs/setup/>安装</a><ul role=group aria-expanded=true><li role=none><a role=treeitem title="快速、轻松地尝试 Istio 特性。" href=/v1.12/zh/docs/setup/getting-started/>入门</a></li><li role=treeitem aria-label=平台安装><button aria-hidden=true></button><a title="在安装 Istio 之前如何准备各种 Kubernetes 平台。" href=/v1.12/zh/docs/setup/platform-setup/>平台安装</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="在阿里云 Kubernetes 集群进行配置以便安装运行 Istio。" href=/v1.12/zh/docs/setup/platform-setup/alicloud/>阿里云</a></li><li role=none><a role=treeitem title="为 Istio 设置一个 Azure 集群的指令。" href=/v1.12/zh/docs/setup/platform-setup/azure/>Azure</a></li><li role=none><a role=treeitem title="在 Docker Desktop 中运行 Istio 的设置说明。" href=/v1.12/zh/docs/setup/platform-setup/docker/>Docker Desktop</a></li><li role=none><a role=treeitem title="为 Istio 设置 kind 的说明。" href=/v1.12/zh/docs/setup/platform-setup/kind/>kind</a></li><li role=none><a role=treeitem title="在 Google Kubernetes Engine (GKE) 上快速搭建 Istio 服务。" href=/v1.12/zh/docs/setup/platform-setup/gke/>使用 Google Kubernetes Engine 快速开始</a></li><li role=none><a role=treeitem title="在 Minikube 上配置 Istio。" href=/v1.12/zh/docs/setup/platform-setup/minikube/>Minikube</a></li><li role=none><a role=treeitem title="在 IBM 公有云或私有云上快速搭建 Istio 服务。" href=/v1.12/zh/docs/setup/platform-setup/ibm/>IBM Cloud 快速开始</a></li><li role=none><a role=treeitem title="与Istio 一起使用的 Kops 设置说明。" href=/v1.12/zh/docs/setup/platform-setup/kops/>Kops</a></li><li role=none><a role=treeitem title="使用 Gardener 快速搭建 Istio 服务。" href=/v1.12/zh/docs/setup/platform-setup/gardener/>Kubernetes Gardener 快速开始</a></li><li role=none><a role=treeitem title="Istio 适配 KubeSphere 容器平台指南。" href=/v1.12/zh/docs/setup/platform-setup/kubesphere/>KubeSphere Container Platform</a></li><li role=none><a role=treeitem title="配置 MicroK8s 以便使用 Istio。" href=/v1.12/zh/docs/setup/platform-setup/microk8s/>MicroK8s</a></li><li role=none><a role=treeitem title="在 OpenShift 集群上快速搭建 Istio 服务。" href=/v1.12/zh/docs/setup/platform-setup/openshift/>OpenShift</a></li><li role=none><a role=treeitem title="为 Istio 配置 OKE 集群环境的说明。" href=/v1.12/zh/docs/setup/platform-setup/oci/>Oracle Cloud 基础架构</a></li><li role=none><a role=treeitem title="在腾讯云上快速创建 Istio 服务。" href=/v1.12/zh/docs/setup/platform-setup/tencent-cloud-mesh/>腾讯云</a></li></ul></li><li role=treeitem aria-label=安装><button aria-hidden=true></button><a title=选择最适合你需求和平台的安装指南。 href=/v1.12/zh/docs/setup/install/>安装</a><ul role=group aria-expanded=false><li role=none><a role=treeitem title="安装、定制 Istio 配置文件，用于深入评估、及生产发布。" href=/v1.12/zh/docs/setup/install/istioctl/>使用 Istioctl 安装</a></li><li role=none><a role=treeitem title="使用 Istio Operator 在 Kubernetes 集群中安装 Istio 的说明。" href=/v1.12/zh/docs/setup/install/operator/>使用 Istio Operator 安装</a></li><li role=none><a role=treeitem title="安装、配置、并深入评估 Istio。" href=/v1.12/zh/docs/setup/install/helm/>使用 Helm 安装</a></li><li role=none><a role=treeitem title="部署 Istio，接入虚拟机中运行的工作负载。" href=/v1.12/zh/docs/setup/install/virtual-machine/>虚拟机安装</a></li><li role=treeitem aria-label=多集群安装><button aria-hidden=true></button><a title="跨多 Kubernetes 集群，安装 Istio 服务网格。" href=/v1.12/zh/docs/setup/install/multicluster/>多集群安装</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="在多个集群上安装 Istio 之前的初始步骤。" href=/v1.12/zh/docs/setup/install/multicluster/before-you-begin/>准备工作</a></li><li role=none><a role=treeitem title="跨多个主集群，安装 Istio 网格。" href=/v1.12/zh/docs/setup/install/multicluster/multi-primary/>多主架构的安装</a></li><li role=none><a role=treeitem title="跨主-从集群，安装 Istio 网格。" href=/v1.12/zh/docs/setup/install/multicluster/primary-remote/>主-从架构的安装</a></li><li role=none><a role=treeitem title="跨网络、多主架构的 Istio 网格安装。" href=/v1.12/zh/docs/setup/install/multicluster/multi-primary_multi-network/>跨网络多主架构的安装</a></li><li role=none><a role=treeitem title="跨网络、主-从架构的 Istio 网格安装。" href=/v1.12/zh/docs/setup/install/multicluster/primary-remote_multi-network/>跨网络主-从架构的安装</a></li><li role=none><a role=treeitem title="验证 Istio 已成功安装到多集群环境中。" href=/v1.12/zh/docs/setup/install/multicluster/verify/>验证安装结果</a></li></ul></li></ul></li><li role=treeitem aria-label=Upgrade><button aria-hidden=true></button><a title="跨多个控制平面升级、降级和管理 Istio。" href=/v1.12/zh/docs/setup/upgrade/>Upgrade</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="通过先运行一个金丝雀部署的新控制平面升级 Istio。" href=/v1.12/zh/docs/setup/upgrade/canary/>金丝雀升级</a></li><li role=none><a role=treeitem title=热升级和回退。 href=/v1.12/zh/docs/setup/upgrade/in-place/>热升级</a></li><li role=none><a role=treeitem title="使用 istioctl 命令来升级或降级 Istio。" href=/v1.12/zh/docs/setup/upgrade/istioctl-upgrade/>使用 istioctl 命令升级 Istio [实验中]</a></li><li role=none><a role=treeitem title="升级 Istio 控制平面，可以选择使用 Helm 升级 CNI 插件。" href=/v1.12/zh/docs/setup/upgrade/cni-helm-upgrade/>使用 Helm 升级</a></li><li role=none><a role=treeitem title="使用 Gateway 配置和升级 Istio。 (Experimental)" href=/v1.12/zh/docs/setup/upgrade/gateways/>多版本的 Gateway 管理 *</a></li></ul></li><li role=treeitem aria-label=更多指南><button aria-hidden=true></button><a title=有关其他设置任务的更多信息。 href=/v1.12/zh/docs/setup/additional-setup/>更多指南</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="描述 Istio 内置的安装配置文件。" href=/v1.12/zh/docs/setup/additional-setup/config-profiles/>安装配置文件</a></li><li role=none><a role=treeitem title="在应用程序 Pod 中使用 Sidecar Injector Webhook 自动安装或使用 Istioctl CLI 手动安装 Istio Sidecar。" href=/v1.12/zh/docs/setup/additional-setup/sidecar-injection/>安装 Sidecar</a></li><li role=none><a role=treeitem title="安装并使用 Istio CNI 插件，可以让运维人员用更低的权限来部署服务。" href=/v1.12/zh/docs/setup/additional-setup/cni/>安装 Istio CNI 插件</a></li><li role=none><a role=treeitem title=安装外部控制平面和远程集群。 href=/v1.12/zh/docs/setup/additional-setup/external-controlplane/>使用外部控制平面安装 Istio</a></li></ul></li></ul></li><li role=treeitem aria-label=任务><a class=main title="如何用 Istio 实现单个特定的目标行为。" href=/v1.12/zh/docs/tasks/>任务</a><ul role=group aria-expanded=true><li role=treeitem aria-label=流量管理><button aria-hidden=true></button><a title="演示 Istio 的流量路由功能的任务。" href=/v1.12/zh/docs/tasks/traffic-management/>流量管理</a><ul role=group aria-expanded=false><li role=none><a role=treeitem title=如何将请求动态路由到微服务的多个版本。 href=/v1.12/zh/docs/tasks/traffic-management/request-routing/>配置请求路由</a></li><li role=none><a role=treeitem title=此任务说明如何注入故障并测试应用程序的弹性。 href=/v1.12/zh/docs/tasks/traffic-management/fault-injection/>故障注入</a></li><li role=none><a role=treeitem title=展示如何将流量从旧版本迁移到新版本的服务。 href=/v1.12/zh/docs/tasks/traffic-management/traffic-shifting/>流量转移</a></li><li role=none><a role=treeitem title="展示如何将一个服务的 TCP 流量从旧版本迁移到新版本。" href=/v1.12/zh/docs/tasks/traffic-management/tcp-traffic-shifting/>TCP 流量转移</a></li><li role=none><a role=treeitem title="本任务用于示范如何使用 Istio 在 Envoy 中设置请求超时。" href=/v1.12/zh/docs/tasks/traffic-management/request-timeouts/>设置请求超时</a></li><li role=none><a role=treeitem title=本任务展示如何为连接、请求以及异常检测配置熔断。 href=/v1.12/zh/docs/tasks/traffic-management/circuit-breaking/>熔断</a></li><li role=none><a role=treeitem title="此任务演示了 Istio 的流量镜像/影子功能。" href=/v1.12/zh/docs/tasks/traffic-management/mirroring/>镜像</a></li><li role=treeitem aria-label=地域负载均衡><button aria-hidden=true></button><a title="本系列任务演示如何在 Istio 中配置地域负载均衡。" href=/v1.12/zh/docs/tasks/traffic-management/locality-load-balancing/>地域负载均衡</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title=配置地域负载均衡前的初始化步骤。 href=/v1.12/zh/docs/tasks/traffic-management/locality-load-balancing/before-you-begin/>开始之前</a></li><li role=none><a role=treeitem title=本任务演示如何为网格配置地域故障转移。 href=/v1.12/zh/docs/tasks/traffic-management/locality-load-balancing/failover/>地域故障转移</a></li><li role=none><a role=treeitem title=本指南演示如何配置地域权重分配。 href=/v1.12/zh/docs/tasks/traffic-management/locality-load-balancing/distribute/>地域权重分布</a></li><li role=none><a role=treeitem title=地域负载均衡的清理步骤。 href=/v1.12/zh/docs/tasks/traffic-management/locality-load-balancing/cleanup/>清理</a></li></ul></li><li role=treeitem aria-label=Ingress><button aria-hidden=true></button><a title="控制 Istio 服务网格的入口流量。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/>Ingress</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="描述如何配置 Istio Gateway，以将服务暴露至服务网格之外。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/ingress-control/>Ingress Gateway</a></li><li role=none><a role=treeitem title="通过 TLS 或 mTLS 将服务公开到服务网格之外。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/secure-ingress/>Secure Gateways</a></li><li role=none><a role=treeitem title="使用文件挂载的证书并通过 TLS 或 mTLS 将服务暴露至服务网格之外。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/secure-ingress-mount/>安全网关（文件挂载）</a></li><li role=none><a role=treeitem title="使用 Secret 发现服务（SDS) 通过 TLS 或者 mTLS 把服务暴露给服务网格外部。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/secure-ingress-sds/>使用 SDS 为 Gateway 提供 HTTPS 加密支持</a></li><li role=none><a role=treeitem title="如何为一个 Ingress Gateway 配置 SNI 透传。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/ingress-sni-passthrough/>无 TLS 终止的 Ingress Gateway</a></li><li role=none><a role=treeitem title="展示如何配置Kubernetes Ingress对象，使得从服务网格外部可以访问网格内服务。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/kubernetes-ingress/>Kubernetes Ingress</a></li><li role=none><a role=treeitem title="描述在 Istio 中如何配置 Kubernetes Gateway API。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/gateway-api/>Kubernetes Gateway API</a></li><li role=none><a role=treeitem title="描述如何使用 Kubernetes Service APIs 配置 Istio 服务。" href=/v1.12/zh/docs/tasks/traffic-management/ingress/service-apis/>Kubernetes Service APIs</a></li></ul></li><li role=treeitem aria-label=Egress><button aria-hidden=true></button><a title="控制 Istio 服务网格的出口流量。" href=/v1.12/zh/docs/tasks/traffic-management/egress/>Egress</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="描述如何配置 Istio 以将流量从网格中的服务路由到外部服务。" href=/v1.12/zh/docs/tasks/traffic-management/egress/egress-control/>访问外部服务</a></li><li role=none><a role=treeitem title="描述如何配置 Istio 对来自外部服务的流量执行 TLS 发起。" href=/v1.12/zh/docs/tasks/traffic-management/egress/egress-tls-origination/>Egress TLS Origination</a></li><li role=none><a role=treeitem title="描述如何配置 Istio 通过专用网关服务将流量定向到外部服务。" href=/v1.12/zh/docs/tasks/traffic-management/egress/egress-gateway/>Egress Gateway</a></li><li role=none><a role=treeitem title="描述了如何配置 Egress 网关，使用 Secret Discovery Service 执行 TLS 链接外部服务。" href=/v1.12/zh/docs/tasks/traffic-management/egress/egress-gateway-tls-origination-sds/>Egress 网关 TLS 连接 发起的过程 (SDS)</a></li><li role=none><a role=treeitem title="描述如何配置一个 Egress 网关，来向外部服务发起 TLS 连接。" href=/v1.12/zh/docs/tasks/traffic-management/egress/egress-gateway-tls-origination/>Egress 网关的 TLS 发起过程</a></li><li role=none><a role=treeitem title="描述如何开启通用域中一组主机的 egress，无需单独配置每一台主机。" href=/v1.12/zh/docs/tasks/traffic-management/egress/wildcard-egress-hosts/>Wildcard 主机的 egress</a></li><li role=none><a role=treeitem title="描述如何在 TLS Egress 上配置 SNI 监控和策略。" href=/v1.12/zh/docs/tasks/traffic-management/egress/egress_sni_monitoring_and_policies/>TLS Egress 监控和策略配置</a></li><li role=none><a role=treeitem title="展示如何配置 Istio Kubernetes 外部服务。" href=/v1.12/zh/docs/tasks/traffic-management/egress/egress-kubernetes-services/>Kubernetes Egress 流量服务</a></li><li role=none><a role=treeitem title="描述如何配置 Istio 以允许应用程序使用外部 HTTPS 代理。" href=/v1.12/zh/docs/tasks/traffic-management/egress/http-proxy/>使用外部 HTTPS 代理</a></li></ul></li></ul></li><li role=treeitem aria-label=安全><button aria-hidden=true></button><a title=演示如何保护网格。 href=/v1.12/zh/docs/tasks/security/>安全</a><ul role=group aria-expanded=false><li role=treeitem aria-label=认证><button aria-hidden=true></button><a title="管控网格服务间的双向 TLS 和终端用户的身份认证。" href=/v1.12/zh/docs/tasks/security/authentication/>认证</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="向您展示如何通过使用 Istio 认证策略来设置双向 TLS 和基本的终端用户认证。" href=/v1.12/zh/docs/tasks/security/authentication/authn-policy/>认证策略</a></li><li role=none><a role=treeitem title="阐述如何将 Istio 服务逐步迁移至双向 TLS 通信模式。" href=/v1.12/zh/docs/tasks/security/authentication/mtls-migration/>双向 TLS 迁移</a></li></ul></li><li role=treeitem aria-label=证书管理><button aria-hidden=true></button><a title="管理 Istio 的证书。" href=/v1.12/zh/docs/tasks/security/cert-management/>证书管理</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="系统管理员如何通过根证书、签名证书和密钥来配置 Istio 的 CA。" href=/v1.12/zh/docs/tasks/security/cert-management/plugin-ca-cert/>插入 CA 证书</a></li><li role=none><a role=treeitem title="如何在 Istiod 中配置和管理 DNS 证书。" href=/v1.12/zh/docs/tasks/security/cert-management/dns-cert/>Istio 的 DNS 证书管理</a></li><li role=none><a role=treeitem title="演示如何使用自定义证书颁发机构(与 Kubernetes CSR API 集成)来提供 Istio 工作负载证书。 (Experimental)" href=/v1.12/zh/docs/tasks/security/cert-management/custom-ca-k8s/>使用 Kubernetes CSR 自定义 CA 集成 *</a></li></ul></li><li role=treeitem aria-label=授权><button aria-hidden=true></button><a title="展示如何控制到 Istio 服务的访问。" href=/v1.12/zh/docs/tasks/security/authorization/>授权</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="展示如何设置 HTTP 流量访问控制。" href=/v1.12/zh/docs/tasks/security/authorization/authz-http/>HTTP 流量授权</a></li><li role=none><a role=treeitem title="展示如何设置 TCP 流量的访问控制。" href=/v1.12/zh/docs/tasks/security/authorization/authz-tcp/>TCP 流量</a></li><li role=none><a role=treeitem title="有关如何在 Istio 中通过 JWT 实现访问控制的教程。" href=/v1.12/zh/docs/tasks/security/authorization/authz-jwt/>基于 JWT 授权</a></li><li role=none><a role=treeitem title=如何设置访问控制以明确地拒绝流量。 href=/v1.12/zh/docs/tasks/security/authorization/authz-deny/>明确拒绝</a></li><li role=none><a role=treeitem title=阐述如何在不更改授权策略的前提下从一个信任域迁移到另一个。 href=/v1.12/zh/docs/tasks/security/authorization/authz-td-migration/>信任域迁移</a></li></ul></li></ul></li><li role=treeitem aria-label=策略执行><button aria-hidden=true></button><a title=演示策略执行特性。 href=/v1.12/zh/docs/tasks/policy-enforcement/>策略执行</a><ul role=group aria-expanded=false class=leaf-section></ul></li><li role=treeitem aria-label=可观察性><button aria-hidden=true></button><a title=演示如何从网格收集遥测信息。 href=/v1.12/zh/docs/tasks/observability/>可观察性</a><ul role=group aria-expanded=false><li role=treeitem aria-label=指标度量><button aria-hidden=true></button><a title="演示 Istio 网格指标度量的配置、收集和处理。" href=/v1.12/zh/docs/tasks/observability/metrics/>指标度量</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="此任务向您展示如何配置 Istio 以采集和自定义指标。" href=/v1.12/zh/docs/tasks/observability/metrics/collecting-metrics/>采集指标</a></li><li role=none><a role=treeitem title="本任务展示了如何配置 Istio 进行 TCP 服务的指标收集。" href=/v1.12/zh/docs/tasks/observability/metrics/tcp-metrics/>收集 TCP 服务指标</a></li><li role=none><a role=treeitem title="本任务介绍如何通过 Prometheus 查询 Istio 度量指标。" href=/v1.12/zh/docs/tasks/observability/metrics/querying-metrics/>通过 Prometheus 查询度量指标</a></li><li role=none><a role=treeitem title="此任务展示了如何设置和使用 Istio Dashboard 监控网格流量。" href=/v1.12/zh/docs/tasks/observability/metrics/using-istio-dashboard/>使用 Grafana 可视化指标</a></li></ul></li><li role=treeitem aria-label=日志><button aria-hidden=true></button><a title="演示 Istio 网格日志的配置、收集和处理。" href=/v1.12/zh/docs/tasks/observability/logs/>日志</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="本任务向您展示如何配置 Istio 来收集和定制日志。" href=/v1.12/zh/docs/tasks/observability/logs/collecting-logs/>收集日志</a></li><li role=none><a role=treeitem title="此任务向您展示如何配置 Envoy 代理将访问日志打印到其标准输出。" href=/v1.12/zh/docs/tasks/observability/logs/access-log/>获取 Envoy 访问日志</a></li><li role=none><a role=treeitem title="此任务向您展示如何配置 Istio 以连接到 Fluentd 守护程序进行日志收集。" href=/v1.12/zh/docs/tasks/observability/logs/fluentd/>使用 Fluentd 进行日志收集</a></li></ul></li><li role=treeitem aria-label=分布式追踪><button aria-hidden=true></button><a title="该任务展示了如何为启用了 Istio 支持的应用进行追踪。" href=/v1.12/zh/docs/tasks/observability/distributed-tracing/>分布式追踪</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="Istio 分布式追踪的概述。" href=/v1.12/zh/docs/tasks/observability/distributed-tracing/overview/>概述</a></li><li role=none><a role=treeitem title="了解如何通过配置代理以向 Zipkin 发送追踪请求。" href=/v1.12/zh/docs/tasks/observability/distributed-tracing/zipkin/>Zipkin</a></li><li role=none><a role=treeitem title="了解如何配置代理以向 Jaeger 发送追踪请求。" href=/v1.12/zh/docs/tasks/observability/distributed-tracing/jaeger/>Jaeger</a></li><li role=none><a role=treeitem title="怎样配置代理才能把追踪请求发送到 LightStep。" href=/v1.12/zh/docs/tasks/observability/distributed-tracing/lightstep/>LightStep</a></li></ul></li><li role=none><a role=treeitem title="此任务向您展示如何在 Istio 网格中可视化服务。" href=/v1.12/zh/docs/tasks/observability/kiali/>网络可视化</a></li><li role=none><a role=treeitem title="此任务向您展示如何配置从外部访问 Istio 遥测插件。" href=/v1.12/zh/docs/tasks/observability/gateways/>远程访问遥测插件</a></li></ul></li></ul></li><li role=treeitem aria-label=示例><a class=main title="这里包括多个可供 Istio 使用的可完整工作的示例，你可以用来亲自部署和体验这些示例。" href=/v1.12/zh/docs/examples/>示例</a><ul role=group aria-expanded=true><li role=none><a role=treeitem title="部署一个用于演示多种 Istio 特性的应用，由四个单独的微服务构成。" href=/v1.12/zh/docs/examples/bookinfo/>Bookinfo 应用</a></li><li role=none><a role=treeitem title="使用在网格内的虚拟机上运行的 MySQL 服务运行 Bookinfo 应用程序。" href=/v1.12/zh/docs/examples/virtual-machines/>在虚拟机上部署 Bookinfo 应用程序</a></li><li role=treeitem aria-label="使用 Kubernetes 和 Istio 学习微服务"><button aria-hidden=true></button><a title="该模块化教程为新用户提供了一步步将 Istio 应用于常见微服务场景的动手经验。" href=/v1.12/zh/docs/examples/microservices-istio/>使用 Kubernetes 和 Istio 学习微服务</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/prereq/>前提条件</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/setup-kubernetes-cluster/>设置 Kubernetes 集群</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/setup-local-computer/>设置本地计算机</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/single/>本地运行微服务</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/package-service/>在 Docker 中运行 ratings 服务</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/bookinfo-kubernetes/>使用 Kubernetes 运行 Bookinfo</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/production-testing/>生产测试</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/add-new-microservice-version/>添加一个新版本的 reviews</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/add-istio/>在 productpage 启用 Istio</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/enable-istio-all-microservices/>在所有微服务中启用 Istio</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/istio-ingress-gateway/>配置 Istio Ingress Gateway</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/examples/microservices-istio/logs-istio/>监控 Istio</a></li></ul></li></ul></li><li role=treeitem aria-label=运维><a class=main title="关于部署和管理 Istio 网格的概念、工具和技术。" href=/v1.12/zh/docs/ops/>运维</a><ul role=group aria-expanded=true><li role=treeitem aria-label=部署><button aria-hidden=true></button><a title="设置 Istio 部署的要求、概念和注意事项。" href=/v1.12/zh/docs/ops/deployment/>部署</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="描述 Istio 的整体架构与设计目标。" href=/v1.12/zh/docs/ops/deployment/architecture/>架构</a></li><li role=none><a role=treeitem title="描述 Istio 部署中的选择和建议。" href=/v1.12/zh/docs/ops/deployment/deployment-models/>部署模型</a></li><li role=none><a role=treeitem title="介绍 Istio 的性能和可扩展性。" href=/v1.12/zh/docs/ops/deployment/performance-and-scalability/>性能和可扩展性</a></li><li role=none><a role=treeitem title="在启用了 Istio 的集群中运行 Kubernetes 的 Pod 和 Service，您需要做些准备。" href=/v1.12/zh/docs/ops/deployment/requirements/>Pod 和 Service</a></li></ul></li><li role=treeitem aria-label=配置><button aria-hidden=true></button><a title="配置运行中的 Istio 网格的高级概念和功能。" href=/v1.12/zh/docs/ops/configuration/>配置</a><ul role=group aria-expanded=false><li role=treeitem aria-label=网格配置><button aria-hidden=true></button><a title=帮助您管理全局网格配置。 href=/v1.12/zh/docs/ops/configuration/mesh/>网格配置</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="简要描述 Istio 对 Kubernetes webhook 的使用以及可能出现的相关问题。" href=/v1.12/zh/docs/ops/configuration/mesh/webhook/>动态准入 Webhook 概述</a></li><li role=none><a role=treeitem title=如何等待资源达到给定的就绪状态。 href=/v1.12/zh/docs/ops/configuration/mesh/config-resource-ready/>等待应用的配置资源状态就绪</a></li><li role=none><a role=treeitem title="介绍 Istio 是如何通过 Kubernetes 的 webhooks 机制来实现 Sidecar 自动注入。" href=/v1.12/zh/docs/ops/configuration/mesh/injection-concepts/>Sidecar 自动注入</a></li><li role=none><a role=treeitem title="描述 Citadel 如何确定是否创建服务账号 secret。" href=/v1.12/zh/docs/ops/configuration/mesh/secret-creation/>创建服务账号 Secret</a></li><li role=none><a role=treeitem title="为您展示如何对 Istio 服务做健康检查。" href=/v1.12/zh/docs/ops/configuration/mesh/app-health-check/>Istio 服务的健康检查</a></li></ul></li><li role=treeitem aria-label=流量管理><button aria-hidden=true></button><a title=帮助您管理正在运行的网格的网络方面。 href=/v1.12/zh/docs/ops/configuration/traffic-management/>流量管理</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title=关于如何声明协议。 href=/v1.12/zh/docs/ops/configuration/traffic-management/protocol-selection/>协议选择</a></li><li role=none><a role=treeitem title=有关如何启用和理解地域负载平衡。 href=/v1.12/zh/docs/ops/configuration/traffic-management/locality-load-balancing/>地域负载均衡</a></li><li role=none><a role=treeitem title="如何使用 TLS 配置设置安全的网络流量。" href=/v1.12/zh/docs/ops/configuration/traffic-management/tls-configuration/>TLS 配置</a></li><li role=none><a role=treeitem title="如何配置 DNS 代理。" href=/v1.12/zh/docs/ops/configuration/traffic-management/dns-proxy/>DNS 代理</a></li><li role=none><a role=treeitem title="如何配置 Gateway 网络拓扑。 (Alpha)" href=/v1.12/zh/docs/ops/configuration/traffic-management/network-topologies/>配置 Gateway 网络拓扑 *</a></li></ul></li><li role=treeitem aria-label=安全><button aria-hidden=true></button><a title=帮助您管理正在运行的网格的安全性方面。 href=/v1.12/zh/docs/ops/configuration/security/>安全</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="使用加固的容器镜像来减小 Istio 的攻击面。" href=/v1.12/zh/docs/ops/configuration/security/harden-docker-images/>加固 Docker 容器镜像</a></li></ul></li><li role=treeitem aria-label=可观测性><button aria-hidden=true></button><a title=帮助您管理正在运行的网格中的遥测收集和可视化。 href=/v1.12/zh/docs/ops/configuration/telemetry/>可观测性</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="配置 Prometheus 监控 Istio 多集群。" href=/v1.12/zh/docs/ops/configuration/telemetry/monitoring-multicluster-prometheus/>使用 Prometheus 监控 Istio 多集群</a></li><li role=none><a role=treeitem title="精细化控制 Envoy 的统计信息。" href=/v1.12/zh/docs/ops/configuration/telemetry/envoy-stats/>Envoy 的统计信息</a></li></ul></li></ul></li><li role=treeitem aria-label=最佳实践><button aria-hidden=true></button><a title="设置和管理 Istio 服务网格的最佳实践。" href=/v1.12/zh/docs/ops/best-practices/>最佳实践</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="设置 Istio 服务网格时的最佳实践。" href=/v1.12/zh/docs/ops/best-practices/deployment/>Deployment 最佳实践</a></li><li role=none><a role=treeitem title=避免网络或流量管理问题的配置最佳实践。 href=/v1.12/zh/docs/ops/best-practices/traffic-management/>流量管理最佳实践</a></li><li role=none><a role=treeitem title="使用 Istio 保护应用的最佳实践。" href=/v1.12/zh/docs/ops/best-practices/security/>安全最佳实践</a></li><li role=none><a role=treeitem title="使用 Istio 观测应用时的最佳实践。" href=/v1.12/zh/docs/ops/best-practices/observability/>可观察性最佳实践</a></li></ul></li><li role=treeitem aria-label=常见问题><button aria-hidden=true></button><a title="描述如何辨认和解决 Istio 中的常见问题。" href=/v1.12/zh/docs/ops/common-problems/>常见问题</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="定位常见的 Istio 流量管理和网络问题的技术。" href=/v1.12/zh/docs/ops/common-problems/network-issues/>流量管理问题</a></li><li role=none><a role=treeitem title="定位常见 Istio 认证、授权、安全相关问题的技巧。" href=/v1.12/zh/docs/ops/common-problems/security-issues/>安全问题</a></li><li role=none><a role=treeitem title="处理 Telemetry 收集问题。" href=/v1.12/zh/docs/ops/common-problems/observability-issues/>可观测性问题</a></li><li role=none><a role=treeitem title="解决 Istio 使用 Kubernetes Webhooks 进行 sidecar 自动注入的常见问题。" href=/v1.12/zh/docs/ops/common-problems/injection/>Sidecar 自动注入问题</a></li><li role=none><a role=treeitem title=如何解决配置验证的问题。 href=/v1.12/zh/docs/ops/common-problems/validation/>配置验证的问题</a></li></ul></li><li role=treeitem aria-label=诊断工具><button aria-hidden=true></button><a title="帮助解决 Istio 网格问题的工具和技术。" href=/v1.12/zh/docs/ops/diagnostic-tools/>诊断工具</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="Istio 自带的一个可以为服务网格部署提供调试和诊断的补充工具。" href=/v1.12/zh/docs/ops/diagnostic-tools/istioctl/>使用 Istioctl 命令行工具</a></li><li role=none><a role=treeitem title="描述诊断与流量管理相关的 Envoy 配置问题的工具和技术。" href=/v1.12/zh/docs/ops/diagnostic-tools/proxy-cmd/>调试 Envoy 和 Istiod</a></li><li role=none><a role=treeitem title="向您展示如何使用 istioctl describe 来验证您的网格中的 pod 的配置。" href=/v1.12/zh/docs/ops/diagnostic-tools/istioctl-describe/>通过 Istioctl Describe 理解您的网格</a></li><li role=none><a role=treeitem title="演示如何使用 istioctl analyze 来识别配置中的潜在问题。" href=/v1.12/zh/docs/ops/diagnostic-tools/istioctl-analyze/>使用 Istioctl Analyze 诊断配置</a></li><li role=none><a role=treeitem title="介绍如何使用 ControlZ 深入了解正在运行的 istiod 组件。" href=/v1.12/zh/docs/ops/diagnostic-tools/controlz/>组件自检</a></li><li role=none><a role=treeitem title=如何使用组件的级别日志来记录正在运行中的组件的行为。 href=/v1.12/zh/docs/ops/diagnostic-tools/component-logging/>组件日志记录</a></li><li role=none><a role=treeitem title=介绍关于虚拟机调试的技术和工具。 href=/v1.12/zh/docs/ops/diagnostic-tools/virtual-machines/>虚拟机调试</a></li><li role=none><a role=treeitem title=介绍用来诊断多集群和多网络下安装问题的工具和技术。 href=/v1.12/zh/docs/ops/diagnostic-tools/multicluster/>多集群下的故障排除</a></li></ul></li><li role=treeitem aria-label=集成><button aria-hidden=true></button><a title="能够与 Istio 集成以提供额外功能的其他软件。" href=/v1.12/zh/docs/ops/integrations/>集成</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="关于如何与 cert-manager 集成的相关说明。" href=/v1.12/zh/docs/ops/integrations/certmanager/>cert-manager</a></li><li role=none><a role=treeitem title="关于如何与 Grafana 集成构建 Istio 仪表盘的相关文档。" href=/v1.12/zh/docs/ops/integrations/grafana/>Grafana</a></li><li role=none><a role=treeitem title="如何与 Jaeger 集成。" href=/v1.12/zh/docs/ops/integrations/jaeger/>Jaeger</a></li><li role=none><a role=treeitem title="有关如何与 Kiali 集成的信息。" href=/v1.12/zh/docs/ops/integrations/kiali/>Kiali</a></li><li role=none><a role=treeitem title="如何集成 Prometheus。" href=/v1.12/zh/docs/ops/integrations/prometheus/>Prometheus</a></li><li role=none><a role=treeitem title="如何与 Zipkin 进行集成。" href=/v1.12/zh/docs/ops/integrations/zipkin/>Zipkin</a></li></ul></li></ul></li><li role=treeitem aria-label=发布><a class=main title="与 Istio 发布有关的信息。" href=/v1.12/zh/docs/releases/>发布</a><ul role=group aria-expanded=true><li role=none><a role=treeitem title=特性及其发布阶段的列表。 href=/v1.12/zh/docs/releases/feature-stages/>功能状态</a></li><li role=none><a role=treeitem title=如果发现错误该怎么办。 href=/v1.12/zh/docs/releases/bugs/>报告错误</a></li><li role=none><a role=treeitem title="当前支持的 Istio 版本。" href=/v1.12/zh/docs/releases/supported-releases/>版本支持</a></li><li role=none><a role=treeitem title=我们如何处理安全漏洞。 href=/v1.12/zh/docs/releases/security-vulnerabilities/>安全漏洞</a></li><li role=treeitem aria-label=贡献文档><button aria-hidden=true></button><a title="详细介绍了如何创建和维护 Istio 文档。" href=/v1.12/zh/docs/releases/contribute/>贡献文档</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="介绍如何为 Istio 贡献新文档。" href=/v1.12/zh/docs/releases/contribute/add-content/>添加新文档</a></li><li role=none><a role=treeitem title=介绍如何在本地进行本网站的构建，测试，运行和预览。 href=/v1.12/zh/docs/releases/contribute/build/>本地构建和运行本网站</a></li><li role=none><a role=treeitem title=介绍了文档中使用的文章头及其可用字段。 href=/v1.12/zh/docs/releases/contribute/front-matter/>文章头部</a></li><li role=none><a role=treeitem title="向您展示如何审阅和批准对 Istio 文档和网站的更改。" href=/v1.12/zh/docs/releases/contribute/review/>文档审阅流程</a></li><li role=none><a role=treeitem title=介绍如何在您的文档中添加代码。 href=/v1.12/zh/docs/releases/contribute/code-blocks/>添加代码块</a></li><li role=none><a role=treeitem title="介绍可用的 shortcode 及其用法。" href=/v1.12/zh/docs/releases/contribute/shortcodes/>使用 Shortcode</a></li><li role=none><a role=treeitem title="介绍 Istio 文档的格式标准。" href=/v1.12/zh/docs/releases/contribute/formatting/>格式标准</a></li><li role=none><a role=treeitem title="介绍 Istio 文档所使用的风格规则。" href=/v1.12/zh/docs/releases/contribute/style-guide/>风格指南</a></li><li role=none><a role=treeitem title="解释 Istio 文档中使用的术语标准。" href=/v1.12/zh/docs/releases/contribute/terminology/>术语标准</a></li><li role=none><a role=treeitem title="为 Istio 文档创建图表提供素材和说明。" href=/v1.12/zh/docs/releases/contribute/diagrams/>创建图表指南</a></li><li role=none><a role=treeitem title="向您展示如何使用 GitHub 参与贡献 Istio 文档。" href=/v1.12/zh/docs/releases/contribute/github/>使用 GitHub 参与社区活动</a></li></ul></li><li role=none><a role=treeitem title=该网站的最新更改列表。 href=/v1.12/zh/docs/releases/log/>网站内容更改</a></li></ul></li><li role=treeitem aria-label=参考><a class=main title="参考部分包含详细的权威参考资料，如命令行选项、配置选项和 API 调用参数。" href=/v1.12/zh/docs/reference/>参考</a><ul role=group aria-expanded=true><li role=treeitem aria-label=配置><button class=show aria-hidden=true></button><a title=关于配置选项的详细信息。 href=/v1.12/zh/docs/reference/config/>配置</a><ul role=group aria-expanded=true><li role=none><a role=treeitem title="Configuration affecting the service mesh as a whole." href=/v1.12/zh/docs/reference/config/istio.mesh.v1alpha1/>Service Mesh</a></li><li role=none><a role=treeitem title="Configuration for Istio control plane installation through the Operator." href=/v1.12/zh/docs/reference/config/istio.operator.v1alpha12.pb/>Operator Installation</a></li><li role=none><a role=treeitem title="描述使用 Helm chart 安装 Istio 时的可选项。" href=/v1.12/zh/docs/reference/config/installation-options/>安装选项（Helm）</a></li><li role=none><a role=treeitem title="Configuration affecting Istio control plane installation version and shape." href=/v1.12/zh/docs/reference/config/istio.operator.v1alpha1/>IstioOperator Options</a></li><li role=none><a role=treeitem title=描述“状态”字段在配置工作流程中的作用。 href=/v1.12/zh/docs/reference/config/config-status/>状态字段配置</a></li><li role=none><a role=treeitem title="Resource annotations used by Istio." href=/v1.12/zh/docs/reference/config/annotations/>Resource Annotations</a></li><li role=treeitem aria-label=流量管理><button aria-hidden=true></button><a title="描述如何配置 HTTP/TCP 路由功能。" href=/v1.12/zh/docs/reference/config/networking/>流量管理</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="Configuration affecting load balancing, outlier detection, etc." href=/v1.12/zh/docs/reference/config/networking/destination-rule/>Destination Rule</a></li><li role=none><a role=treeitem title="Customizing Envoy configuration generated by Istio." href=/v1.12/zh/docs/reference/config/networking/envoy-filter/>Envoy Filter</a></li><li role=none><a role=treeitem title="Configuration affecting edge load balancer." href=/v1.12/zh/docs/reference/config/networking/gateway/>Gateway</a></li><li role=none><a role=treeitem title="Configuration affecting label/content routing, sni routing, etc." href=/v1.12/zh/docs/reference/config/networking/virtual-service/>Virtual Service</a></li><li role=none><a role=treeitem title="Configuration affecting network reachability of a sidecar." href=/v1.12/zh/docs/reference/config/networking/sidecar/>Sidecar</a></li><li role=none><a role=treeitem title="Configuration affecting service registry." href=/v1.12/zh/docs/reference/config/networking/service-entry/>Service Entry</a></li></ul></li><li role=treeitem aria-label=Security><button aria-hidden=true></button><a title="如何配置 Istio 的安全功能。" href=/v1.12/zh/docs/reference/config/security/>Security</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="Configuration to validate JWT." href=/v1.12/zh/docs/reference/config/security/jwt/>JWTRule</a></li><li role=none><a role=treeitem title="Peer authentication configuration for workloads." href=/v1.12/zh/docs/reference/config/security/peer_authentication/>PeerAuthentication</a></li><li role=none><a role=treeitem title="Request authentication configuration for workloads." href=/v1.12/zh/docs/reference/config/security/request_authentication/>RequestAuthentication</a></li><li role=none><a role=treeitem title="Authentication policy for Istio services." href=/v1.12/zh/docs/reference/config/security/istio.authentication.v1alpha1/>Authentication Policy</a></li><li role=none><a role=treeitem title="Configuration for access control on workloads." href=/v1.12/zh/docs/reference/config/security/authorization-policy/>Authorization Policy</a></li><li role=none><a role=treeitem title=授权策略中支持的条件。 href=/v1.12/zh/docs/reference/config/security/conditions/>授权策略</a></li><li role=none><a role=treeitem title="Configuration for Role Based Access Control." href=/v1.12/zh/docs/reference/config/security/istio.rbac.v1alpha1/>RBAC (deprecated)</a></li><li role=none><a role=treeitem title=受支持的约束条件和属性。 href=/v1.12/zh/docs/reference/config/security/constraints-and-properties/>RBAC 约束和属性（不建议使用）</a></li></ul></li><li role=none><a role=treeitem title="通过 Istio 遥测导出的 Istio 标准指标。" href=/v1.12/zh/docs/reference/config/metrics/>Istio 标准指标</a></li><li role=treeitem aria-label=配置分析消息><button aria-hidden=true></button><a title=记录配置分析期间产生的各个错误和警告消息。 href=/v1.12/zh/docs/reference/config/analysis/>配置分析消息</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/message-format/>Analyzer Message Format</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0109/>ConflictingMeshGatewayVirtualServiceHosts</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0110/>ConflictingSidecarWorkloadSelectors</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0116/>DeploymentAssociatedToMultipleServices</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0137/>DeploymentConflictingPorts</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0117/>DeploymentRequiresServiceAssociated</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0002/>Deprecated</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0135/>DeprecatedAnnotation</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0104/>GatewayPortNotOnWorkload</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0001/>InternalError</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0125/>InvalidAnnotation</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0144/>InvalidApplicationUID</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0122/>InvalidRegexp</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0105/>IstioProxyImageMismatch</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0119/>JwtFailureDueToInvalidServicePortPrefix</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0107/>MisplacedAnnotation</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0128/>NoServerCertificateVerificationDestinationLevel</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0113/>MTLSPolicyConflict</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0111/>MultipleSidecarsWithoutWorkloadSelectors</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0123/>NamespaceMultipleInjectionLabels</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0102/>NamespaceNotInjected</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0130/>VirtualServiceUnreachableRule</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0131/>VirtualServiceIneffectiveMatch</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0132/>VirtualServiceHostNotFoundInGateway</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0112/>VirtualServiceDestinationPortSelectorRequired</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0108/>UnknownAnnotation</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0106/>SchemaValidationError</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0136/>AlphaAnnotation</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0101/>ReferencedResourceNotFound</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0118/>PortNameIsNotUnderNamingConvention</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0103/>PodMissingProxy</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0129/>NoServerCertificateVerificationPortLevel</a></li><li role=none><a role=treeitem href=/v1.12/zh/docs/reference/config/analysis/ist0127/>NoMatchingWorkloadsFound</a></li></ul></li><li role=treeitem aria-label="Mixer 策略和遥测"><button class=show aria-hidden=true></button><a title="描述如何配置 Mixer 的策略和遥测功能。" href=/v1.12/zh/docs/reference/config/policy-and-telemetry/>Mixer 策略和遥测</a><ul role=group aria-expanded=true><li role=none><a role=treeitem title="Configuration state for the Mixer client library." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/istio.mixer.v1.config.client/>Mixer Client</a></li><li role=none><a role=treeitem title="Describes the rules used to configure Mixer's policy and telemetry features." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/istio.policy.v1beta1/>Rules</a></li><li role=none><a role=treeitem title="描述 Istio 策略执行和遥测机制的配置模型。" href=/v1.12/zh/docs/reference/config/policy-and-telemetry/mixer-overview/>Mixer 配置模型</a></li><li role=none><a role=treeitem title=描述用于策略和控制的基本属性词汇表。 href=/v1.12/zh/docs/reference/config/policy-and-telemetry/attribute-vocabulary/>属性词汇</a></li><li role=none><a role=treeitem title="Mixer 配置表达式语言手册。" href=/v1.12/zh/docs/reference/config/policy-and-telemetry/expression-language/>表达式语言</a></li><li role=treeitem aria-label=适配器><button aria-hidden=true></button><a title="Mixer 适配器能够让 Istio 连接各种基础设施后端以完成类似指标和日志这样的功能。" href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/>适配器</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="Adapter to deliver metrics to Apache SkyWalking." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/apache-skywalking/>Apache SkyWalking</a></li><li role=none><a role=treeitem title="Adapter for Apigee's distributed policy checks and analytics." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/apigee/>Apigee</a></li><li role=none><a role=treeitem title="Adapter to enforce authentication and authorization policies for web apps and APIs." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/app-identity-access-adapter/>App Identity and Access</a></li><li role=none><a role=treeitem title="Adapter for circonus.com's monitoring solution." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/circonus/>Circonus</a></li><li role=none><a role=treeitem title="Adapter for cloudmonitor metrics." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/cloudmonitor/>CloudMonitor</a></li><li role=none><a role=treeitem title="Adapter for cloudwatch metrics." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/cloudwatch/>CloudWatch</a></li><li role=none><a role=treeitem title="Adapter to deliver metrics to a dogstatsd agent for delivery to DataDog." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/datadog/>Datadog</a></li><li role=none><a role=treeitem title="Adapter that always returns a precondition denial." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/denier/>Denier</a></li><li role=none><a role=treeitem title="Adapter to deliver tracing data to Zipkin." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/zipkin/>Zipkin</a></li><li role=none><a role=treeitem title="Adapter that delivers logs to a Fluentd daemon." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/fluentd/>Fluentd</a></li><li role=none><a role=treeitem title="Adapter that extracts information from a Kubernetes environment." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/kubernetesenv/>Kubernetes Env</a></li><li role=none><a role=treeitem title="Adapter that performs whitelist or blacklist checks." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/list/>List</a></li><li role=none><a role=treeitem title="Adapter for a simple in-memory quota management system." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/memquota/>Memory quota</a></li><li role=none><a role=treeitem title="An Istio Mixer adapter to send telemetry data to New Relic." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/newrelic/>New Relic</a></li><li role=none><a role=treeitem title="Adapter to deliver metrics to Wavefront by VMware." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/wavefront/>Wavefront by VMware</a></li><li role=none><a role=treeitem title="Adapter to locally output logs and metrics." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/stdio/>Stdio</a></li><li role=none><a role=treeitem title="Adapter to deliver metrics to a StatsD backend." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/statsd/>StatsD</a></li><li role=none><a role=treeitem title="Adapter to deliver logs, metrics, and traces to Stackdriver." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/stackdriver/>Stackdriver</a></li><li role=none><a role=treeitem title="Adapter to deliver logs and metrics to Papertrail and AppOptics backends." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/solarwinds/>SolarWinds</a></li><li role=none><a role=treeitem title="Adapter for a Redis-based quota management system." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/redisquota/>Redis Quota</a></li><li role=none><a role=treeitem title="Adapter that exposes Istio metrics for ingestion by a Prometheus harvester." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/prometheus/>Prometheus</a></li><li role=none><a role=treeitem title="Adapter that implements an Open Policy Agent engine." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/adapters/opa/>OPA</a></li></ul></li><li role=treeitem aria-label=模板><button aria-hidden=true></button><a title="Mixer 模板用于将数据发送到各个适配器。" href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/>模板</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="The Analytics template is used to dispatch runtime telemetry to Apigee." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/analytics/>Analytics</a></li><li role=none><a role=treeitem title="A template that represents a single API key." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/apikey/>API Key</a></li><li role=none><a role=treeitem title="A template used to represent an access control query." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/authorization/>Authorization</a></li><li role=none><a role=treeitem title="A template that carries no data, useful for testing." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/checknothing/>Check Nothing</a></li><li role=none><a role=treeitem title="A template that represents a single runtime metric." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/metric/>Metric</a></li><li role=none><a role=treeitem title="A template designed to report observed communication edges between workloads." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/edge/>Edge</a></li><li role=none><a role=treeitem title="A template that is used to control the production of Kubernetes-specific attributes." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/kubernetes/>Kubernetes</a></li><li role=none><a role=treeitem title="A template designed to let you perform list checking operations." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/listentry/>List Entry</a></li><li role=none><a role=treeitem title="A template that represents a single runtime log entry." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/logentry/>Log Entry</a></li><li role=none><a role=treeitem title="A template that represents an individual span within a distributed trace." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/tracespan/>Trace Span</a></li><li role=none><a role=treeitem title="A template that carries no data, useful for testing." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/reportnothing/>Report Nothing</a></li><li role=none><a role=treeitem title="A template that represents a quota allocation request." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/templates/quota/>Quota</a></li></ul></li><li role=none><a role=treeitem title="通过 Mixer 从 Istio 导出的默认监控指标。" href=/v1.12/zh/docs/reference/config/policy-and-telemetry/metrics/>默认监控指标</a></li></ul></li></ul></li><li role=treeitem aria-label=命令><button aria-hidden=true></button><a title="描述 Istio 命令和工具的用法及选项。" href=/v1.12/zh/docs/reference/commands/>命令</a><ul role=group aria-expanded=false class=leaf-section><li role=none><a role=treeitem title="Istio security per-node agent." href=/v1.12/zh/docs/reference/commands/node_agent/>node_agent</a></li><li role=none><a role=treeitem title="Galley provides configuration management services for Istio." href=/v1.12/zh/docs/reference/commands/galley/>galley</a></li><li role=none><a role=treeitem title="Istio Certificate Authority (CA)." href=/v1.12/zh/docs/reference/commands/istio_ca/>istio_ca</a></li><li role=none><a role=treeitem title="Istio control interface." href=/v1.12/zh/docs/reference/commands/istioctl/>istioctl</a></li><li role=none><a role=treeitem title="Mixer is Istio's abstraction on top of infrastructure backends." href=/v1.12/zh/docs/reference/commands/mixs/>mixs</a></li><li role=none><a role=treeitem title="Kubernetes webhook for automatic Istio sidecar injection." href=/v1.12/zh/docs/reference/commands/sidecar-injector/>sidecar-injector</a></li><li role=none><a role=treeitem title="Istio Pilot." href=/v1.12/zh/docs/reference/commands/pilot-discovery/>pilot-discovery</a></li><li role=none><a role=treeitem title="Istio Pilot agent." href=/v1.12/zh/docs/reference/commands/pilot-agent/>pilot-agent</a></li><li role=none><a role=treeitem title="The Istio operator." href=/v1.12/zh/docs/reference/commands/operator/>operator</a></li></ul></li><li role=none><a role=treeitem title="Istio 常用术语的词汇表。" href=/v1.12/zh/docs/reference/glossary/>术语表</a></li></ul></li></ul></div></div></div></nav></div><div class=article-container><button id=sidebar-toggle class=main-navigation-toggle aria-label="Open sidebar"><svg class="icon hamburger-sidebar"><use xlink:href="/v1.12/img/icons.svg#hamburger-sidebar"/></svg>
|
||
目录</button><article aria-labelledby=title><nav aria-label=Breadcrumb><ol><li><a href=/v1.12/zh/docs/ title="了解如何部署、使用和运维 Istio。">文档</a><svg class="icon breadcrumb-arrow"><use xlink:href="/v1.12/img/icons.svg#breadcrumb-arrow"/></svg></li><li><a href=/v1.12/zh/docs/reference/ title="参考部分包含详细的权威参考资料，如命令行选项、配置选项和 API 调用参数。">参考</a><svg class="icon breadcrumb-arrow"><use xlink:href="/v1.12/img/icons.svg#breadcrumb-arrow"/></svg></li><li><a href=/v1.12/zh/docs/reference/config/ title=关于配置选项的详细信息。>配置</a><svg class="icon breadcrumb-arrow"><use xlink:href="/v1.12/img/icons.svg#breadcrumb-arrow"/></svg></li><li><a href=/v1.12/zh/docs/reference/config/policy-and-telemetry/ title="描述如何配置 Mixer 的策略和遥测功能。">Mixer 策略和遥测</a><svg class="icon breadcrumb-arrow"><use xlink:href="/v1.12/img/icons.svg#breadcrumb-arrow"/></svg></li><li>Mixer Client</li></ol></nav><div class=title-area><div style=width:100%><h1 id=title>Mixer Client</h1><p class=byline><span class=reading-time title="2280 字"><svg class="icon clock"><use xlink:href="/v1.12/img/icons.svg#clock"/></svg><span> </span>阅读大约需要 11 分钟</span>
|
||
<span> </span>
|
||
<span></span></p></div></div><nav class=toc-inlined aria-label="Table of Contents"><div><hr><ol><li role=none aria-label=APIKey><a href=#APIKey>APIKey</a><li role=none aria-label=AttributeMatch><a href=#AttributeMatch>AttributeMatch</a><li role=none aria-label=HTTPAPISpec><a href=#HTTPAPISpec>HTTPAPISpec</a><li role=none aria-label=HTTPAPISpecBinding><a href=#HTTPAPISpecBinding>HTTPAPISpecBinding</a><li role=none aria-label=HTTPAPISpecPattern><a href=#HTTPAPISpecPattern>HTTPAPISpecPattern</a><li role=none aria-label=HTTPAPISpecReference><a href=#HTTPAPISpecReference>HTTPAPISpecReference</a><li role=none aria-label=HttpClientConfig><a href=#HttpClientConfig>HttpClientConfig</a><li role=none aria-label=IstioService><a href=#IstioService>IstioService</a><li role=none aria-label=NetworkFailPolicy><a href=#NetworkFailPolicy>NetworkFailPolicy</a><li role=none aria-label=NetworkFailPolicy.FailPolicy><a href=#NetworkFailPolicy-FailPolicy>NetworkFailPolicy.FailPolicy</a><li role=none aria-label=Quota><a href=#Quota>Quota</a><li role=none aria-label=QuotaRule><a href=#QuotaRule>QuotaRule</a><li role=none aria-label=QuotaSpec><a href=#QuotaSpec>QuotaSpec</a><li role=none aria-label=QuotaSpecBinding><a href=#QuotaSpecBinding>QuotaSpecBinding</a><li role=none aria-label=QuotaSpecBinding.QuotaSpecReference><a href=#QuotaSpecBinding-QuotaSpecReference>QuotaSpecBinding.QuotaSpecReference</a><li role=none aria-label=ServiceConfig><a href=#ServiceConfig>ServiceConfig</a><li role=none aria-label=StringMatch><a href=#StringMatch>StringMatch</a><li role=none aria-label=TcpClientConfig><a href=#TcpClientConfig>TcpClientConfig</a><li role=none aria-label=TransportConfig><a href=#TransportConfig>TransportConfig</a><li role=none aria-label=istio.mixer.v1.Attributes><a href=#istio-mixer-v1-Attributes>istio.mixer.v1.Attributes</a></ol><hr></div></nav><p>Describes the configuration state for the Mixer client library that’s built into Envoy.</p><h2 id=APIKey>APIKey</h2><section><p>APIKey defines the explicit configuration for generating the
|
||
<code>request.api_key</code> attribute from HTTP requests.</p><p>See <a href=https://swagger.io/docs/specification/authentication/api-keys>API Keys</a>
|
||
for a general overview of API keys as defined by OpenAPI.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=APIKey-query class="oneof oneof-start"><td><code>query</code></td><td><code>string (oneof)</code></td><td><p>API Key is sent as a query parameter. <code>query</code> represents the
|
||
query string parameter name.</p><p>For example, <code>query=api_key</code> should be used with the
|
||
following request:</p><pre><code>GET /something?api_key=abcdef12345
|
||
</code></pre></td><td>Yes</td></tr><tr id=APIKey-header class=oneof><td><code>header</code></td><td><code>string (oneof)</code></td><td><p>API key is sent in a request header. <code>header</code> represents the
|
||
header name.</p><p>For example, <code>header=X-API-KEY</code> should be used with the
|
||
following request:</p><pre><code>GET /something HTTP/1.1
|
||
X-API-Key: abcdef12345
|
||
</code></pre></td><td>Yes</td></tr><tr id=APIKey-cookie class=oneof><td><code>cookie</code></td><td><code>string (oneof)</code></td><td><p>API key is sent in a
|
||
<a href=https://swagger.io/docs/specification/authentication/cookie-authentication>cookie</a>,</p><p>For example, <code>cookie=X-API-KEY</code> should be used for the
|
||
following request:</p><pre><code>GET /something HTTP/1.1
|
||
Cookie: X-API-KEY=abcdef12345
|
||
</code></pre></td><td>Yes</td></tr></tbody></table></section><h2 id=AttributeMatch>AttributeMatch</h2><section><p>Specifies a match clause to match Istio attributes</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=AttributeMatch-clause><td><code>clause</code></td><td><code>map<string, <a href=#StringMatch>StringMatch</a>></code></td><td><p>Map of attribute names to StringMatch type.
|
||
Each map element specifies one condition to match.</p><p>Example:</p><p>clause:
|
||
source.uid:
|
||
exact: SOURCE<em>UID
|
||
request.http</em>method:
|
||
exact: POST</p></td><td>No</td></tr></tbody></table></section><h2 id=HTTPAPISpec>HTTPAPISpec</h2><section><p>HTTPAPISpec defines the canonical configuration for generating
|
||
API-related attributes from HTTP requests based on the method and
|
||
uri templated path matches. It is sufficient for defining the API
|
||
surface of a service for the purposes of API attribute
|
||
generation. It is not intended to represent auth, quota,
|
||
documentation, or other information commonly found in other API
|
||
specifications, e.g. OpenAPI.</p><p>Existing standards that define operations (or methods) in terms of
|
||
HTTP methods and paths can be normalized to this format for use in
|
||
Istio. For example, a simple petstore API described by OpenAPIv2
|
||
<a href=https://github.com/googleapis/gnostic/blob/master/examples/v2.0/yaml/petstore-simple.yaml>here</a>
|
||
can be represented with the following HTTPAPISpec.</p><pre><code class=language-yaml>apiVersion: config.istio.io/v1alpha2
|
||
kind: HTTPAPISpec
|
||
metadata:
|
||
name: petstore
|
||
namespace: default
|
||
spec:
|
||
attributes:
|
||
attributes:
|
||
api.service:
|
||
stringValue: petstore.swagger.io
|
||
api.version:
|
||
stringValue: 1.0.0
|
||
patterns:
|
||
- attributes:
|
||
attributes:
|
||
api.operation:
|
||
stringValue: findPets
|
||
httpMethod: GET
|
||
uriTemplate: /api/pets
|
||
- attributes:
|
||
attributes:
|
||
api.operation:
|
||
stringValue: addPet
|
||
httpMethod: POST
|
||
uriTemplate: /api/pets
|
||
- attributes:
|
||
attributes:
|
||
api.operation:
|
||
stringValue: findPetById
|
||
httpMethod: GET
|
||
uriTemplate: /api/pets/{id}
|
||
- attributes:
|
||
attributes:
|
||
api.operation:
|
||
stringValue: deletePet
|
||
httpMethod: DELETE
|
||
uriTemplate: /api/pets/{id}
|
||
apiKeys:
|
||
- query: api-key
|
||
</code></pre><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=HTTPAPISpec-attributes><td><code>attributes</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>List of attributes that are generated when <em>any</em> of the HTTP
|
||
patterns match. This list typically includes the “api.service”
|
||
and “api.version” attributes.</p></td><td>No</td></tr><tr id=HTTPAPISpec-patterns><td><code>patterns</code></td><td><code><a href=#HTTPAPISpecPattern>HTTPAPISpecPattern[]</a></code></td><td><p>List of HTTP patterns to match.</p></td><td>No</td></tr><tr id=HTTPAPISpec-api_keys><td><code>apiKeys</code></td><td><code><a href=#APIKey>APIKey[]</a></code></td><td><p>List of APIKey that describes how to extract an API-KEY from an
|
||
HTTP request. The first API-Key match found in the list is used,
|
||
i.e. ‘OR’ semantics.</p><p>The following default policies are used to generate the
|
||
<code>request.api_key</code> attribute if no explicit APIKey is defined.</p><pre><code>`query: key, `query: api_key`, and then `header: x-api-key`
|
||
</code></pre></td><td>No</td></tr></tbody></table></section><h2 id=HTTPAPISpecBinding>HTTPAPISpecBinding</h2><section><p>HTTPAPISpecBinding defines the binding between HTTPAPISpecs and one or more
|
||
IstioService. For example, the following establishes a binding
|
||
between the HTTPAPISpec <code>petstore</code> and service <code>foo</code> in namespace <code>bar</code>.</p><pre><code class=language-yaml>apiVersion: config.istio.io/v1alpha2
|
||
kind: HTTPAPISpecBinding
|
||
metadata:
|
||
name: my-binding
|
||
namespace: default
|
||
spec:
|
||
services:
|
||
- name: foo
|
||
namespace: bar
|
||
apiSpecs:
|
||
- name: petstore
|
||
namespace: default
|
||
</code></pre><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=HTTPAPISpecBinding-services><td><code>services</code></td><td><code><a href=#IstioService>IstioService[]</a></code></td><td><p>One or more services to map the listed HTTPAPISpec onto.</p></td><td>Yes</td></tr><tr id=HTTPAPISpecBinding-api_specs><td><code>apiSpecs</code></td><td><code><a href=#HTTPAPISpecReference>HTTPAPISpecReference[]</a></code></td><td><p>One or more HTTPAPISpec references that should be mapped to
|
||
the specified service(s). The aggregate collection of match
|
||
conditions defined in the HTTPAPISpecs should not overlap.</p></td><td>Yes</td></tr></tbody></table></section><h2 id=HTTPAPISpecPattern>HTTPAPISpecPattern</h2><section><p>HTTPAPISpecPattern defines a single pattern to match against
|
||
incoming HTTP requests. The per-pattern list of attributes is
|
||
generated if both the http<em>method and uri</em>template match. In
|
||
addition, the top-level list of attributes in the HTTPAPISpec is also
|
||
generated.</p><pre><code class=language-yaml>pattern:
|
||
- attributes
|
||
api.operation: doFooBar
|
||
httpMethod: GET
|
||
uriTemplate: /foo/bar
|
||
</code></pre><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=HTTPAPISpecPattern-attributes><td><code>attributes</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>List of attributes that are generated if the HTTP request matches
|
||
the specified http<em>method and uri</em>template. This typically
|
||
includes the “api.operation” attribute.</p></td><td>No</td></tr><tr id=HTTPAPISpecPattern-http_method><td><code>httpMethod</code></td><td><code>string</code></td><td><p>HTTP request method to match against as defined by
|
||
<a href=https://tools.ietf.org/html/rfc7231#page-21>rfc7231</a>. For
|
||
example: GET, HEAD, POST, PUT, DELETE.</p></td><td>No</td></tr><tr id=HTTPAPISpecPattern-uri_template class="oneof oneof-start"><td><code>uriTemplate</code></td><td><code>string (oneof)</code></td><td><p>URI template to match against as defined by
|
||
<a href=https://tools.ietf.org/html/rfc6570>rfc6570</a>. For example, the
|
||
following are valid URI templates:</p><pre><code>/pets
|
||
/pets/{id}
|
||
/dictionary/{term:1}/{term}
|
||
/search{?q*,lang}
|
||
</code></pre></td><td>Yes</td></tr><tr id=HTTPAPISpecPattern-regex class=oneof><td><code>regex</code></td><td><code>string (oneof)</code></td><td><p>EXPERIMENTAL:</p><p>ecmascript style regex-based match as defined by
|
||
<a href=http://en.cppreference.com/w/cpp/regex>EDCA-262</a>. For
|
||
example,</p><pre><code>"^/pets/(.*?)?"
|
||
</code></pre></td><td>Yes</td></tr></tbody></table></section><h2 id=HTTPAPISpecReference>HTTPAPISpecReference</h2><section><p>HTTPAPISpecReference defines a reference to an HTTPAPISpec. This is
|
||
typically used for establishing bindings between an HTTPAPISpec and an
|
||
IstioService. For example, the following defines an
|
||
HTTPAPISpecReference for service <code>foo</code> in namespace <code>bar</code>.</p><pre><code class=language-yaml>- name: foo
|
||
namespace: bar
|
||
</code></pre><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=HTTPAPISpecReference-name><td><code>name</code></td><td><code>string</code></td><td><p>The short name of the HTTPAPISpec. This is the resource
|
||
name defined by the metadata name field.</p></td><td>Yes</td></tr><tr id=HTTPAPISpecReference-namespace><td><code>namespace</code></td><td><code>string</code></td><td><p>Optional namespace of the HTTPAPISpec. Defaults to the encompassing
|
||
HTTPAPISpecBinding’s metadata namespace field.</p></td><td>No</td></tr></tbody></table></section><h2 id=HttpClientConfig>HttpClientConfig</h2><section><p>Defines the client config for HTTP.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=HttpClientConfig-transport><td><code>transport</code></td><td><code><a href=#TransportConfig>TransportConfig</a></code></td><td><p>The transport config.</p></td><td>No</td></tr><tr id=HttpClientConfig-service_configs><td><code>serviceConfigs</code></td><td><code>map<string, <a href=#ServiceConfig>ServiceConfig</a>></code></td><td><p>Map of control configuration indexed by destination.service. This
|
||
is used to support per-service configuration for cases where a
|
||
mixerclient serves multiple services.</p></td><td>No</td></tr><tr id=HttpClientConfig-default_destination_service><td><code>defaultDestinationService</code></td><td><code>string</code></td><td><p>Default destination service name if none was specified in the
|
||
client request.</p></td><td>No</td></tr><tr id=HttpClientConfig-mixer_attributes><td><code>mixerAttributes</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>Default attributes to send to Mixer in both Check and
|
||
Report. This typically includes “destination.ip” and
|
||
“destination.uid” attributes.</p></td><td>No</td></tr><tr id=HttpClientConfig-forward_attributes><td><code>forwardAttributes</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>Default attributes to forward to upstream. This typically
|
||
includes the “source.ip” and “source.uid” attributes.</p></td><td>No</td></tr><tr id=HttpClientConfig-ignore_forwarded_attributes><td><code>ignoreForwardedAttributes</code></td><td><code>bool</code></td><td><p>Whether or not to use attributes forwarded in the request headers to
|
||
create the attribute bag to send to mixer. For intra-mesh traffic,
|
||
this should be set to “false”. For ingress/egress gateways, this
|
||
should be set to “true”.</p></td><td>No</td></tr></tbody></table></section><h2 id=IstioService>IstioService</h2><section><p>IstioService identifies a service and optionally service version.
|
||
The FQDN of the service is composed from the name, namespace, and implementation-specific domain suffix
|
||
(e.g. on Kubernetes, “reviews” + “default” + “svc.cluster.local” -> “reviews.default.svc.cluster.local”).</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=IstioService-name><td><code>name</code></td><td><code>string</code></td><td><p>The short name of the service such as “foo”.</p></td><td>No</td></tr><tr id=IstioService-namespace><td><code>namespace</code></td><td><code>string</code></td><td><p>Optional namespace of the service. Defaults to value of metadata namespace field.</p></td><td>No</td></tr><tr id=IstioService-domain><td><code>domain</code></td><td><code>string</code></td><td><p>Domain suffix used to construct the service FQDN in implementations that support such specification.</p></td><td>No</td></tr><tr id=IstioService-service><td><code>service</code></td><td><code>string</code></td><td><p>The service FQDN.</p></td><td>No</td></tr><tr id=IstioService-labels><td><code>labels</code></td><td><code>map<string, string></code></td><td><p>Optional one or more labels that uniquely identify the service version.</p><p><em>Note:</em> When used for a VirtualService destination, labels MUST be empty.</p></td><td>No</td></tr></tbody></table></section><h2 id=NetworkFailPolicy>NetworkFailPolicy</h2><section><p>Specifies the behavior when the client is unable to connect to Mixer.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=NetworkFailPolicy-policy><td><code>policy</code></td><td><code><a href=#NetworkFailPolicy-FailPolicy>FailPolicy</a></code></td><td><p>Specifies the behavior when the client is unable to connect to Mixer.</p></td><td>No</td></tr><tr id=NetworkFailPolicy-max_retry><td><code>maxRetry</code></td><td><code>uint32</code></td><td><p>Max retries on transport error.</p></td><td>No</td></tr><tr id=NetworkFailPolicy-base_retry_wait><td><code>baseRetryWait</code></td><td><code><a href=https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration>Duration</a></code></td><td><p>Base time to wait between retries. Will be adjusted by exponential
|
||
backoff and jitter.</p></td><td>No</td></tr><tr id=NetworkFailPolicy-max_retry_wait><td><code>maxRetryWait</code></td><td><code><a href=https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration>Duration</a></code></td><td><p>Max time to wait between retries.</p></td><td>No</td></tr></tbody></table></section><h2 id=NetworkFailPolicy-FailPolicy>NetworkFailPolicy.FailPolicy</h2><section><p>Describes the policy.</p><table class=enum-values><thead><tr><th>Name</th><th>Description</th></tr></thead><tbody><tr id=NetworkFailPolicy-FailPolicy-FAIL_OPEN><td><code>FAIL_OPEN</code></td><td><p>If network connection fails, request is allowed and delivered to the
|
||
service.</p></td></tr><tr id=NetworkFailPolicy-FailPolicy-FAIL_CLOSE><td><code>FAIL_CLOSE</code></td><td><p>If network connection fails, request is rejected.</p></td></tr></tbody></table></section><h2 id=Quota>Quota</h2><section><p>Specifies a quota to use with quota name and amount.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=Quota-quota><td><code>quota</code></td><td><code>string</code></td><td><p>The quota name to charge</p></td><td>No</td></tr><tr id=Quota-charge><td><code>charge</code></td><td><code>int32</code></td><td><p>The quota amount to charge</p></td><td>No</td></tr></tbody></table></section><h2 id=QuotaRule>QuotaRule</h2><section><p>Specifies a rule with list of matches and list of quotas.
|
||
If any clause matched, the list of quotas will be used.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=QuotaRule-match><td><code>match</code></td><td><code><a href=#AttributeMatch>AttributeMatch[]</a></code></td><td><p>If empty, match all request.
|
||
If any of match is true, it is matched.</p></td><td>No</td></tr><tr id=QuotaRule-quotas><td><code>quotas</code></td><td><code><a href=#Quota>Quota[]</a></code></td><td><p>The list of quotas to charge.</p></td><td>No</td></tr></tbody></table></section><h2 id=QuotaSpec>QuotaSpec</h2><section><p>Determines the quotas used for individual requests.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=QuotaSpec-rules><td><code>rules</code></td><td><code><a href=#QuotaRule>QuotaRule[]</a></code></td><td><p>A list of Quota rules.</p></td><td>No</td></tr></tbody></table></section><h2 id=QuotaSpecBinding>QuotaSpecBinding</h2><section><p>QuotaSpecBinding defines the binding between QuotaSpecs and one or more
|
||
IstioService.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=QuotaSpecBinding-services><td><code>services</code></td><td><code><a href=#IstioService>IstioService[]</a></code></td><td><p>One or more services to map the listed QuotaSpec onto.</p></td><td>Yes</td></tr><tr id=QuotaSpecBinding-quota_specs><td><code>quotaSpecs</code></td><td><code><a href=#QuotaSpecBinding-QuotaSpecReference>QuotaSpecReference[]</a></code></td><td><p>One or more QuotaSpec references that should be mapped to
|
||
the specified service(s). The aggregate collection of match
|
||
conditions defined in the QuotaSpecs should not overlap.</p></td><td>Yes</td></tr></tbody></table></section><h2 id=QuotaSpecBinding-QuotaSpecReference>QuotaSpecBinding.QuotaSpecReference</h2><section><p>QuotaSpecReference uniquely identifies the QuotaSpec used in the
|
||
Binding.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=QuotaSpecBinding-QuotaSpecReference-name><td><code>name</code></td><td><code>string</code></td><td><p>The short name of the QuotaSpec. This is the resource
|
||
name defined by the metadata name field.</p></td><td>Yes</td></tr><tr id=QuotaSpecBinding-QuotaSpecReference-namespace><td><code>namespace</code></td><td><code>string</code></td><td><p>Optional namespace of the QuotaSpec. Defaults to the value of the
|
||
metadata namespace field.</p></td><td>No</td></tr></tbody></table></section><h2 id=ServiceConfig>ServiceConfig</h2><section><p>Defines the per-service client configuration.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=ServiceConfig-disable_check_calls><td><code>disableCheckCalls</code></td><td><code>bool</code></td><td><p>If true, do not call Mixer Check.</p></td><td>No</td></tr><tr id=ServiceConfig-disable_report_calls><td><code>disableReportCalls</code></td><td><code>bool</code></td><td><p>If true, do not call Mixer Report.</p></td><td>No</td></tr><tr id=ServiceConfig-mixer_attributes><td><code>mixerAttributes</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>Send these attributes to Mixer in both Check and Report. This
|
||
typically includes the “destination.service” attribute.
|
||
In case of a per-route override, per-route attributes take precedence
|
||
over the attributes supplied in the client configuration.</p></td><td>No</td></tr><tr id=ServiceConfig-http_api_spec><td><code>httpApiSpec</code></td><td><code><a href=#HTTPAPISpec>HTTPAPISpec[]</a></code></td><td><p>HTTP API specifications to generate API attributes.</p></td><td>No</td></tr><tr id=ServiceConfig-quota_spec><td><code>quotaSpec</code></td><td><code><a href=#QuotaSpec>QuotaSpec[]</a></code></td><td><p>Quota specifications to generate quota requirements.</p></td><td>No</td></tr><tr id=ServiceConfig-network_fail_policy><td><code>networkFailPolicy</code></td><td><code><a href=#NetworkFailPolicy>NetworkFailPolicy</a></code></td><td><p>Specifies the behavior when the client is unable to connect to Mixer.
|
||
This is the service-level policy. It overrides
|
||
[mesh-level
|
||
policy][istio.mixer.v1.config.client.TransportConfig.network<em>fail</em>policy].</p></td><td>No</td></tr><tr id=ServiceConfig-forward_attributes><td><code>forwardAttributes</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>Default attributes to forward to upstream. This typically
|
||
includes the “source.ip” and “source.uid” attributes.
|
||
In case of a per-route override, per-route attributes take precedence
|
||
over the attributes supplied in the client configuration.</p><p>Forwarded attributes take precedence over the static Mixer attributes,
|
||
except in cases where there is clear configuration to ignore forwarded
|
||
attributes. Gateways, for instance, should never use forwarded attributes.</p><p>The full order of application is as follows:
|
||
1. static Mixer attributes from the filter config;
|
||
2. static Mixer attributes from the route config;
|
||
3. forwarded attributes from the source filter config (if any and not ignored);
|
||
4. forwarded attributes from the source route config (if any and not ignored);
|
||
5. derived attributes from the request metadata.</p></td><td>No</td></tr></tbody></table></section><h2 id=StringMatch>StringMatch</h2><section><p>Describes how to match a given string in HTTP headers. Match is
|
||
case-sensitive.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=StringMatch-exact class="oneof oneof-start"><td><code>exact</code></td><td><code>string (oneof)</code></td><td><p>exact string match</p></td><td>Yes</td></tr><tr id=StringMatch-prefix class=oneof><td><code>prefix</code></td><td><code>string (oneof)</code></td><td><p>prefix-based match</p></td><td>Yes</td></tr><tr id=StringMatch-regex class=oneof><td><code>regex</code></td><td><code>string (oneof)</code></td><td><p>ECMAscript style regex-based match</p></td><td>Yes</td></tr></tbody></table></section><h2 id=TcpClientConfig>TcpClientConfig</h2><section><p>Defines the client config for TCP.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=TcpClientConfig-transport><td><code>transport</code></td><td><code><a href=#TransportConfig>TransportConfig</a></code></td><td><p>The transport config.</p></td><td>No</td></tr><tr id=TcpClientConfig-mixer_attributes><td><code>mixerAttributes</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>Default attributes to send to Mixer in both Check and
|
||
Report. This typically includes “destination.ip” and
|
||
“destination.uid” attributes.</p></td><td>No</td></tr><tr id=TcpClientConfig-disable_check_calls><td><code>disableCheckCalls</code></td><td><code>bool</code></td><td><p>If set to true, disables Mixer check calls.</p></td><td>No</td></tr><tr id=TcpClientConfig-disable_report_calls><td><code>disableReportCalls</code></td><td><code>bool</code></td><td><p>If set to true, disables Mixer check calls.</p></td><td>No</td></tr><tr id=TcpClientConfig-connection_quota_spec><td><code>connectionQuotaSpec</code></td><td><code><a href=#QuotaSpec>QuotaSpec</a></code></td><td><p>Quota specifications to generate quota requirements.
|
||
It applies on the new TCP connections.</p></td><td>No</td></tr><tr id=TcpClientConfig-report_interval><td><code>reportInterval</code></td><td><code><a href=https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration>Duration</a></code></td><td><p>Specify report interval to send periodical reports for long TCP
|
||
connections. If not specified, the interval is 10 seconds. This interval
|
||
should not be less than 1 second, otherwise it will be reset to 1 second.</p></td><td>No</td></tr></tbody></table></section><h2 id=TransportConfig>TransportConfig</h2><section><p>Defines the transport config on how to call Mixer.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=TransportConfig-disable_check_cache><td><code>disableCheckCache</code></td><td><code>bool</code></td><td><p>The flag to disable check cache.</p></td><td>No</td></tr><tr id=TransportConfig-disable_quota_cache><td><code>disableQuotaCache</code></td><td><code>bool</code></td><td><p>The flag to disable quota cache.</p></td><td>No</td></tr><tr id=TransportConfig-disable_report_batch><td><code>disableReportBatch</code></td><td><code>bool</code></td><td><p>The flag to disable report batch.</p></td><td>No</td></tr><tr id=TransportConfig-network_fail_policy><td><code>networkFailPolicy</code></td><td><code><a href=#NetworkFailPolicy>NetworkFailPolicy</a></code></td><td><p>Specifies the behavior when the client is unable to connect to Mixer.
|
||
This is the mesh level policy. The default value for policy is FAIL_OPEN.</p></td><td>No</td></tr><tr id=TransportConfig-stats_update_interval><td><code>statsUpdateInterval</code></td><td><code><a href=https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration>Duration</a></code></td><td><p>Specify refresh interval to write Mixer client statistics to Envoy share
|
||
memory. If not specified, the interval is 10 seconds.</p></td><td>No</td></tr><tr id=TransportConfig-check_cluster><td><code>checkCluster</code></td><td><code>string</code></td><td><p>Name of the cluster that will forward check calls to a pool of mixer
|
||
servers. Defaults to “mixer_server”. By using different names for
|
||
checkCluster and reportCluster, it is possible to have one set of
|
||
Mixer servers handle check calls, while another set of Mixer servers
|
||
handle report calls.</p><p>NOTE: Any value other than the default “mixer_server” will require the
|
||
Istio Grafana dashboards to be reconfigured to use the new name.</p></td><td>No</td></tr><tr id=TransportConfig-report_cluster><td><code>reportCluster</code></td><td><code>string</code></td><td><p>Name of the cluster that will forward report calls to a pool of mixer
|
||
servers. Defaults to “mixer_server”. By using different names for
|
||
checkCluster and reportCluster, it is possible to have one set of
|
||
Mixer servers handle check calls, while another set of Mixer servers
|
||
handle report calls.</p><p>NOTE: Any value other than the default “mixer_server” will require the
|
||
Istio Grafana dashboards to be reconfigured to use the new name.</p></td><td>No</td></tr><tr id=TransportConfig-attributes_for_mixer_proxy><td><code>attributesForMixerProxy</code></td><td><code><a href=#istio-mixer-v1-Attributes>Attributes</a></code></td><td><p>Default attributes to forward to Mixer upstream. This typically
|
||
includes the “source.ip” and “source.uid” attributes. These
|
||
attributes are consumed by the proxy in front of mixer.</p></td><td>No</td></tr><tr id=TransportConfig-report_batch_max_entries><td><code>reportBatchMaxEntries</code></td><td><code>uint32</code></td><td><p>When disable<em>report</em>batch is false, this value specifies the maximum number
|
||
of requests that are batched in report. If left unspecified, the default value
|
||
of report<em>batch</em>max_entries == 0 will use the hardcoded defaults of
|
||
istio::mixerclient::ReportOptions.</p></td><td>No</td></tr><tr id=TransportConfig-report_batch_max_time><td><code>reportBatchMaxTime</code></td><td><code><a href=https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#duration>Duration</a></code></td><td><p>When disable<em>report</em>batch is false, this value specifies the maximum elapsed
|
||
time a batched report will be sent after a user request is processed. If left
|
||
unspecified, the default report<em>batch</em>max_time == 0 will use the hardcoded
|
||
defaults of istio::mixerclient::ReportOptions.</p></td><td>No</td></tr></tbody></table></section><h2 id=istio-mixer-v1-Attributes>istio.mixer.v1.Attributes</h2><section><p>Attributes represents a set of typed name/value pairs. Many of Mixer’s
|
||
API either consume and/or return attributes.</p><p>Istio uses attributes to control the runtime behavior of services running in the service mesh.
|
||
Attributes are named and typed pieces of metadata describing ingress and egress traffic and the
|
||
environment this traffic occurs in. An Istio attribute carries a specific piece
|
||
of information such as the error code of an API request, the latency of an API request, or the
|
||
original IP address of a TCP connection. For example:</p><pre><code class=language-yaml>request.path: xyz/abc
|
||
request.size: 234
|
||
request.time: 12:34:56.789 04/17/2017
|
||
source.ip: 192.168.0.1
|
||
target.service: example
|
||
</code></pre><p>A given Istio deployment has a fixed vocabulary of attributes that it understands.
|
||
The specific vocabulary is determined by the set of attribute producers being used
|
||
in the deployment. The primary attribute producer in Istio is Envoy, although
|
||
specialized Mixer adapters and services can also generate attributes.</p><p>The common baseline set of attributes available in most Istio deployments is defined
|
||
<a href=/v1.12/zh/docs/reference/config/policy-and-telemetry/attribute-vocabulary/>here</a>.</p><p>Attributes are strongly typed. The supported attribute types are defined by
|
||
<a href=https://github.com/istio/api/blob/release-1.4/policy/v1beta1/value_type.proto>ValueType</a>.
|
||
Each type of value is encoded into one of the so-called transport types present
|
||
in this message.</p><p>Defines a map of attributes in uncompressed format.
|
||
Following places may use this message:
|
||
1) Configure Istio/Proxy with static per-proxy attributes, such as source.uid.
|
||
2) Service IDL definition to extract api attributes for active requests.
|
||
3) Forward attributes from client proxy to server proxy for HTTP requests.</p><table class=message-fields><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr id=istio-mixer-v1-Attributes-attributes><td><code>attributes</code></td><td><code>map<string, <a href=#istio-mixer-v1-Attributes-AttributeValue>AttributeValue</a>></code></td><td><p>A map of attribute name to its value.</p></td><td>No</td></tr></tbody></table></section></article><nav class=pagenav><div class=left><a title="通过 Mixer 从 Istio 导出的默认监控指标。" href=/v1.12/zh/docs/reference/config/policy-and-telemetry/metrics/ class=next-link><svg class="icon left-arrow"><use xlink:href="/v1.12/img/icons.svg#left-arrow"/></svg>默认监控指标</a></div><div class=right><a title="Describes the rules used to configure Mixer's policy and telemetry features." href=/v1.12/zh/docs/reference/config/policy-and-telemetry/istio.policy.v1beta1/ class=next-link>Rules<svg class="icon right-arrow"><use xlink:href="/v1.12/img/icons.svg#right-arrow"/></svg></a></div></nav><div id=feedback><div id=feedback-initial>这些信息有用吗？<br><button class="btn feedback" onclick="sendFeedback('zh',1)">是的</button>
|
||
<button class="btn feedback" onclick="sendFeedback('zh',0)">没有</button></div><div id=feedback-comment>Do you have any suggestions for improvement?<br><br><input id=feedback-textbox type=text placeholder="Help us improve..." data-lang=zh></div><div id=feedback-thankyou>Thanks for your feedback!</div></div><div id=endnotes-container aria-hidden=true><h2>链接</h2><ol id=endnotes></ol></div></div><div class=toc-container><nav class=toc aria-label="Table of Contents"><div id=toc><ol><li role=none aria-label=APIKey><a href=#APIKey>APIKey</a><li role=none aria-label=AttributeMatch><a href=#AttributeMatch>AttributeMatch</a><li role=none aria-label=HTTPAPISpec><a href=#HTTPAPISpec>HTTPAPISpec</a><li role=none aria-label=HTTPAPISpecBinding><a href=#HTTPAPISpecBinding>HTTPAPISpecBinding</a><li role=none aria-label=HTTPAPISpecPattern><a href=#HTTPAPISpecPattern>HTTPAPISpecPattern</a><li role=none aria-label=HTTPAPISpecReference><a href=#HTTPAPISpecReference>HTTPAPISpecReference</a><li role=none aria-label=HttpClientConfig><a href=#HttpClientConfig>HttpClientConfig</a><li role=none aria-label=IstioService><a href=#IstioService>IstioService</a><li role=none aria-label=NetworkFailPolicy><a href=#NetworkFailPolicy>NetworkFailPolicy</a><li role=none aria-label=NetworkFailPolicy.FailPolicy><a href=#NetworkFailPolicy-FailPolicy>NetworkFailPolicy.FailPolicy</a><li role=none aria-label=Quota><a href=#Quota>Quota</a><li role=none aria-label=QuotaRule><a href=#QuotaRule>QuotaRule</a><li role=none aria-label=QuotaSpec><a href=#QuotaSpec>QuotaSpec</a><li role=none aria-label=QuotaSpecBinding><a href=#QuotaSpecBinding>QuotaSpecBinding</a><li role=none aria-label=QuotaSpecBinding.QuotaSpecReference><a href=#QuotaSpecBinding-QuotaSpecReference>QuotaSpecBinding.QuotaSpecReference</a><li role=none aria-label=ServiceConfig><a href=#ServiceConfig>ServiceConfig</a><li role=none aria-label=StringMatch><a href=#StringMatch>StringMatch</a><li role=none aria-label=TcpClientConfig><a href=#TcpClientConfig>TcpClientConfig</a><li role=none aria-label=TransportConfig><a href=#TransportConfig>TransportConfig</a><li role=none aria-label=istio.mixer.v1.Attributes><a href=#istio-mixer-v1-Attributes>istio.mixer.v1.Attributes</a></ol></div></nav></div></main><footer class=footer><div class="footer-wrapper container-l"><div class="user-links footer-links"><a class=channel title="Istio 的代码在 GitHub 上开发" href=https://github.com/istio/community aria-label=GitHub><svg class="icon github"><use xlink:href="/v1.12/img/icons.svg#github"/></svg></a><a class=channel title="如果您想深入了解 Istio 的技术细节，请查看我们日益完善的设计文档" href=https://groups.google.com/forum/#!forum/istio-team-drive-access aria-label="team drive"><svg class="icon drive"><use xlink:href="/v1.12/img/icons.svg#drive"/></svg></a><a class=channel title="在 Slack 上与 Istio 社区交互讨论开发问题（仅限邀请）" href=https://slack.istio.io aria-label=slack><svg class="icon slack"><use xlink:href="/v1.12/img/icons.svg#slack"/></svg></a><a class=channel title="Stack Overflow 中列举了针对实际问题以及部署、配置和使用 Istio 的各项回答" href=https://stackoverflow.com/questions/tagged/istio aria-label="Stack Overflow"><svg class="icon stackoverflow"><use xlink:href="/v1.12/img/icons.svg#stackoverflow"/></svg></a><a class=channel title="关注我们的 Twitter 来获取最新信息" href=https://twitter.com/IstioMesh aria-label=Twitter><svg class="icon twitter"><use xlink:href="/v1.12/img/icons.svg#twitter"/></svg></a></div><hr class=footer-separator role=separator><div class="info footer-info"><a class=logo href=/v1.12/zh/><svg xmlns="http://www.w3.org/2000/svg" width="128" height="60" viewBox="0 0 128 60"><path d="M58.434 48.823A.441.441.0 0158.3 48.497V22.583a.444.444.0 01.134-.326.446.446.0 01.327-.134h3.527a.447.447.0 01.325.134.447.447.0 01.134.326v25.914a.443.443.0 01-.134.326.444.444.0 01-.325.134h-3.527a.444.444.0 01-.327-.134z"/><path d="m70.969 48.477a6.556 6.556.0 01-2.818-1.955 4.338 4.338.0 01-1-2.78v-.345a.443.443.0 01.134-.326.444.444.0 01.326-.135h3.374a.444.444.0 01.326.135.445.445.0 01.134.326v.077a2.014 2.014.0 001.054 1.667 4.672 4.672.0 002.664.709 4.446 4.446.0 002.492-.633 1.862 1.862.0 00.958-1.591 1.426 1.426.0 00-.786-1.322 12.7 12.7.0 00-2.549-.939l-1.457-.46a21.526 21.526.0 01-3.3-1.227 6.57 6.57.0 01-2.262-1.783 4.435 4.435.0 01-.92-2.894 5.081 5.081.0 012.109-4.275 8.993 8.993.0 015.558-1.591 10.445 10.445.0 014.1.748 6.3 6.3.0 012.722 2.07 5 5 0 01.958 3.009.441.441.0 01-.134.326.441.441.0 01-.325.134h-3.258a.441.441.0 01-.326-.134.443.443.0 01-.134-.326 1.974 1.974.0 00-.978-1.667 4.647 4.647.0 00-2.665-.671 4.741 4.741.0 00-2.435.556 1.724 1.724.0 00-.938 1.553 1.512 1.512.0 00.9 1.4 15.875 15.875.0 003.01 1.055l.843.229a27.368 27.368.0 013.412 1.246 6.67 6.67.0 012.338 1.763 4.387 4.387.0 01.958 2.933 4.988 4.988.0 01-2.146 4.275 9.543 9.543.0 01-5.712 1.552 11.626 11.626.0 01-4.227-.709z"/><path d="m97.039 32.837a.443.443.0 01-.326.135h-3.911a.169.169.0 00-.191.192v9.239a2.951 2.951.0 00.632 2.108 2.7 2.7.0 002.013.652h1.15a.444.444.0 01.325.134.441.441.0 01.134.326v2.875a.471.471.0 01-.459.5l-1.994.039a8 8 0 01-4.524-1.035q-1.495-1.035-1.533-3.91V33.166A.17.17.0 0088.164 32.974H85.978A.441.441.0 0185.652 32.839.441.441.0 0185.518 32.513V29.83a.441.441.0 01.134-.326.444.444.0 01.326-.135h2.186a.169.169.0 00.191-.192v-4.485a.438.438.0 01.134-.326.44.44.0 01.325-.134h3.336a.443.443.0 01.325.134.442.442.0 01.135.326v4.485a.169.169.0 00.191.192h3.911a.446.446.0 01.326.135.446.446.0 01.134.326v2.683a.446.446.0 01-.133.324z"/><path d="m101.694 25.917a2.645 2.645.0 01-.767-1.955 2.65 2.65.0 01.767-1.955 2.65 2.65.0 011.955-.767 2.65 2.65.0 011.955.767 2.652 2.652.0 01.767 1.955 2.647 2.647.0 01-.767 1.955 2.646 2.646.0 01-1.955.767 2.645 2.645.0 01-1.955-.767zm-.211 22.906a.441.441.0 01-.134-.326V29.79a.444.444.0 01.134-.326.446.446.0 01.326-.134h3.527a.446.446.0 01.326.134.445.445.0 01.134.326v18.707a.443.443.0 01-.134.326.443.443.0 01-.326.134h-3.527a.443.443.0 01-.326-.134z"/><path d="m114.019 47.734a8.1 8.1.0 01-3.047-4.255 14.439 14.439.0 01-.652-4.37 14.3 14.3.0 01.614-4.371 7.869 7.869.0 013.066-4.178 9.072 9.072.0 015.252-1.5 8.543 8.543.0 015.041 1.5 7.985 7.985.0 013.009 4.14 12.439 12.439.0 01.69 4.37 13.793 13.793.0 01-.651 4.37 8.255 8.255.0 01-3.028 4.275 8.475 8.475.0 01-5.1 1.553 8.754 8.754.0 01-5.194-1.534zm7.629-3.1a4.536 4.536.0 001.476-2.262 11.335 11.335.0 00.383-3.221 10.618 10.618.0 00-.383-3.22 4.169 4.169.0 00-1.457-2.243 4.066 4.066.0 00-2.531-.785 3.942 3.942.0 00-2.453.785 4.376 4.376.0 00-1.5 2.243 11.839 11.839.0 00-.383 3.22 11.84 11.84.0 00.383 3.221 4.222 4.222.0 001.476 2.262 4.075 4.075.0 002.549.8 3.8 3.8.0 002.44-.809z"/><path d="m15.105 32.057v15.565a.059.059.0 01-.049.059L.069 50.25A.06.06.0 01.005 50.167l14.987-33.47a.06.06.0 01.114.025z"/><path d="m17.631 23.087v24.6a.06.06.0 00.053.059l22.449 2.507a.06.06.0 00.061-.084L17.745.032a.06.06.0 00-.114.024z"/><path d="m39.961 52.548-24.833 7.45a.062.062.0 01-.043.0L.079 52.548a.059.059.0 01.026-.113h39.839a.06.06.0 01.017.113z"/></svg></a><div class=footer-languages><a tabindex=-1 role=menuitem lang=en id=switch-lang-en class=footer-languages-item>English</a>
|
||
<a tabindex=-1 role=menuitem lang=zh id=switch-lang-zh class="footer-languages-item active"><svg class="icon tick"><use xlink:href="/v1.12/img/icons.svg#tick"/></svg>中文</a></div></div><ul class=footer-policies><li class=footer-policies-item><a class=footer-policies-link href=https://policies.google.com/privacy>隐私政策</a> |
|
||
<a class=disabled title="这是一个自动生成的文件，要修改其中的内容，请修改 https://github.com/istio/api 仓库中的源码。">在 GitHub 上编辑此页</a></li></ul><div class=footer-base><span class=footer-base-copyright>© 2021 Istio Authors.</span>
|
||
<span class=footer-base-version>部分内容可能滞后于英文版本，同步工作正在进行中<br>Version
|
||
Istio 归档
|
||
1.12.3</span><ul class=footer-base-releases><li class=footer-base-releases-item><a tabindex=-1 class=footer-base-releases-link role=menuitem onclick="navigateToUrlOrRoot('https://istio.io/docs\/reference\/config\/policy-and-telemetry\/istio.mixer.v1.config.client\/');return false;">当前版本</a></li><li class=footer-base-releases-item><a tabindex=-1 class=footer-base-releases-link role=menuitem onclick="navigateToUrlOrRoot('https://preliminary.istio.io/docs\/reference\/config\/policy-and-telemetry\/istio.mixer.v1.config.client\/');return false;">下个版本</a></li><li class=footer-base-releases-item><a tabindex=-1 class=footer-base-releases-link role=menuitem href=https://istio.io/archive>旧版本</a></li></ul></div></div></footer><div id=scroll-to-top-container aria-hidden=true><button id=scroll-to-top title=回到顶部><svg class="icon top"><use xlink:href="/v1.12/img/icons.svg#top"/></svg></button></div></body></html> |