diff --git a/content/zh/boilerplates/args.md b/content/zh/boilerplates/args.md new file mode 100644 index 0000000000..2056651bef --- /dev/null +++ b/content/zh/boilerplates/args.md @@ -0,0 +1,20 @@ +--- +--- + +{{< text syntax=plain snip_id=gateway_api_version >}} +{{< k8s_gateway_api_version >}} +{{< /text >}} + +--- +--- + +{{< text syntax=plain snip_id=istio_previous_version >}} +{{< istio_previous_version >}} +{{< /text >}} + +--- +--- + +{{< text syntax=plain snip_id=istio_full_version >}} +{{< istio_full_version >}} +{{< /text >}} diff --git a/content/zh/boilerplates/experimental.md b/content/zh/boilerplates/experimental.md index c14f509fa0..f3d0017e34 100644 --- a/content/zh/boilerplates/experimental.md +++ b/content/zh/boilerplates/experimental.md @@ -1,5 +1,6 @@ --- --- {{< warning >}} -该特性正在积极[研发](https://github.com/istio/community/blob/master/FEATURE-LIFECYCLE.md)中，目前尚处于 `experimental` 阶段。 +该特性正在积极 +[研发](https://github.com/istio/community/blob/master/FEATURE-LIFECYCLE.md)中，目前尚处于 `experimental` 阶段。 {{< /warning >}} diff --git a/content/zh/boilerplates/gateway-api-install-crds.md b/content/zh/boilerplates/gateway-api-install-crds.md index cebc368c32..3e0f9365cf 100644 --- a/content/zh/boilerplates/gateway-api-install-crds.md +++ b/content/zh/boilerplates/gateway-api-install-crds.md @@ -3,6 +3,6 @@ 请注意，Kubernetes Gateway API CRD 不会默认安装在大多数 Kubernetes 集群上，因此请确保在使用 Gateway API 之前已安装好这些 CRD： {{< text syntax=bash snip_id=install_crds >}} -$ kubectl get crd gateways.gateway.networking.k8s.io || \ +$ kubectl get crd gateways.gateway.networking.k8s.io &> /dev/null || \ { kubectl kustomize "github.com/kubernetes-sigs/gateway-api/config/crd?ref={{< k8s_gateway_api_version >}}" | kubectl apply -f -; } {{< /text >}} diff --git a/content/zh/boilerplates/revision-tags-default-intro.md b/content/zh/boilerplates/revision-tags-default-intro.md index 4a92c0615b..3a4b8970d7 100644 --- a/content/zh/boilerplates/revision-tags-default-intro.md +++ b/content/zh/boilerplates/revision-tags-default-intro.md @@ -8,4 +8,4 @@ - 验证 Istio 资源。 - 从非默认的修订版本中窃取 leader 锁并执行单例网格任务（例如更新资源状态）。 -执行以下命令，修改默认版本为 `1-10-0`。 +要将修订版本 `{{< istio_full_version_revision >}}` 设为默认版本，请运行以下命令： diff --git a/content/zh/boilerplates/revision-tags-middle.md b/content/zh/boilerplates/revision-tags-middle.md index ab162dea25..b0d0827ff8 100644 --- a/content/zh/boilerplates/revision-tags-middle.md +++ b/content/zh/boilerplates/revision-tags-middle.md @@ -12,11 +12,11 @@ caption="Two namespaces pointed to prod-stable and one pointed to prod-canary" {{< text bash >}} $ istioctl tag list TAG REVISION NAMESPACES -default 1-9-5 ... -prod-canary 1-10-0 ... -prod-stable 1-9-5 ... +default {{< istio_previous_version_revision >}}-1 ... +prod-canary {{< istio_full_version_revision >}} ... +prod-stable {{< istio_previous_version_revision >}}-1 ... {{< /text >}} 当集群管理员对标记为 `prod-canary` 的控制面、命名空间的稳定性感到满意后， `istio.io/rev=prod-stable` 可以通过修改 `prod-stable` 修订标记来更新， -以指向更新的 `1-10-0` 修订版本。 +以指向更新的 `{{< istio_full_version_revision >}}` 修订版本。 diff --git a/content/zh/boilerplates/revision-tags-prologue.md b/content/zh/boilerplates/revision-tags-prologue.md index 46fe03a71c..553209d68b 100644 --- a/content/zh/boilerplates/revision-tags-prologue.md +++ b/content/zh/boilerplates/revision-tags-prologue.md @@ -4,8 +4,8 @@ {{< image width="90%" link="/zh/docs/setup/upgrade/canary/revision-tags-after.svg" -caption="Namespace labels unchanged but now all namespaces pointed to 1-10-0" +caption="命名空间标签没有变化，但现在所有命名空间都指向 {{< istio_full_version_revision >}}" >}} -当在带有 `prod-stable` 标签的命名空间中重新启动注入工作负载，将导致这些工作负载使用 `1-10-0` 控制平面。 +当在带有 `prod-stable` 标签的命名空间中重新启动注入工作负载，将导致这些工作负载使用 `{{< istio_full_version_revision >}}` 控制平面。 请注意，将工作负载迁移到新版本时不需要重新标记命名空间。 diff --git a/content/zh/boilerplates/revision-tags-usage.md b/content/zh/boilerplates/revision-tags-usage.md index 95f2f20709..7309d2a340 100644 --- a/content/zh/boilerplates/revision-tags-usage.md +++ b/content/zh/boilerplates/revision-tags-usage.md @@ -1,5 +1,5 @@ --- --- -考虑到一个安装了 `1-9-5` 和 `1-10-0` 两个修订版本的集群。集群管理员创建了一个 `prod-stable` 修订标签， -以指向较旧的 `1-9-5` 稳定版本，并创建一个 `prod-canary` 修订标签，用以指向较新的 `1-10-0` 修订版本。 +考虑到一个安装了 `{{< istio_previous_version_revision >}}-1` 和 `{{< istio_full_version_revision >}}` 两个修订版本的集群。集群管理员创建了一个 `prod-stable` 修订标签， +以指向较旧的 `{{< istio_previous_version_revision >}}-1` 稳定版本，并创建一个 `prod-canary` 修订标签，用以指向较新的 `{{< istio_full_version_revision >}}` 修订版本。 可以通过以下命令达到该状态： diff --git a/content/zh/docs/examples/bookinfo/index.md b/content/zh/docs/examples/bookinfo/index.md index 31dbffd773..56cff795e5 100755 --- a/content/zh/docs/examples/bookinfo/index.md +++ b/content/zh/docs/examples/bookinfo/index.md @@ -44,6 +44,8 @@ Bookinfo 应用中的几个微服务是由不同的语言编写的。 如果您还没有开始，请遵循[安装指南](/zh/docs/setup/)完成 Istio 的部署工作。 +{{< boilerplate gateway-api-support >}} + ## 部署应用{#deploying-the-application} 要在 Istio 中运行这一应用，无需对应用自身做出任何改变。 @@ -98,12 +100,12 @@ Bookinfo 应用中的几个微服务是由不同的语言编写的。 {{< text bash >}} $ kubectl get services - NAME CLUSTER-IP EXTERNAL-IP PORT(S) AGE - details 10.0.0.31 9080/TCP 6m - kubernetes 10.0.0.1 443/TCP 7d - productpage 10.0.0.120 9080/TCP 6m - ratings 10.0.0.15 9080/TCP 6m - reviews 10.0.0.170 9080/TCP 6m + NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE + details ClusterIP 10.0.0.31 9080/TCP 6m + kubernetes ClusterIP 10.0.0.1 443/TCP 7d + productpage ClusterIP 10.0.0.120 9080/TCP 6m + ratings ClusterIP 10.0.0.15 9080/TCP 6m + reviews ClusterIP 10.0.0.170 9080/TCP 6m {{< /text >}} 还有： @@ -122,7 +124,7 @@ Bookinfo 应用中的几个微服务是由不同的语言编写的。 1. 要确认 Bookinfo 应用是否正在运行，请在某个 Pod 中用 `curl` 命令对应用发送请求，例如 `ratings`： {{< text bash >}} - $ kubectl exec -it $(kubectl get pod -l app=ratings -o jsonpath='{.items[0].metadata.name}') -c ratings -- curl productpage:9080/productpage | grep -o ".*" + $ kubectl exec "$(kubectl get pod -l app=ratings -o jsonpath='{.items[0].metadata.name}')" -c ratings -- curl -sS productpage:9080/productpage | grep -o ".*" Simple Bookstore App {{< /text >}} @@ -158,6 +160,7 @@ Bookinfo 应用中的几个微服务是由不同的语言编写的。 {{< tab name="Gateway API" category-value="gateway-api" >}} + {{< boilerplate external-loadbalancer-support >}} 使用以下命令创建 [Kubernetes Gateway](https://gateway-api.sigs.k8s.io/api-types/gateway/)： {{< text bash >}} diff --git a/content/zh/docs/reference/glossary/dataplane-mode.md b/content/zh/docs/reference/glossary/dataplane-mode.md new file mode 100644 index 0000000000..51b769b31d --- /dev/null +++ b/content/zh/docs/reference/glossary/dataplane-mode.md @@ -0,0 +1,7 @@ +--- +title: 数据面模式 +test: n/a +--- + +数据平面模式是指[数据平面](/zh/docs/ference/glossary/#data-Plane)使用的是哪种部署模式。 +Istio 当前支持三种模式: [Sidecar](/zh/docs/reference/glossary/#sidecar)、[Ambient](/zh/docs/reference/glossary/#ambient) 和 [proxyless](/zh/docs/reference/glossary/#proxyless)。 diff --git a/content/zh/docs/reference/glossary/sidecar.md b/content/zh/docs/reference/glossary/sidecar.md new file mode 100644 index 0000000000..e60206a1da --- /dev/null +++ b/content/zh/docs/reference/glossary/sidecar.md @@ -0,0 +1,7 @@ +--- +title: Sidecar +test: n/a +--- + +Sidecar 通常是与主应用程序一起运行以提供附加功能的容器。 +在 Istio 中，Sidecar 是一个[数据面模式](/zh/docs/reference/glossary/#data-plane-mode)，它同时运行一个 [Envoy](/zh/Docs/Reference/Glossary/#envoy) 代理 [Pod](/zh/docs/Reference/glossary/#pod)。