王先森2024-04-032024-04-03
出于简单性和可组合性的原因,Linkerd 本身没有提供内置的 Ingress 控制器。Linkerd 旨在与许多现有的 Kubernetes Ingress 解决方案一起使用。
将 Linkerd 和您选择的入口解决方案结合起来需要两件事:
对 Ingress 控制器进行网格化将允许 Linkerd 在流量进入集群时提供 L7 指标和 mTLS 等功能,Linkerd 支持与大部分 Ingress 控制器进行集成,包括:
这里只演示如何开启 ingress-nginx 与 Linkerd 进行集成,不会深入使用。为 Pod 添加一个 linkerd.io/inject: enabled
注解,可以直接 kubectl edit
这个 Deployment。
# 对ingress-nginx进行注入
kubectl get deployments.apps -n ingress-nginx ingress-nginx-controller -o yaml|linkerd inject -|kubectl apply -f -
# 删除原有pods,进行更新
kubectl delete pods -n ingress-nginx ingress-nginx-controller-845c6674fc-dqlmd
这样 ingress 控制器也被加入到网格中去了,所以也具有了 Linkerd 网格的相关功能:
这里以集群中使用的 traefik 为例来说明如何将其与 Linkerd 进行集成使用。
# 对 traefik 进行注入
kubectl get deployments.apps -n traefik traefik-v2 -o yaml|linkerd inject --ingress -|kubectl apply -f -
# 删除原有pods,进行更新
kubectl delete pods -n traefik traefik-v2-55755bbc8b-nbwx8
这里需要注意如果还是使用ingress-nginx这种注入方式是不行的,需要为 Pod 添加一个 linkerd.io/inject: ingress
注解,可以直接 kubectl edit
这个 Deployment。
在 Linkerd Dashboard 中也可以看到对应的指标数据了。
接下来我们为 Emojivoto
应用添加一个对应的 Ingress 资源对象来对外暴露服务。
Ingress-NginxTraefik
vim nginx-emoji.yaml
# vim nginx-emoji.yaml
# apiVersion: networking.k8s.io/v1beta1 # for k8s < v1.19
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: emojivoto-web-ingress
namespace: emojivoto
annotations:
nginx.ingress.kubernetes.io/service-upstream: "true"
spec:
ingressClassName: nginx
defaultBackend:
service:
name: web-svc
port:
number: 80
vim traefik-emoji.yaml Traefik 将添加一个
l5d-dst-override
标头来指示 Linkerd 请求的目标服务。您需要包含 Kubernetes 服务 FQDN (web-svc.emojivoto.svc.cluster.local
)和目标端口servicePort
。
# vim traefik-emoji.yaml
---
apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
name: emoji-middleware
namespace: emojivoto
spec:
headers:
customRequestHeaders:
l5d-dst-override: "web-svc.emojivoto.svc.cluster.local:80"
---
apiVersion: traefik.containo.us/v1alpha1
kind: IngressRoute
metadata:
name: emojivoto-web
namespace: emojivoto
spec:
entryPoints:
- web
routes:
- match: Host(`emoji.od.com`) && PathPrefix(`/`)
kind: Rule
middlewares:
- name: emoji-middleware
priority: 1000
services:
- name: web-svc
port: 80
Linkerd policy 资源用于配置和管理服务间通信的安全策略,例如访问控制规则、流量控制以及故障恢复机制。同样我们还是使用 Emojivoto
应用来展示如何限制对 Voting
微服务的访问,使其只能从 Web 服务中调用。
首先为 Voting
服务创建一个 Server
资源,Server
是 Linkerd 的另外一个 CRD 自定义资源,它用于描述工作负载的特定端口。一旦 Server
资源被创建,只有被授权的客户端才能访问它。
创建一个如下所示的资源对象:
# voting-server.yaml
apiVersion: policy.linkerd.io/v1beta1
kind: Server
metadata:
name: voting-grpc
namespace: emojivoto
labels:
app: voting-svc
spec:
podSelector:
matchLabels:
app: voting-svc
port: grpc
proxyProtocol: gRPC
直接应用上面的资源对象即可:
$ kubectl apply -f voting-server.yaml
server.policy.linkerd.io/voting-grpc created
$ kubectl get server -n emojivoto
NAME PORT PROTOCOL
voting-grpc grpc gRPC
我们可以看到该 Server
使用了一个 podSelector
属性来选择它所描述的 Voting 服务的 Pod,它还指定了它适用的命名端口 (grpc),最后指定在此端口上提供服务的协议为 gRPC
, 这可确保代理正确处理流量并允许它跳过协议检测。
现在没有客户端被授权访问此服务,正常会看到成功率有所下降, 因为从 Web 服务到 Voting 的请求开始被拒绝,也可以直接查看 Web 服务的 Pod 日志来验证:
$ kubectl logs -f -n emojivoto web-847cbcb586-rmbqw web-svc
2024/04/07 03:39:34 Error serving request [&{GET /api/vote?choice=:no_good_woman: HTTP/1.1 1 1 map[Accept-Encoding:[gzip] L5d-Client-Id:[default.emojivoto.serviceaccount.identity.linkerd.cluster.local] User-Agent:[Go-http-client/1.1] X-B3-Sampled:[1] X-B3-Spanid:[96aa6e062884fbc5] X-B3-Traceid:[5931344404b4e421d63db0d66b71c963]] {} <nil> 0 [] false web-apex.emojivoto:80 map[choice:[:no_good_woman:]] map[] <nil> map[] 172.17.130.21:48618 /api/vote?choice=:no_good_woman: <nil> <nil> <nil> 0xc000207530}]: rpc error: code = PermissionDenied desc = client 172.17.130.21:39266: server: 172.17.120.12:8080: unauthorized request on route
# ......
我们可以使用 linkerd viz authz
命令查看进入 Voting 服务的请求的授权状态:
$ linkerd viz authz -n emojivoto deploy/voting
ROUTE SERVER AUTHORIZATION UNAUTHORIZED SUCCESS RPS LATENCY_P50 LATENCY_P95 LATENCY_P99
default default:all-unauthenticated default/all-unauthenticated 0.0rps 100.00% 0.0rps 1ms 1ms 1ms
probe default:all-unauthenticated default/probe 0.0rps 100.00% 0.2rps 1ms 1ms 1ms
default voting-grpc 1.0rps 0.00% 0.0rps 0ms 0ms 0ms
可以看到所有传入的请求当前都处于未经授权状态。
接下来我们需要为客户端来授予访问该 Server 的权限,这里需要使用到另外一个 CRD 对象 ServerAuthorization
,创建该对象来授予 Web 服务访问我们上面创建的 Voting Server 的权限,对应的资源清单文件如下所示:
# voting-server-auth.yaml
apiVersion: policy.linkerd.io/v1beta1
kind: ServerAuthorization
metadata:
name: voting-grpc
namespace: emojivoto
spec:
server:
name: voting-grpc # 关联 Server 对象
# The voting service only allows requests from the web service.
client:
meshTLS:
serviceAccounts:
- name: web
- name: web-2
上面对象中通过 spec.server.name
来关联上面的 Server 对象,由于 meshTLS 使用 ServiceAccounts 作为身份基础,因此我们的授权也将基于 ServiceAccounts,所以通过 spec.client.meshTLS.serviceAccounts
来指定允许从哪些服务来访问 Voting 服务。
同样直接应用该资源清单即可:
$ kubectl apply -f voting-server-auth.yaml
serverauthorization.policy.linkerd.io/voting-grpc created
$ kubectl get serverauthorization -n emojivoto
NAME SERVER
voting-grpc voting-grpc
有了这个对象后,我们现在可以看到所有对 Voting 服务的请求都是由 voting-grpc
这个 ServerAuthorization
授权的。请注意,由于 linkerd viz auth
命令在一个时间窗口内查询,所以可能会看到一些未授权(UNAUTHORIZED)的请求在短时间内显示。
$ linkerd viz authz -n emojivoto deploy/voting
ROUTE SERVER AUTHORIZATION UNAUTHORIZED SUCCESS RPS LATENCY_P50 LATENCY_P95 LATENCY_P99
default default:all-unauthenticated default/all-unauthenticated 0.0rps 100.00% 0.0rps 1ms 1ms 1ms
probe default:all-unauthenticated default/probe 0.0rps 100.00% 0.2rps 1ms 1ms 1ms
default voting-grpc 0.5rps 0.00% 0.0rps 0ms 0ms 0ms
default voting-grpc serverauthorization/voting-grpc 0.0rps 92.86% 0.5rps 1ms 1ms 1ms
我们还可以通过创建一个 gRPC 客户端 Pod 来尝试从中访问 Voting 服务测试来自其他 Pod 的请求是否会被拒绝:
$ kubectl run grpcurl --rm -it --image=networld/grpcurl --restart=Never --command -- ./grpcurl -plaintext voting-svc.emojivoto:8080 emojivoto.v1.VotingService/VoteDog
Error invoking method "emojivoto.v1.VotingService/VoteDog": failed to query for service descriptor "emojivoto.v1.VotingService": rpc error: code = PermissionDenied desc =
pod "grpcurl" deleted
pod default/grpcurl terminated (Error)
由于该 client 未经授权,所以该请求将被拒绝并显示 PermissionDenied
错误。
我们可以根据需要创建任意数量的 ServerAuthorization
资源来授权许多不同的客户端,还可以指定是授权未经身份验证(即 unmeshed)的客户端、任何经过身份验证的客户端,还是仅授权具有特定身份的经过身份验证的客户端。
此外我们还可以为整个集群设置一个默认策略,该策略将应用于所有未定义 Server 资源的。Linkerd 在决定是否允许请求时会使用以下逻辑:
ServerAuthorization
资源,则为 ALLOW
ServerAuthorizations
,则为 DENY
比如我们可以使用 linkerd upgrade
命令将默认策略设置为 deny
:
$ linkerd upgrade --set policyController.defaultAllowPolicy=deny | kubectl apply -f -
另外我们也可以通过设置 config.linkerd.io/default-inbound-policy
注解,可以在单个工作负载或命名空间上设置默认策略。
意思就是除非通过创建 Server
和 ServerAuthorization
对象明确授权,否则所有请求都将被拒绝,这样的话对于 liveness
和 readiness
探针需要明确授权,否则 Kubernetes 将无法将 Pod 识别为 live 或 ready 状态,并将重新启动它们。我们可以创建如下所示的策略对象,来允许所有客户端访问 Linkerd admin 端口,以便 Kubernetes 可以执行 liveness
和 readiness
检查:
$ cat << EOF | kubectl apply -f -
---
# Server "admin": matches the admin port for every pod in this namespace
apiVersion: policy.linkerd.io/v1beta1
kind: Server
metadata:
namespace: emojivoto
name: admin
spec:
port: linkerd-admin
podSelector:
matchLabels: {} # every pod
proxyProtocol: HTTP/1
---
# ServerAuthorization "admin-everyone": allows unauthenticated access to the
# "admin" Server, so that Kubernetes health checks can get through.
apiVersion: policy.linkerd.io/v1beta1
kind: ServerAuthorization
metadata:
namespace: emojivoto
name: admin-everyone
spec:
server:
name: admin
client:
unauthenticated: true
如果你知道 Kubelet(执行健康检查)的 IP 地址或范围, 也可以进一步将 ServerAuthorization
限制为这些 IP 地址或范围,比如如果你知道 Kubelet 在 10.1.1.100
上运行,那么你的 ServerAuthorization
可以改为:
# ServerAuthorization "admin-kublet": allows unauthenticated access to the
# "admin" Server from the kubelet, so that Kubernetes health checks can get through.
apiVersion: policy.linkerd.io/v1beta1
kind: ServerAuthorization
metadata:
namespace: emojivoto
name: admin-kubelet
spec:
server:
name: admin
client:
networks:
- cidr: 10.1.1.100/32
unauthenticated: true
另外有一个值得注意的是在我们创建 Server
资源之后,但在创建 ServerAuthorization
之前有一段时间,所有请求都被拒绝。为了避免在实时系统中出现这种情况,我们建议你在部署服务之前创建 policy 资源,或者在创建 Server
之前创建 ServiceAuthorizations
,以便立即授权客户端。