From 841b321905af3afa69b69adc5ca471e41761ba0e Mon Sep 17 00:00:00 2001 From: Chunlin Yang Date: Thu, 20 Dec 2018 02:15:06 +0800 Subject: [PATCH] add more protocol (#2965) --- content/docs/setup/kubernetes/spec-requirements/index.md | 2 +- content/help/faq/traffic-management/naming-port-convention.md | 2 +- content_zh/docs/setup/kubernetes/spec-requirements/index.md | 2 +- .../help/faq/traffic-management/naming-port-convention.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/docs/setup/kubernetes/spec-requirements/index.md b/content/docs/setup/kubernetes/spec-requirements/index.md index 9ff7efba38..9aa140297a 100644 --- a/content/docs/setup/kubernetes/spec-requirements/index.md +++ b/content/docs/setup/kubernetes/spec-requirements/index.md @@ -9,7 +9,7 @@ To be a part of the service mesh, pods and services in a Kubernetes cluster must satisfy the following requirements: * _**Named ports**:_ Service ports must be named. The port names must be of - the form `[-]` with _http_, _http2_, _grpc_, _mongo_, or _redis_ + the form `[-]` with `grpc`, `http`, `http2`, `https`, `mongo`, `redis`, `tcp`, `tls` or `udp` as the `` in order to take advantage of Istio's routing features. For example, `name: http2-foo` or `name: http` are valid port names, but `name: http2foo` is not. If the port name does not begin with a recognized diff --git a/content/help/faq/traffic-management/naming-port-convention.md b/content/help/faq/traffic-management/naming-port-convention.md index 55915635fb..7e0e50d105 100644 --- a/content/help/faq/traffic-management/naming-port-convention.md +++ b/content/help/faq/traffic-management/naming-port-convention.md @@ -5,7 +5,7 @@ weight: 50 Named ports: Service ports must be named. -The port names must be of the form `protocol`-`suffix` with http, http2, grpc, mongo, or redis as the `protocol` in order to take advantage of Istio’s routing features. +The port names must be of the form `protocol`-`suffix` with `grpc`, `http`, `http2`, `https`, `mongo`, `redis`, `tcp`, `tls` or `udp` as the `protocol` in order to take advantage of Istio’s routing features. For example, `name: http2-foo` or `name: http` are valid port names, but `name: http2foo` is not. If the port name does not begin with a recognized prefix or if the port is unnamed, traffic on the port will be treated as plain TCP traffic (unless the port explicitly uses Protocol: UDP to signify a UDP port). diff --git a/content_zh/docs/setup/kubernetes/spec-requirements/index.md b/content_zh/docs/setup/kubernetes/spec-requirements/index.md index 47a70694ca..d913c9dc0a 100644 --- a/content_zh/docs/setup/kubernetes/spec-requirements/index.md +++ b/content_zh/docs/setup/kubernetes/spec-requirements/index.md @@ -7,7 +7,7 @@ keywords: [kubernetes,sidecar,sidecar-injection] 要成为服务网格的一部分，Kubernetes 集群中的 Pod 和服务必须满足以下几个要求： -1. **需要给端口正确命名**：服务端口必须进行命名。端口名称只允许是`<协议>[-<后缀>-]`模式，其中`<协议>`部分可选择范围包括 `http`、`http2`、`grpc`、`mongo` 以及 `redis`，Istio 可以通过对这些协议的支持来提供路由能力。例如 `name: http2-foo` 和 `name: http` 都是有效的端口名，但 `name: http2foo` 就是无效的。如果没有给端口进行命名，或者命名没有使用指定前缀，那么这一端口的流量就会被视为普通 TCP 流量（除非[显式](https://kubernetes.io/docs/concepts/services-networking/service/#defining-a-service)的用 `Protocol: UDP` 声明该端口是 UDP 端口）。 +1. **需要给端口正确命名**：服务端口必须进行命名。端口名称只允许是`<协议>[-<后缀>-]`模式，其中`<协议>`部分可选择范围包括 `grpc`、`http`、`http2`、`https`、`mongo`、`redis`、`tcp`、`tls` 以及 `udp`，Istio 可以通过对这些协议的支持来提供路由能力。例如 `name: http2-foo` 和 `name: http` 都是有效的端口名，但 `name: http2foo` 就是无效的。如果没有给端口进行命名，或者命名没有使用指定前缀，那么这一端口的流量就会被视为普通 TCP 流量（除非[显式](https://kubernetes.io/docs/concepts/services-networking/service/#defining-a-service)的用 `Protocol: UDP` 声明该端口是 UDP 端口）。 1. **关联服务**：Pod 必须关联到 [Kubernetes 服务](https://kubernetes.io/docs/concepts/services-networking/service/)，如果一个 Pod 属于多个服务，这些服务不能再同一端口上使用不同协议，例如 HTTP 和 TCP。 1. **Deployment 应带有 `app` 以及 `version` 标签**：在使用 Kubernetes `Deployment` 进行 Pod 部署的时候，建议显式的为 `Deployment` 加上 `app` 以及 `version` 标签。每个 Deployment 都应该有一个有意义的 `app` 标签和一个用于标识 `Deployment` 版本的 `version` 标签。`app` 标签在分布式跟踪的过程中会被用来加入上下文信息。Istio 还会用 `app` 和 `version` 标签来给遥测指标数据加入上下文信息。 1. _**Application UID**_：**不要**使用 ID（UID）值为 **1337** 的用户来运行应用。 \ No newline at end of file diff --git a/content_zh/help/faq/traffic-management/naming-port-convention.md b/content_zh/help/faq/traffic-management/naming-port-convention.md index 32f6560816..0018f2ed7e 100644 --- a/content_zh/help/faq/traffic-management/naming-port-convention.md +++ b/content_zh/help/faq/traffic-management/naming-port-convention.md @@ -5,6 +5,6 @@ weight: 50 命名端口：服务端口必须进行命名。 -为利用 Istio 的路由功能，端口名称必须是 `protocol-suffix` 形式，其中 `protocol` 可为 `http`、`http2`、`grpc`、`mongo` 或 `redis`。 +为利用 Istio 的路由功能，端口名称必须是 `protocol-suffix` 形式，其中 `protocol` 可为 `grpc`、`http`、`http2`、`https`、`mongo`、`redis`、`tcp`、`tls` 或 `udp`。 例如，`name: http2-foo` 或 `name: http` 是有效的端口名称，但 `name:http2foo` 则不是。如果端口名称以不识别的前缀开头，或者端口未命名，则端口上的流量将被视为普通 TCP 流量（除非端口明确指定了使用协议：UDP 表示 UDP 端口）。 \ No newline at end of file