Skip to content

Commit 9aa0d1d

Browse files
committed
update service
1 parent d8cf490 commit 9aa0d1d

File tree

1 file changed

+15
-30
lines changed

1 file changed

+15
-30
lines changed

concepts/service.md

Lines changed: 15 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -310,45 +310,30 @@ status:
310310

311311
如果设置了 `loadBalancerIP`,但云提供商并不支持这种特性,那么设置的 `loadBalancerIP` 值将会被忽略掉。
312312

313-
### AWS 内部负载均衡器
314-
在混合云环境中,有时从虚拟私有云(VPC)环境中的服务路由流量是非常有必要的。
315-
可以通过在 `Service` 中增加 `annotation` 来实现,如下所示:
313+
## ExternalName
316314

317-
```yaml
318-
[...]
319-
metadata:
320-
name: my-service
321-
annotations:
322-
service.beta.kubernetes.io/aws-load-balancer-internal: 0.0.0.0/0
323-
[...]
324-
```
325-
在水平分割的 DNS 环境中,需要两个 `Service` 来将外部和内部的流量路由到 Endpoint 上。
315+
ExternalName 类型的服务将服务映射到一个 DNS 名称,而不是典型的选择器,如 `my-service` 或 `cassandra`。使用 `spec.externalName` 参数指定这些服务。
326316

327-
### AWS SSL 支持
328-
对运行在 AWS 上部分支持 SSL 的集群,从 1.3 版本开始,可以为 `LoadBalancer` 类型的 `Service` 增加两个 annotation:
317+
例如,这个服务定义将 prod 命名空间中的 `my-service` 映射到 `my.database.example.com`。
329318

330319
```yaml
331-
metadata:
332-
name: my-service
333-
annotations:
334-
service.beta.kubernetes.io/aws-load-balancer-ssl-cert: arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
320+
apiVersion: v1
321+
kind: Service
322+
metadata:
323+
name: my-service
324+
namespace: prod
325+
spec:
326+
type: ExternalName
327+
externalName: my.database.example.com
335328
```
336329

337-
第一个 annotation 指定了使用的证书。它可以是第三方发行商发行的证书,这个证书或者被上传到 IAM,或者由 AWS 的证书管理器创建。
338-
339-
```yaml
340-
metadata:
341-
name: my-service
342-
annotations:
343-
service.beta.kubernetes.io/aws-load-balancer-backend-protocol: (https|http|ssl|tcp)
344-
```
345-
第二个 annotation 指定了 `Pod` 使用的协议。
330+
注意:ExternalName 接受 IPv4 地址字符串,但它是由数字组成的 DNS 名称,而不是 IP 地址。类似于 IPv4 地址的 ExternalNames 不能被 CoreDNS 或 ingress-nginx 解析,因为 ExternalName 的目的是指定一个规范的 DNS 名称。要硬编码一个 IP 地址,请考虑使用 Headless Service。
346331

347-
对于 HTTPS 和 SSL,ELB 将期望该 `Pod` 基于加密的连接来认证自身。
332+
**警告**
348333

349-
HTTP 和 HTTPS 将选择7层代理:ELB 将中断与用户的连接,当转发请求时,会解析 Header 信息并添加上用户的 IP 地址(`Pod` 将只能在连接的另一端看到该 IP 地址)
334+
对于一些常见的协议,包括 HTTP 和 HTTPS,你使用 ExternalName 可能会有问题。如果使用 ExternalName,那么你集群内的客户端使用的主机名与 ExternalName 引用的名称不同
350335

351-
TCP 和 SSL 将选择4层代理:ELB 将转发流量,并不修改 Header 信息
336+
对于使用主机名的协议,这种差异可能导致错误或意外的响应。HTTP请求将有一个源服务器不承认的 `Host: header`,TLS 服务器将不能提供与客户端连接的主机名相匹配的证书
352337

353338
### 外部 IP
354339

0 commit comments

Comments
 (0)