diff --git a/content/zh/docs/concepts/services-networking/ingress.md b/content/zh/docs/concepts/services-networking/ingress.md index 254f04cba2..6a5cb35739 100644 --- a/content/zh/docs/concepts/services-networking/ingress.md +++ b/content/zh/docs/concepts/services-networking/ingress.md @@ -10,20 +10,18 @@ weight: 40 --> -{{< feature-state for_k8s_version="v1.1" state="beta" >}} +{{< feature-state for_k8s_version="v1.19" state="stable" >}} {{< glossary_definition term_id="ingress" length="all" >}} - ## 术语 - 为了表达更加清晰，本指南定义了以下术语： -## Ingress 是什么？ - +## Ingress 是什么？ [Ingress](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#ingress-v1beta1-networking-k8s-io) 公开了从集群外部到集群内[服务](/zh/docs/concepts/services-networking/service/)的 HTTP 和 HTTPS 路由。 流量路由由 Ingress 资源上定义的规则控制。 -```none - internet - | - [ Ingress ] - --|-----|-- - [ Services ] -``` + +下面是一个将所有流量都发送到同一 Service 的简单 Ingress 示例： + +{{< mermaid >}} +graph LR; + client([客户端])-. Ingress-管理的
负载均衡器 .->ingress[Ingress]; + ingress-->|路由规则|service[Service]; + subgraph cluster + ingress; + service-->pod1[Pod]; + service-->pod2[Pod]; + end + classDef plain fill:#ddd,stroke:#fff,stroke-width:4px,color:#000; + classDef k8s fill:#326ce5,stroke:#fff,stroke-width:4px,color:#fff; + classDef cluster fill:#fff,stroke:#bbb,stroke-width:2px,color:#326ce5; + class ingress,service,pod1,pod2 k8s; + class client plain; + class cluster cluster; +{{}} {{< note >}} -确保您查看了 Ingress 控制器的文档，以了解选择它的注意事项。 +确保你查看了 Ingress 控制器的文档，以了解选择它的注意事项。 {{< /note >}} -## Ingress 资源 +## Ingress 资源 {#the-ingress-resource} 一个最小的 Ingress 资源示例： -```yaml -apiVersion: networking.k8s.io/v1beta1 -kind: Ingress -metadata: - name: test-ingress - annotations: - nginx.ingress.kubernetes.io/rewrite-target: / -spec: - rules: - - http: - paths: - - path: /testpath - pathType: Prefix - backend: - serviceName: test - servicePort: 80 -``` + +{{< codenew file="service/networking/minimal-ingress.yaml" >}} ### Ingress 规则 {#ingress-rules} - 每个 HTTP 规则都包含以下信息： -* 可选主机。在此示例中，未指定主机，因此该规则适用于通过指定 IP 地址的所有入站 HTTP 通信。 - 如果提供了主机（例如 foo.bar.com），则规则适用于该主机。 -* 路径列表（例如，`/testpath`）,每个路径都有一个由 `serviceName` 和 `servicePort` 定义的关联后端。 +* 可选的 `host`。在此示例中，未指定 `host`，因此该规则适用于通过指定 IP 地址的所有入站 HTTP 通信。 + 如果提供了 `host`（例如 foo.bar.com），则 `rules` 适用于该 `host`。 +* 路径列表 paths（例如，`/testpath`）,每个路径都有一个由 `serviceName` 和 `servicePort` 定义的关联后端。 在负载均衡器将流量定向到引用的服务之前，主机和路径都必须匹配传入请求的内容。 -* 后端是 [Service 文档](/zh/docs/concepts/services-networking/service/)中所述的服务和端口名称的组合。 - 与规则的主机和路径匹配的对 Ingress 的 HTTP（和 HTTPS ）请求将发送到列出的后端。 +* `backend`（后端）是 [Service 文档](/zh/docs/concepts/services-networking/service/)中所述的服务和端口名称的组合。 + 与规则的 `host` 和 `path` 匹配的对 Ingress 的 HTTP（和 HTTPS ）请求将发送到列出的 `backend`。 -通常在 Ingress 控制器中会配置默认后端，以服务任何不符合规范中路径的请求。 +通常在 Ingress 控制器中会配置 `defaultBackend`（默认后端），以服务于任何不符合规约中 `path` 的请求。 -### 默认后端 +### DefaultBackend {#default-backend} -没有规则的 Ingress 将所有流量发送到同一个默认后端。 -默认后端通常是 [Ingress 控制器](/zh/docs/concepts/services-networking/ingress-controllers) -的配置选项，并且未在 Ingress 资源中指定。 +没有 `rules` 的 Ingress 将所有流量发送到同一个默认后端。 +`defaultBackend` 通常是 [Ingress 控制器](/zh/docs/concepts/services-networking/ingress-controllers) +的配置选项，而非在 Ingress 资源中指定。 -如果主机或路径都没有与 Ingress 对象中的 HTTP 请求匹配，则流量将路由到默认后端。 +如果 `hosts` 或 `paths` 都没有与 Ingress 对象中的 HTTP 请求匹配，则流量将路由到默认后端。 + + +### 资源后端 {#resource-backend} + +`Resource` 后端是一个 `ObjectRef`，指向同一名字空间中的另一个 +Kubernetes，将其作为 Ingress 对象。`Resource` 与 `Service` 配置是互斥的，在 +二者均被设置时会无法通过合法性检查。 +`Resource` 后端的一种常见用法是将所有入站数据导向带有静态资产的对象存储后端。 + +{{< codenew file="service/networking/ingress-resource-backend.yaml" >}} + + +创建了如上的 Ingress 之后，你可以使用下面的命令查看它： + +```bash +kubectl describe ingress ingress-resource-backend +``` + +``` +Name: ingress-resource-backend +Namespace: default +Address: +Default backend: APIGroup: k8s.example.com, Kind: StorageBucket, Name: static-assets +Rules: + Host Path Backends + ---- ---- -------- + * + /icons APIGroup: k8s.example.com, Kind: StorageBucket, Name: icon-assets +Annotations: +Events: +``` ### 路径类型 {#path-types} -Ingress 中的每个路径都有对应的路径类型。当前支持的路径类型有三种： +Ingress 中的每个路径都需要有对应的路径类型（Path Type）。未明确设置 `pathType` +的路径无法通过合法性检查。当前支持的路径类型有三种： -* _`ImplementationSpecific`_ （默认）：对于这种类型，匹配取决于 IngressClass。 +* `ImplementationSpecific`：对于这种路径类型，匹配方法取决于 IngressClass。 具体实现可以将其作为单独的 `pathType` 处理或者与 `Prefix` 或 `Exact` 类型作相同处理。 -* _`Exact`_：精确匹配 URL 路径，且对大小写敏感。 +* `Exact`：精确匹配 URL 路径，且区分大小写。 -* _`Prefix`_：基于以 `/` 分隔的 URL 路径前缀匹配。匹配对大小写敏感，并且对路径中的元素逐个完成。 +* `Prefix`：基于以 `/` 分隔的 URL 路径前缀匹配。匹配区分大小写，并且对路径中的元素逐个完成。 路径元素指的是由 `/` 分隔符分隔的路径中的标签列表。 如果每个 _p_ 都是请求路径 _p_ 的元素前缀，则请求与路径 _p_ 匹配。 @@ -264,8 +302,56 @@ Ingress 中的每个路径都有对应的路径类型。当前支持的路径类 （例如：`/foo/bar` 匹配 `/foo/bar/baz`, 但不匹配 `/foo/barbaz`）。 {{< /note >}} + +### 示例 + +| 类型 | 路径 | 请求路径 | 匹配与否？ | +|--------|---------------------------------|-----------------|--------------------------| +| Prefix | `/` | （所有路径） | 是 | +| Exact | `/foo` | `/foo` | 是 | +| Exact | `/foo` | `/bar` | 否 | +| Exact | `/foo` | `/foo/` | 否 | +| Exact | `/foo/` | `/foo` | 否 | +| Prefix | `/foo` | `/foo`, `/foo/` | 是 | +| Prefix | `/foo/` | `/foo`, `/foo/` | 是 | +| Prefix | `/aaa/bb` | `/aaa/bbb` | 否 | +| Prefix | `/aaa/bbb` | `/aaa/bbb` | 是 | +| Prefix | `/aaa/bbb/` | `/aaa/bbb` | 是，忽略尾部斜线 | +| Prefix | `/aaa/bbb` | `/aaa/bbb/` | 是，匹配尾部斜线 | +| Prefix | `/aaa/bbb` | `/aaa/bbb/ccc` | 是，匹配子路径 | +| Prefix | `/aaa/bbb` | `/aaa/bbbxyz` | 否，字符串前缀不匹配 | +| Prefix | `/`, `/aaa` | `/aaa/ccc` | 是，匹配 `/aaa` 前缀 | +| Prefix | `/`, `/aaa`, `/aaa/bbb` | `/aaa/bbb` | 是，匹配 `/aaa/bbb` 前缀 | +| Prefix | `/`, `/aaa`, `/aaa/bbb` | `/ccc` | 是，匹配 `/` 前缀 | +| Prefix | `/aaa` | `/ccc` | 否，使用默认后端 | +| 混合 | `/foo` (Prefix), `/foo` (Exact) | `/foo` | 是，优选 Exact 类型 | + +## 主机名通配符 {#hostname-wildcards} + +主机名可以是精确匹配（例如“`foo.bar.com`”）或者使用通配符来匹配 +（例如“`*.foo.com`”）。 +精确匹配要求 HTTP `host` 头部字段与 `host` 字段值完全匹配。 +通配符匹配则要求 HTTP `host` 头部字段与通配符规则中的后缀部分相同。 + + +| 主机 | host 头部 | 匹配与否？ | +| ------------ |--------------------| ------------------------------------| +| `*.foo.com` | `bar.foo.com` | 基于相同的后缀匹配 | +| `*.foo.com` | `baz.bar.foo.com` | 不匹配，通配符仅覆盖了一个 DNS 标签 | +| `*.foo.com` | `foo.com` | 不匹配，通配符仅覆盖了一个 DNS 标签 | + +{{< codenew file="service/networking/ingress-wildcard-host.yaml" >}} + -IngressClass 资源包含一个可选的参数字段，可用于为该类引用额外配置。 +IngressClass 资源包含一个可选的 `parameters` 字段，可用于为该类引用额外配置。 -### 废弃的注解 +### 废弃的注解 {#deprecated-annotation} 在 Kubernetes 1.18 版本引入 IngressClass 资源和 `ingressClassName` 字段之前， Ingress 类是通过 Ingress 中的一个 `kubernetes.io/ingress.class` 注解来指定的。 @@ -337,7 +442,7 @@ Ingress 中新的 `ingressClassName` 字段是该注解的替代品，但并非 包括 Ingress 控制器的名称。 ### 默认 Ingress 类 {#default-ingress-class} -您可以将一个特定的 IngressClass 标记为集群默认选项。 +你可以将一个特定的 IngressClass 标记为集群默认 Ingress 类。 将一个 IngressClass 资源的 `ingressclass.kubernetes.io/is-default-class` 注解设置为 `true` 将确保新的未指定 `ingressClassName` 字段的 Ingress 能够分配为这个默认的 IngressClass. @@ -358,15 +463,15 @@ an `ingressClassName` specified. You can resolve this by ensuring that at most 1 IngressClasess are marked as default in your cluster. --> {{< caution >}} -如果集群中有多个 IngressClass 被标记为默认，准入控制器将阻止创建新的未指定 `ingressClassName` -的 Ingress 对象。 +如果集群中有多个 IngressClass 被标记为默认，准入控制器将阻止创建新的未指定 +`ingressClassName` 的 Ingress 对象。 解决这个问题只需确保集群中最多只能有一个 IngressClass 被标记为默认。 {{< /caution >}} ## Ingress 类型 {#types-of-ingress} -### 单服务 Ingress {#single-service-ingress} +### 由单个 Service 来完成的 Ingress {#single-service-ingress} -现有的 Kubernetes 概念允许您暴露单个 Service (查看[替代方案](#alternatives))。 +现有的 Kubernetes 概念允许你暴露单个 Service (参见[替代方案](#alternatives))。 你也可以通过指定无规则的 *默认后端* 来对 Ingress 进行此操作。 -{{< codenew file="service/networking/ingress.yaml" >}} +{{< codenew file="service/networking/test-ingress.yaml" >}} -如果使用 `kubectl apply -f` 创建它，则应该能够查看刚刚添加的 Ingress 的状态： +如果使用 `kubectl apply -f` 创建此 Ingress，则应该能够查看刚刚添加的 Ingress 的状态： ```shell kubectl get ingress test-ingress ``` ``` -NAME HOSTS ADDRESS PORTS AGE -test-ingress * 203.0.113.123 80 59s +NAME CLASS HOSTS ADDRESS PORTS AGE +test-ingress external-lb * 203.0.113.123 80 59s ``` {{< note >}} -入口控制器和负载平衡器可能需要一两分钟才能分配 IP 地址。在此之前，您通常会看到地址字段的值被设定为 -``。 +入口控制器和负载平衡器可能需要一两分钟才能分配 IP 地址。 +在此之前，你通常会看到地址字段的值被设定为 ``。 {{< /note >}} -### 简单分列 +### 简单扇出 {#simple-fanout} -一个分列配置根据请求的 HTTP URI 将流量从单个 IP 地址路由到多个服务。 -Ingress 允许您将负载均衡器的数量降至最低。例如，这样的设置： +一个扇出（fanout）配置根据请求的 HTTP URI 将来自同一 IP 地址的流量路由到多个 Service。 +Ingress 允许你将负载均衡器的数量降至最低。例如，这样的设置： -```none -foo.bar.com -> 178.91.123.132 -> / foo service1:4200 - / bar service2:8080 -``` +{{< mermaid >}} +graph LR; + client([客户端])-. Ingress-管理的
负载均衡器 .->ingress[Ingress, 178.91.123.132]; + ingress-->|/foo|service1[Service service1:4200]; + ingress-->|/bar|service2[Service service2:8080]; + subgraph cluster + ingress; + service1-->pod1[Pod]; + service1-->pod2[Pod]; + service2-->pod3[Pod]; + service2-->pod4[Pod]; + end + classDef plain fill:#ddd,stroke:#fff,stroke-width:4px,color:#000; + classDef k8s fill:#326ce5,stroke:#fff,stroke-width:4px,color:#fff; + classDef cluster fill:#fff,stroke:#bbb,stroke-width:2px,color:#326ce5; + class ingress,service1,service2,pod1,pod2,pod3,pod4 k8s; + class client plain; + class cluster cluster; +{{}} 将需要一个如下所示的 Ingress： -```yaml -apiVersion: networking.k8s.io/v1beta1 -kind: Ingress -metadata: - name: simple-fanout-example - annotations: - nginx.ingress.kubernetes.io/rewrite-target: / -spec: - rules: - - host: foo.bar.com - http: - paths: - - path: /foo - backend: - serviceName: service1 - servicePort: 4200 - - path: /bar - backend: - serviceName: service2 - servicePort: 8080 -``` +{{< codenew file="service/networking/simple-fanout-example.yaml" >}} -Ingress 控制器将提供实现特定的负载均衡器来满足 Ingress，只要 Service (`service1`，`service2`) 存在。 -当它这样做了，你会在地址字段看到负载均衡器的地址。 +Ingress 控制器将提供实现特定的负载均衡器来满足 Ingress， +只要 Service (`service1`，`service2`) 存在。 +当它这样做时，你会在 Address 字段看到负载均衡器的地址。 {{< note >}} -取决于你使用的 [Ingress 控制器](/zh/docs/concepts/services-networking/ingress-controllers)， +取决于你所使用的 [Ingress 控制器](/zh/docs/concepts/services-networking/ingress-controllers)， 你可能需要创建默认 HTTP 后端[服务](/zh/docs/concepts/services-networking/service/)。 {{< /note >}} @@ -507,15 +608,29 @@ you are using, you may need to create a default-http-backend Name-based virtual hosts support routing HTTP traffic to multiple host names at the same IP address. --> -### 基于名称的虚拟托管 +### 基于名称的虚拟托管 {#name-based-virtual-hosting} 基于名称的虚拟主机支持将针对多个主机名的 HTTP 流量路由到同一 IP 地址上。 -```none -foo.bar.com --| |-> foo.bar.com service1:80 - | 178.91.123.132 | -bar.foo.com --| |-> bar.foo.com service2:80 -``` +{{< mermaid >}} +graph LR; + client([客户端])-. Ingress-管理的
负载均衡器 .->ingress[Ingress, 178.91.123.132]; + ingress-->|Host: foo.bar.com|service1[Service service1:80]; + ingress-->|Host: bar.foo.com|service2[Service service2:80]; + subgraph cluster + ingress; + service1-->pod1[Pod]; + service1-->pod2[Pod]; + service2-->pod3[Pod]; + service2-->pod4[Pod]; + end + classDef plain fill:#ddd,stroke:#fff,stroke-width:4px,color:#000; + classDef k8s fill:#326ce5,stroke:#fff,stroke-width:4px,color:#fff; + classDef cluster fill:#fff,stroke:#bbb,stroke-width:2px,color:#326ce5; + class ingress,service1,service2,pod1,pod2,pod3,pod4 k8s; + class client plain; + class cluster cluster; +{{}} -如果您创建的 Ingress 资源没有规则中定义的任何主机，则可以匹配指向 Ingress 控制器 IP 地址 -的任何网络流量，而无需基于名称的虚拟主机。 +如果你创建的 Ingress 资源没有在 `rules` 中定义的任何 `hosts`，则可以匹配指向 +Ingress 控制器 IP 地址的任何网络流量，而无需基于名称的虚拟主机。 -例如，以下 Ingress 资源会将 `first.bar.com` 请求的流量路由到 `service1`， -将 `second.foo.com` 请求的流量路由到 `service2`， -而没有在请求中定义主机名的 IP 地址的流量路由（即，不提供请求标头）到 `service3`。 +例如，以下 Ingress 会将针对 `first.bar.com` 的请求流量路由到 `service1`， +将针对 `second.foo.com` 的请求流量路由到 `service2`， +而针对该 IP 地址的、没有在请求中定义主机名的请求流量会被路由（即，不提供请求标头） +到 `service3`。 -```yaml -apiVersion: networking.k8s.io/v1beta1 -kind: Ingress -metadata: - name: name-virtual-host-ingress -spec: - rules: - - host: first.bar.com - http: - paths: - - backend: - serviceName: service1 - servicePort: 80 - - host: second.foo.com - http: - paths: - - backend: - serviceName: service2 - servicePort: 80 - - http: - paths: - - backend: - serviceName: service3 - servicePort: 80 -``` +{{< codenew file="service/networking/name-virtual-host-ingress-no-third-host.yaml" >}} 在 Ingress 中引用此 Secret 将会告诉 Ingress 控制器使用 TLS 加密从客户端到负载均衡器的通道。 -你需要确保创建的 TLS Secret 来自包含 `sslexample.foo.com` 的公用名称（CN）的证书。 +你需要确保创建的 TLS Secret 创建自包含 `sslexample.foo.com` 的公用名称（CN）的证书。 这里的公共名称也被称为全限定域名（FQDN）。 -```yaml -apiVersion: networking.k8s.io/v1beta1 -kind: Ingress -metadata: - name: tls-example-ingress -spec: - tls: - - hosts: - - sslexample.foo.com - secretName: testsecret-tls - rules: - - host: sslexample.foo.com - http: - paths: - - path: / - backend: - serviceName: service1 - servicePort: 80 -``` +{{< codenew file="service/networking/tls-example-ingress.yaml" >}} -### 负载均衡 +### 负载均衡 {#load-balancing} Ingress 控制器启动引导时使用一些适用于所有 Ingress 的负载均衡策略设置， 例如负载均衡算法、后端权重方案和其他等。 @@ -694,8 +750,9 @@ specific documentation to see how they handle health checks ( [nginx](https://git.k8s.io/ingress-nginx/README.md), [GCE](https://git.k8s.io/ingress-gce/README.md#health-checks)). --> -值得注意的是，即使健康检查不是通过 Ingress 直接暴露的，在 Kubernetes -中存在并行概念，比如[就绪检查](/zh/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) +值得注意的是，尽管健康检查不是通过 Ingress 直接暴露的，在 Kubernetes +中存在并行的概念，比如 +[就绪检查](/zh/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/)， 允许你实现相同的目的。 请检查特定控制器的说明文档，以了解它们是怎样处理健康检查的 ( [nginx](https://git.k8s.io/ingress-nginx/README.md)， @@ -706,7 +763,7 @@ specific documentation to see how they handle health checks ( To update an existing Ingress to add a new Host, you can update it by editing the resource: --> -## 更新 Ingress +## 更新 Ingress {#updating-an-ingress} 要更新现有的 Ingress 以添加新的 Host，可以通过编辑资源来对其进行更新： @@ -753,6 +810,7 @@ spec: serviceName: service1 servicePort: 80 path: /foo + pathType: Prefix - host: bar.baz.com http: paths: @@ -760,6 +818,7 @@ spec: serviceName: service2 servicePort: 80 path: /foo + pathType: Prefix .. ``` @@ -808,28 +867,13 @@ You can achieve the same outcome by invoking `kubectl replace -f` on a modified ## Failing across availability zones Techniques for spreading traffic across failure domains differs between cloud providers. -Please check the documentation of the relevant [Ingress controller](/docs/concepts/services-networking/ingress-controllers) for details. You can also refer to the [federation documentation](https://github.com/kubernetes-sigs/federation-v2) -for details on deploying Ingress in a federated cluster. +Please check the documentation of the relevant [Ingress controller](/docs/concepts/services-networking/ingress-controllers) for details. --> ## 跨可用区失败 {#failing-across-availability-zones} 不同的云厂商使用不同的技术来实现跨故障域的流量分布。详情请查阅相关 Ingress 控制器的文档。 -请查看相关[ Ingress 控制器](/zh/docs/concepts/services-networking/ingress-controllers) 的文档以了解详细信息。 -你还可以参考[联邦文档](https://github.com/kubernetes-sigs/federation-v2)，以获取有关在联合集群中部署 Ingress 的详细信息。 - - -## 未来工作 -跟踪 [SIG Network](https://github.com/kubernetes/community/tree/master/sig-network) -的活动以获得有关 Ingress 和相关资源演变的更多细节。 -你还可以跟踪 [Ingress 仓库](https://github.com/kubernetes/ingress/tree/master) -以获取有关各种 Ingress 控制器的更多细节。 +请查看相关 [Ingress 控制器](/zh/docs/concepts/services-networking/ingress-controllers) +的文档以了解详细信息。 -* 使用 [Service.Type=LoadBalancer](/docs/concepts/services-networking/service/#loadbalancer) -* 使用 [Service.Type=NodePort](/docs/concepts/services-networking/service/#nodeport) +* 使用 [Service.Type=LoadBalancer](/zh/docs/concepts/services-networking/service/#loadbalancer) +* 使用 [Service.Type=NodePort](/zh/docs/concepts/services-networking/service/#nodeport) ## {{% heading "whatsnext" %}} * 进一步了解 [Ingress API](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#ingress-v1beta1-networking-k8s-io) * 进一步了解 [Ingress 控制器](/zh/docs/concepts/services-networking/ingress-controllers/) -* [使用 NGINX 控制器在 Minikube 上安装 Ingress](/zh/docs/tasks/access-application-cluster/ingress-minikube) +* [使用 NGINX 控制器在 Minikube 上安装 Ingress](/zh/docs/tasks/access-application-cluster/ingress-minikube/) diff --git a/content/zh/examples/service/networking/external-lb.yaml b/content/zh/examples/service/networking/external-lb.yaml new file mode 100644 index 0000000000..adcf7a2fd0 --- /dev/null +++ b/content/zh/examples/service/networking/external-lb.yaml @@ -0,0 +1,10 @@ +apiVersion: networking.k8s.io/v1 +kind: IngressClass +metadata: + name: external-lb +spec: + controller: example.com/ingress-controller + parameters: + apiGroup: k8s.example.com + kind: IngressParameters + name: external-lb diff --git a/content/zh/examples/service/networking/ingress-resource-backend.yaml b/content/zh/examples/service/networking/ingress-resource-backend.yaml new file mode 100644 index 0000000000..87b6bbd0f3 --- /dev/null +++ b/content/zh/examples/service/networking/ingress-resource-backend.yaml @@ -0,0 +1,20 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: ingress-resource-backend +spec: + defaultBackend: + resource: + apiGroup: k8s.example.com + kind: StorageBucket + name: static-assets + rules: + - http: + paths: + - path: /icons + pathType: ImplementationSpecific + backend: + resource: + apiGroup: k8s.example.com + kind: StorageBucket + name: icon-assets diff --git a/content/zh/examples/service/networking/ingress-wildcard-host.yaml b/content/zh/examples/service/networking/ingress-wildcard-host.yaml new file mode 100644 index 0000000000..2be7016706 --- /dev/null +++ b/content/zh/examples/service/networking/ingress-wildcard-host.yaml @@ -0,0 +1,26 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: ingress-wildcard-host +spec: + rules: + - host: "foo.bar.com" + http: + paths: + - pathType: Prefix + path: "/bar" + backend: + service: + name: service1 + port: + number: 80 + - host: "*.foo.com" + http: + paths: + - pathType: Prefix + path: "/foo" + backend: + service: + name: service2 + port: + number: 80 diff --git a/content/zh/examples/service/networking/ingress.yaml b/content/zh/examples/service/networking/ingress.yaml deleted file mode 100644 index 56a0d5138f..0000000000 --- a/content/zh/examples/service/networking/ingress.yaml +++ /dev/null @@ -1,9 +0,0 @@ -apiVersion: networking.k8s.io/v1beta1 -kind: Ingress -metadata: - name: test-ingress -spec: - backend: - serviceName: testsvc - servicePort: 80 - diff --git a/content/zh/examples/service/networking/minimal-ingress.yaml b/content/zh/examples/service/networking/minimal-ingress.yaml new file mode 100644 index 0000000000..76640b9447 --- /dev/null +++ b/content/zh/examples/service/networking/minimal-ingress.yaml @@ -0,0 +1,17 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: minimal-ingress + annotations: + nginx.ingress.kubernetes.io/rewrite-target: / +spec: + rules: + - http: + paths: + - path: /testpath + pathType: Prefix + backend: + service: + name: test + port: + number: 80 diff --git a/content/zh/examples/service/networking/name-virtual-host-ingress-no-third-host.yaml b/content/zh/examples/service/networking/name-virtual-host-ingress-no-third-host.yaml new file mode 100644 index 0000000000..16a560b1ff --- /dev/null +++ b/content/zh/examples/service/networking/name-virtual-host-ingress-no-third-host.yaml @@ -0,0 +1,35 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: name-virtual-host-ingress-no-third-host +spec: + rules: + - host: first.bar.com + http: + paths: + - pathType: Prefix + path: "/" + backend: + service: + name: service1 + port: + number: 80 + - host: second.bar.com + http: + paths: + - pathType: Prefix + path: "/" + backend: + service: + name: service2 + port: + number: 80 + - http: + paths: + - pathType: Prefix + path: "/" + backend: + service: + name: service3 + port: + number: 80 diff --git a/content/zh/examples/service/networking/name-virtual-host-ingress.yaml b/content/zh/examples/service/networking/name-virtual-host-ingress.yaml new file mode 100644 index 0000000000..213a73d261 --- /dev/null +++ b/content/zh/examples/service/networking/name-virtual-host-ingress.yaml @@ -0,0 +1,26 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: name-virtual-host-ingress +spec: + rules: + - host: foo.bar.com + http: + paths: + - pathType: Prefix + path: "/" + backend: + service: + name: service1 + port: + number: 80 + - host: bar.foo.com + http: + paths: + - pathType: Prefix + path: "/" + backend: + service: + name: service2 + port: + number: 80 diff --git a/content/zh/examples/service/networking/simple-fanout-example.yaml b/content/zh/examples/service/networking/simple-fanout-example.yaml new file mode 100644 index 0000000000..19fef9455b --- /dev/null +++ b/content/zh/examples/service/networking/simple-fanout-example.yaml @@ -0,0 +1,23 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: simple-fanout-example +spec: + rules: + - host: foo.bar.com + http: + paths: + - path: /foo + pathType: Prefix + backend: + service: + name: service1 + port: + number: 4200 + - path: /bar + pathType: Prefix + backend: + service: + name: service2 + port: + number: 8080 diff --git a/content/zh/examples/service/networking/test-ingress.yaml b/content/zh/examples/service/networking/test-ingress.yaml new file mode 100644 index 0000000000..acd384ab56 --- /dev/null +++ b/content/zh/examples/service/networking/test-ingress.yaml @@ -0,0 +1,10 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: test-ingress +spec: + defaultBackend: + service: + name: test + port: + number: 80 diff --git a/content/zh/examples/service/networking/tls-example-ingress.yaml b/content/zh/examples/service/networking/tls-example-ingress.yaml new file mode 100644 index 0000000000..fe5d52a0cb --- /dev/null +++ b/content/zh/examples/service/networking/tls-example-ingress.yaml @@ -0,0 +1,20 @@ +apiVersion: networking.k8s.io/v1 +kind: Ingress +metadata: + name: tls-example-ingress +spec: + tls: + - hosts: + - https-example.foo.com + secretName: testsecret-tls + rules: + - host: https-example.foo.com + http: + paths: + - path: / + pathType: Prefix + backend: + service: + name: service1 + port: + number: 80