Kubernetes Service APIs

此任务描述如何使用 KubernetesService APIs配置 Istio,将服务暴露到 service mesh 集群外。这些 API 是 KubernetesServiceIngressAPI 的发展演进。

设置

  1. 调用 Service APIs 创建 CRDs:

    1. $ kubectl kustomize "github.com/kubernetes-sigs/service-apis/config/crd?ref=v0.1.0" | kubectl apply -f -
  2. 安装 Istio 或重新配置 Istio,启动 Service APIs 控制器:

    1. $ istioctl install --set values.pilot.env.PILOT_ENABLED_SERVICE_APIS=true
  3. 请按照 确定 Ingress IP 和端口中的说明进行操作,取得入口网关的外部 IP 地址。

配置网关

参见 Service APIs文档中的 APIs 信息.

  1. 部署一个测试应用:

    Zip

    1. $ kubectl apply -f @samples/httpbin/httpbin.yaml@
  2. 部署 Service APIs 配置:

    1. $ kubectl apply -f - <<EOF
    2. apiVersion: networking.x-k8s.io/v1alpha1
    3. kind: GatewayClass
    4. metadata:
    5. name: istio
    6. spec:
    7. controller: istio.io/gateway-controller
    8. ---
    9. apiVersion: networking.x-k8s.io/v1alpha1
    10. kind: Gateway
    11. metadata:
    12. name: gateway
    13. namespace: istio-system
    14. spec:
    15. gatewayClassName: istio
    16. listeners:
    17. - hostname: "*"
    18. port: 80
    19. protocol: HTTP
    20. routes:
    21. namespaces:
    22. from: All
    23. selector:
    24. matchLabels:
    25. selected: "yes"
    26. kind: HTTPRoute
    27. ---
    28. apiVersion: networking.x-k8s.io/v1alpha1
    29. kind: HTTPRoute
    30. metadata:
    31. name: http
    32. namespace: default
    33. labels:
    34. selected: "yes"
    35. spec:
    36. gateways:
    37. allow: All
    38. hostnames: ["httpbin.example.com"]
    39. rules:
    40. - matches:
    41. - path:
    42. type: Prefix
    43. value: /get
    44. filters:
    45. - type: RequestHeaderModifier
    46. requestHeaderModifier:
    47. add:
    48. my-added-header: added-value
    49. forwardTo:
    50. - serviceName: httpbin
    51. port: 8000
    52. EOF
  3. 使用 curl 访问刚才部署的 httpbin 服务:

    1. $ curl -s -I -HHost:httpbin.example.com "http://$INGRESS_HOST:$INGRESS_PORT/get"
    2. HTTP/1.1 200 OK
    3. server: istio-envoy
    4. ...

    请注意,使用 -H 标志可以将 Host HTTP 标头设置为”httpbin.example.com”。这一步是必需的,因为 HTTPRoute 已配置为处理”httpbin.example.com”的请求,但是在测试环境中,该主机没有 DNS 绑定,只是将请求发送到入口 IP。

  4. 访问尚未显式公开的任何其他 URL,将会收到 HTTP 404 错误:

    1. $ curl -s -I -HHost:httpbin.example.com "http://$INGRESS_HOST:$INGRESS_PORT/headers"
    2. HTTP/1.1 404 Not Found
    3. ...