乐趣区

关于apisix:APISIX-Ingress-对-Gateway-API-的支持和应用

本文介绍了 Gateway API 这个将服务裸露到集群之外的全新标准,并且介绍了如何在 APISIX Ingress Controller 中应用它。

作者 @lingsamuel,API7.ai 云原生技术专家,Apache APISIX Committer。

Gateway API 是除原生 Service 与 Ingress 之外,APISIX 社区发动的独立标准,帮忙用户将 Kubernetes 中的服务裸露到集群之外,由 sig-network(特地兴趣小组)治理。

Gateway API 反对大部分罕用网络协议(HTTP、TCP、UDP 等)和对 TLS 的反对。此外,Gateway API 中的 Gateway 资源可能通过 Kubernetes API 来治理代理和网关的生命周期。

随着 Gateway API 被宽泛实现与利用,Gateway API 公布了 v0.5.0 版本。在该版本中,一些外围 API 首次进入 Beta 阶段,包含:GatewayClass、Gateway、HTTPRoute。

Gateway API 劣势盘点

Gateway API 不仅是 Ingress 的性能父集,还具备如下改良:

  • 面向角色 :Gateway 由一组 API 资源组成,不同的 API 资源代表了应用与配置 Kubernetes 网络资源的不同角色。
  • 表现力强 :Gateway API 的外围性能蕴含基于 Header 匹配、流量加权以及以及其余局部由 annotations 实现的非标准化性能。
  • 可扩大 :Gateway API 容许不同资源在不同层级一起应用。这使得可能对 API 构造进行更精细化的管制。

此外,Gateway API 还蕴含了可移植、网关共享与跨命名空间援用等个性。

如下图所示,面向角色的设计使不同团队之间能够共享集群外部的网络基础设施,和集群管理员设置的策略与束缚。由此,基础设施提供方、集群管理员、利用开发者等各种身份的角色能够只专一本人的工作,无需对其余角色负责。

不同的角色配置不同层级的 Gateway API 资源,这些资源相互配合,独特作用:

如何在 APISIX Ingress 中应用 Gateway API

1 装置 Gateway API CRD

要应用 Gateway API,须要先装置 Gateway API 的 CRD,有两种装置形式:APISIX Ingress Controller 仓库下的正本或官网仓库 kubernetes-sigs/gateway-api。

此处以 APISIX Ingress Controller 仓库的 CRD 正本为例,装置命令如下:

git pull git@github.com:apache/apisix-ingress-controller.git
cd apisix-ingress-controller
kubectl apply -f ./samples/deploy/gateway-api/

2 装置 APISIX Ingress Controller

在 APISIX Ingress Controller 中,默认不启用 Gateway API 反对,可通过参数 --enable-gateway-api=true 启用。随后在应用 Helm 装置时,可通过配置 values 来启用。

APISIX 与 APISIX Ingress Controller 装置命令如下:

helm repo add apisix https://charts.apiseven.com
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
kubectl create ns apisix-ingress
helm install apisix apisix/apisix --namespace apisix-ingress \
  --set gateway.type=NodePort \
  --set ingress-controller.enabled=true \
  --set ingress-controller.config.apisix.serviceNamespace=apisix-ingress \
  --set ingress-controller.config.kubernetes.enableGatewayAPI=true

参数 --set ingress-controller.config.kubernetes.enableGatewayAPI=true 用于开启 Gateway API 反对。

这些命令将在 apisix-ingress 命名空间下创立残缺的测试环境,包含 APISIX、etcd 与 APISIX Ingress Controller。

3 部署测试负载

应用 kennethreitz/httpbin 镜像作为测试负载。

在默认命名空间下部署这些负载,装置命令如下:

kubectl run httpbin --image kennethreitz/httpbin --port 80
kubectl expose pod httpbin --port 80

4 配置 HTTPRoute

目前,APISIX Ingress Controller 反对 v1alpha2 版本的 Gateway API 资源。

在测试时,应用如下 HTTPRoute 配置,将其保留到 httproute.yaml 文件中:

# httproute.yaml
apiVersion: gateway.networking.k8s.io/v1alpha2
kind: HTTPRoute
metadata:
  name: basic-http-route
spec:
  hostnames:
  - local.httpbin.org
  rules:
  - backendRefs:
    - name: httpbin
      port: 80
    matches:
    - path:
        type: PathPrefix
        value: /

部署该 HTTPRoute 配置:

kubectl apply -f ./httproute.yaml

5 验证

在 APISIX 的 Pod 中间接验证,执行以下命令:

kubectl -n apisix-ingress exec -it \
  $(kubectl -n apisix-ingress get Pods -l "app.kubernetes.io/name=apisix" -o name) -c apisix -- \
  curl -H "Host: local.httpbin.org" localhost:9080/ip

预期输入为:

{"origin": "127.0.0.1"}

由此,配置胜利失效。

APISIX Ingress 对 Gateway API 的反对状态

APISIX Ingress Controller 正在对 Gateway API 增加反对,现已处于 Alpha 阶段,反对 HTTPRoute、TCPRoute 等资源。

目前 Gateway API 已更新至 v0.5.1 版本,但对于 Gateway 与 Gateway Class 的反对还处于开发阶段,因而目前这些资源的配置临时不会失效。

总结

在本文中,咱们介绍了 Gateway API 这个将服务裸露到集群之外的全新标准,并且介绍了如何在 APISIX Ingress Controller 中应用它。APISIX Ingress Controller 对 Gateway API 的残缺反对仍在踊跃开发中,欢送感兴趣的敌人参加奉献。

退出移动版