diff --git a/content/zh/docs/tasks/administer-cluster/access-cluster-services.md b/content/zh/docs/tasks/administer-cluster/access-cluster-services.md index cb03264553..99730f4621 100644 --- a/content/zh/docs/tasks/administer-cluster/access-cluster-services.md +++ b/content/zh/docs/tasks/administer-cluster/access-cluster-services.md @@ -1,85 +1,192 @@ --- - title: 访问集群上运行的服务 content_type: task --- - + 本文展示了如何连接 Kubernetes 集群上运行的服务。 - ## {{% heading "prerequisites" %}} - {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} - + ## 访问集群上运行的服务 -在 Kubernetes 里, [nodes](/docs/admin/node)、[pods](/docs/user-guide/pods) 和 [services](/docs/user-guide/services) 都有它们自己的 IP。许多情况下,集群上的 node IP、pod IP 和某些 service IP 路由不可达,所以不能从一个集群之外的节点访问它们,例如从你自己的台式机。 +在 Kubernetes 里,[Node](/zh/docs/concepts/architecture/nodes/)、 +[Pod](/zh/docs/concepts/workloads/pods/) 和 +[Service](/zh/docs/concepts/services-networking/services/) 都有自己的 IP。 +许多情况下,集群上的节点 IP、Pod IP 和某些服务 IP 是路由不可达的, +所以不能从集群之外访问它们,例如从你自己的台式机。 + +### 连接方式 {#ways-to-connect} +你有多种可选方式从集群外连接节点、Pod 和服务: -你有多种从集群外连接 nodes、pods 和 services 的选项: - - - - 通过公共 IP 访问 services。 - - 使用具有 `NodePort` 或 `LoadBalancer` 类型的 service,可以从外部访问它们。请查阅 [services](/docs/user-guide/services) 和 [kubectl expose](/docs/user-guide/kubectl/v1.6/#expose) 文档。 - - 取决于你的集群环境,你可以仅把 service 暴露在你的企业网络环境中,也可以将其暴露在因特网上。需要考虑暴露的 service 是否安全,它是否有自己的用户认证? - - 将 pods 放置于 services 背后。如果要访问一个副本集合中特定的 pod,例如用于调试目的时,请给 pod 指定一个独特的标签并创建一个新 service 选择这个标签。 - - 大部分情况下,都不需要应用开发者通过节点 IP 直接访问 nodes。 - - 通过 Proxy Verb 访问 services、nodes 或者 pods。 - - 在访问 Apiserver 远程服务之前是否经过认证和授权?如果你的服务暴露到因特网中不够安全,或者需要获取 node IP 之上的端口,又或者处于调试目的时,请使用这个特性。 - - Proxies 可能给某些应用带来麻烦。 - - 仅适用于 HTTP/HTTPS。 - - 在[这里](#manually-constructing-apiserver-proxy-urls)描述 + +- 通过公网 IP 访问服务 + - 使用类型为 `NodePort` 或 `LoadBalancer` 的服务,可以从外部访问它们。 + 请查阅[服务](/zh/docs/concepts/services-networking/services/) 和 + [kubectl expose](/docs/reference/generated/kubectl/kubectl-commands/#expose) 文档。 + - 取决于你的集群环境,你可以仅把服务暴露在你的企业网络环境中,也可以将其暴露在 + 因特网上。需要考虑暴露的服务是否安全,它是否有自己的用户认证? + - 将 Pod 放置于服务背后。如果要访问一个副本集合中特定的 Pod,例如用于调试目的, + 请给 Pod 指定一个独特的标签并创建一个新服务选择该标签。 + - 大部分情况下,都不需要应用开发者通过节点 IP 直接访问节点。 + +- 通过 Proxy 动词访问服务、节点或者 Pod + - 在访问远程服务之前,利用 API 服务器执行身份认证和鉴权。 + 如果你的服务不够安全,无法暴露到因特网中,或者需要访问节点 IP 上的端口, + 又或者出于调试目的,可使用这种方式。 + - 代理可能给某些应用带来麻烦 + - 此方式仅适用于 HTTP/HTTPS + - 进一步的描述在[这里](#manually-constructing-apiserver-proxy-urls) - 从集群中的 node 或者 pod 访问。 - - 运行一个 pod,然后使用 [kubectl exec](/docs/user-guide/kubectl/v1.6/#exec) 连接到它的一个shell。从那个 shell 连接其他的 nodes、pods 和 services。 - - 某些集群可能允许你 ssh 到集群中的节点。你可能可以从那儿访问集群服务。这是一个非标准的方式,可能在一些集群上能工作,但在另一些上却不能。浏览器和其他工具可能安装或可能不会安装。集群 DNS 可能不会正常工作。 + +- 从集群中的一个节点或 Pod 访问 + - 运行一个 Pod,然后使用 + [kubectl exec](/docs/reference/generated/kubectl/kubectl-commands/#exec) + 连接到它的 Shell。从那个 Shell 连接其他的节点、Pod 和 服务 + - 某些集群可能允许你 SSH 到集群中的节点。你可能可以从那儿访问集群服务。 + 这是一个非标准的方式,可能在一些集群上能工作,但在另一些上却不能。 + 浏览器和其他工具可能已经安装也可能没有安装。集群 DNS 可能不会正常工作。 + +### 发现内置服务 {#discovering-builtin-services} - -典型情况下,kube-system 会启动集群中的几个服务。使用 `kubectl cluster-info` 命令获取它们的列表: +典型情况下,kube-system 名字空间中会启动集群的几个服务。 +使用 `kubectl cluster-info` 命令获取这些服务的列表: ```shell -$ kubectl cluster-info - - Kubernetes master is running at https://104.197.5.247 - elasticsearch-logging is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy - kibana-logging is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/kibana-logging/proxy - kube-dns is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/kube-dns/proxy - grafana is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/monitoring-grafana/proxy - heapster is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/monitoring-heapster/proxy +kubectl cluster-info ``` -这显示了用于访问每个服务的 proxy-verb URL。例如,这个集群启用了(使用 Elasticsearch)集群层面的日志,如果提供合适的凭据可以通过 `https://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/` 访问,或通过一个 kubectl 代理地址访问,如:`http://localhost:8080/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/`。(请查看 [上文](#accessing-the-cluster-api) 关于如何传递凭据或者使用 kubectl 代理的说明。) + +输出类似于: +``` +Kubernetes master is running at https://104.197.5.247 +elasticsearch-logging is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy +kibana-logging is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/kibana-logging/proxy +kube-dns is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/kube-dns/proxy +grafana is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/monitoring-grafana/proxy +heapster is running at https://104.197.5.247/api/v1/namespaces/kube-system/services/monitoring-heapster/proxy +``` -#### 手动构建 apiserver 代理 URLs + +这一输出显示了用 proxy 动词访问每个服务时可用的 URL。例如,此集群 +(使用 Elasticsearch)启用了集群层面的日志。如果提供合适的凭据,可以通过 +`https://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/` 访问,或通过一个 `kubectl proxy` 来访问:`http://localhost:8080/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/`。 + +{{< note >}} +请参阅[使用 Kubernets API 访问集群](/docs/tasks/administer-cluster/access-cluster-api/#accessing-the-cluster-api)了解如何传递凭据或如何使用 `kubectl proxy`。 +{{< /note >}} -如同上面所提到的,你可以使用 `kubectl cluster-info` 命令取得 service 的代理 URL。为了创建包含 service endpoints、suffixes 和 parameters 的代理 URLs,你可以简单的在 service 的代理 URL中 添加: + +#### 手动构建 API 服务器代理 URLs + +如前所述,你可以使用 `kubectl cluster-info` 命令取得服务的代理 URL。 +为了创建包含服务末端、后缀和参数的代理 URLs,你可以简单地在服务的代理 URL 中添加: `http://`*`kubernetes_master_address`*`/api/v1/namespaces/`*`namespace_name`*`/services/`*`service_name[:port_name]`*`/proxy` - 如果还没有为你的端口指定名称,你可以不用在 URL 中指定 *port_name*。 + ##### 示例 +* 如要访问 Elasticsearch 服务末端 `_search?q=user:kimchy`,你可以使用: - * 你可以通过 `http://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/_search?q=user:kimchy` 访问 Elasticsearch service endpoint `_search?q=user:kimchy`。 - * 你可以通过 `https://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/_cluster/health?pretty=true` 访问 Elasticsearch 集群健康信息 endpoint `_cluster/health?pretty=true`。 + ``` + http://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/_search?q=user:kimchy + ``` -```json + +* 如要访问 Elasticsearch 集群健康信息`_cluster/health?pretty=true`,你会使用: + + ``` + https://104.197.5.247/api/v1/namespaces/kube-system/services/elasticsearch-logging/proxy/_cluster/health?pretty=true` + ``` + + + 健康信息与下面的例子类似: + + ```json { "cluster_name" : "kubernetes_logging", "status" : "yellow", @@ -92,18 +199,34 @@ $ kubectl cluster-info "initializing_shards" : 0, "unassigned_shards" : 5 } -``` + ``` + +* 要访问 *https* Elasticsearch 服务健康信息 `_cluster/health?pretty=true`,你会使用: -#### 通过 web 浏览器访问集群中运行的服务 + ``` + https://104.197.5.247/api/v1/namespaces/kube-system/services/https:elasticsearch-logging/proxy/_cluster/health?pretty=true + ``` + +#### 通过 Web 浏览器访问集群中运行的服务 +你或许能够将 API 服务器代理的 URL 放入浏览器的地址栏,然而: + +- Web 服务器通常不能传递令牌,所以你可能需要使用基本(密码)认证。 + API 服务器可以配置为接受基本认证,但你的集群可能并没有这样配置。 +- 某些 Web 应用可能无法工作,特别是那些使用客户端 Javascript 构造 URL 的 + 应用,所构造的 URL 可能并不支持代理路径前缀。