From 8f9a0e7daeee5c0986f82163573054f093cc26eb Mon Sep 17 00:00:00 2001 From: lichuqiang Date: Mon, 9 Oct 2017 16:29:47 +0800 Subject: [PATCH 1/2] translate doc proxies into chinese --- .../cluster-administration/proxies.md | 54 +++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 cn/docs/concepts/cluster-administration/proxies.md diff --git a/cn/docs/concepts/cluster-administration/proxies.md b/cn/docs/concepts/cluster-administration/proxies.md new file mode 100644 index 0000000000..64a981b477 --- /dev/null +++ b/cn/docs/concepts/cluster-administration/proxies.md @@ -0,0 +1,54 @@ +--- +title: Kubernetes中的代理 +--- + +{% capture overview %} +本文讲述了 Kubernetes中所使用的代理。 +{% endcapture %} + +{% capture body %} + +## 代理 + +用户在使用 Kubernetes的过程中可能遇到几种不同的代理（proxy）： + + 1. [kubectl proxy](#directly-accessing-the-rest-api)： + - 运行在用户的桌面或pod中 + - 从本机地址到 Kubernetes apiserver 的代理 + - 客户端到代理使用 HTTP 协议 + - 代理到 apiserver 使用 HTTPS 协议 + - 指向 apiserver + - 添加认证头信息 + 1. [apiserver proxy](#discovering-builtin-services)： + - 是一个建立在 apiserver 内部的“堡垒” + - 将集群外部的用户与群集IP相连接，这些IP是无法通过其他方式访问的 + - 运行在 apiserver 进程内 + - 客户端到代理使用 HTTPS 协议 (如果配置 apiserver 使用 HTTP协议，则使用HTTP协议) + - 通过可用信息进行选择，代理到目的地可能使用HTTP 或 HTTPS协议 + - 可以用来访问 Node、 Pod 或 Service + - 当用来访问 Service 时，会进行负载均衡 + 1. [kube proxy](/docs/concepts/services-networking/service/#ips-and-vips)： + - 在每个节点上运行 + - 代理 UDP 和 TCP + - 不支持 HTTP + - 提供负载均衡能力 + - 只用来访问 Service + 1. apiserver 之前的代理/负载均衡器： + - 在不同集群间的存在形式和实现不同 (如 nginx) + - 位于所有客户端和一个或多个 apiserver 之间 + - 存在多个 apiserver 时，扮演负载均衡器的角色 + 1. 外部服务的云负载均衡器： + - 由一些云供应商提供 (如AWS ELB、 Google Cloud Load Balancer) + - Kubernetes service 为 `LoadBalancer` 类型时自动创建 + - 只使用 UDP/TCP 协议 + - 不同云供应商的实现不同。 + +Kubernetes 用户通常只需要关心前两种类型的代理，集群管理员通常需要确保后面几种类型的代理设置正确。 + +## 请求重定向 + +代理已经取代重定向功能，重定向已被弃用。 + +{% endcapture %} + +{% include templates/concept.md %} From 6581992fd62abc3e6921e1a68363caf8033721f6 Mon Sep 17 00:00:00 2001 From: lichuqiang Date: Tue, 10 Oct 2017 10:04:37 +0800 Subject: [PATCH 2/2] fix incorrect links & format --- .../cluster-administration/proxies.md | 27 ++++++++++++------- .../cluster-administration/proxies.md | 13 +++++++-- 2 files changed, 29 insertions(+), 11 deletions(-) diff --git a/cn/docs/concepts/cluster-administration/proxies.md b/cn/docs/concepts/cluster-administration/proxies.md index 64a981b477..76637b7a58 100644 --- a/cn/docs/concepts/cluster-administration/proxies.md +++ b/cn/docs/concepts/cluster-administration/proxies.md @@ -1,43 +1,52 @@ --- -title: Kubernetes中的代理 +title: Kubernetes 中的代理 --- {% capture overview %} -本文讲述了 Kubernetes中所使用的代理。 +本文讲述了 Kubernetes 中所使用的代理。 {% endcapture %} {% capture body %} ## 代理 -用户在使用 Kubernetes的过程中可能遇到几种不同的代理（proxy）： +用户在使用 Kubernetes 的过程中可能遇到几种不同的代理（proxy）： - 1. [kubectl proxy](#directly-accessing-the-rest-api)： - - 运行在用户的桌面或pod中 + 1. [kubectl proxy](/docs/tasks/access-application-cluster/access-cluster/#directly-accessing-the-rest-api)： + + - 运行在用户的桌面或 pod 中 - 从本机地址到 Kubernetes apiserver 的代理 - 客户端到代理使用 HTTP 协议 - 代理到 apiserver 使用 HTTPS 协议 - 指向 apiserver - 添加认证头信息 - 1. [apiserver proxy](#discovering-builtin-services)： + + 1. [apiserver proxy](/docs/tasks/access-application-cluster/access-cluster/#discovering-builtin-services)： + - 是一个建立在 apiserver 内部的“堡垒” - - 将集群外部的用户与群集IP相连接，这些IP是无法通过其他方式访问的 + - 将集群外部的用户与群集 IP 相连接，这些IP是无法通过其他方式访问的 - 运行在 apiserver 进程内 - - 客户端到代理使用 HTTPS 协议 (如果配置 apiserver 使用 HTTP协议，则使用HTTP协议) - - 通过可用信息进行选择，代理到目的地可能使用HTTP 或 HTTPS协议 + - 客户端到代理使用 HTTPS 协议 (如果配置 apiserver 使用 HTTP 协议，则使用 HTTP 协议) + - 通过可用信息进行选择，代理到目的地可能使用 HTTP 或 HTTPS 协议 - 可以用来访问 Node、 Pod 或 Service - 当用来访问 Service 时，会进行负载均衡 + 1. [kube proxy](/docs/concepts/services-networking/service/#ips-and-vips)： + - 在每个节点上运行 - 代理 UDP 和 TCP - 不支持 HTTP - 提供负载均衡能力 - 只用来访问 Service + 1. apiserver 之前的代理/负载均衡器： + - 在不同集群间的存在形式和实现不同 (如 nginx) - 位于所有客户端和一个或多个 apiserver 之间 - 存在多个 apiserver 时，扮演负载均衡器的角色 + 1. 外部服务的云负载均衡器： + - 由一些云供应商提供 (如AWS ELB、 Google Cloud Load Balancer) - Kubernetes service 为 `LoadBalancer` 类型时自动创建 - 只使用 UDP/TCP 协议 diff --git a/docs/concepts/cluster-administration/proxies.md b/docs/concepts/cluster-administration/proxies.md index 13f73e8bba..6767bea3bf 100644 --- a/docs/concepts/cluster-administration/proxies.md +++ b/docs/concepts/cluster-administration/proxies.md @@ -12,14 +12,17 @@ This page explains proxies used with Kubernetes. There are several different proxies you may encounter when using Kubernetes: - 1. The [kubectl proxy](#directly-accessing-the-rest-api): + 1. The [kubectl proxy](/docs/tasks/access-application-cluster/access-cluster/#directly-accessing-the-rest-api): + - runs on a user's desktop or in a pod - proxies from a localhost address to the Kubernetes apiserver - client to proxy uses HTTP - proxy to apiserver uses HTTPS - locates apiserver - adds authentication headers - 1. The [apiserver proxy](#discovering-builtin-services): + + 1. The [apiserver proxy](/docs/tasks/access-application-cluster/access-cluster/#discovering-builtin-services): + - is a bastion built into the apiserver - connects a user outside of the cluster to cluster IPs which otherwise might not be reachable - runs in the apiserver processes @@ -27,17 +30,23 @@ There are several different proxies you may encounter when using Kubernetes: - proxy to target may use HTTP or HTTPS as chosen by proxy using available information - can be used to reach a Node, Pod, or Service - does load balancing when used to reach a Service + 1. The [kube proxy](/docs/concepts/services-networking/service/#ips-and-vips): + - runs on each node - proxies UDP and TCP - does not understand HTTP - provides load balancing - is just used to reach services + 1. A Proxy/Load-balancer in front of apiserver(s): + - existence and implementation varies from cluster to cluster (e.g. nginx) - sits between all clients and one or more apiservers - acts as load balancer if there are several apiservers. + 1. Cloud Load Balancers on external services: + - are provided by some cloud providers (e.g. AWS ELB, Google Cloud Load Balancer) - are created automatically when the Kubernetes service has type `LoadBalancer` - use UDP/TCP only