信任域迁移

该任务阐述了如何在不更改授权策略的前提下从一个信任域迁移到另一个。

在 Istio 1.4 中,我们引入了一个 alpha 特性以支持授权策略 trust domain migration。 这意味着如果一个 Istio 网格需要改变它的 trust domain,其授权策略是不需要手动更新的。 在 Istio 中,如果一个 workload 运行在命名空间 foo 中,服务账户为 bar,系统的信任域为 my-td,那么该工作负载的身份就是 spiffe://my-td/ns/foo/sa/bar。 默认情况下,Istio 网格的信任域是 cluster.local,除非您在安装时另外指定了。

开始之前

在您开始任务之前,请完成以下内容:

  1. 阅读 授权 指南。

  2. 安装 Istio,自定义信任域,并启用双向 TLS。

    $ istioctl install --set profile=demo --set meshConfig.trustDomain=old-td
    
  3. httpbin 示例部署于 default 命名空间中,将 sleep 示例部署于 defaultsleep-allow 命名空间中:

    ZipZipZip
    $ kubectl label namespace default istio-injection=enabled
    $ kubectl apply -f @samples/httpbin/httpbin.yaml@
    $ kubectl apply -f @samples/sleep/sleep.yaml@
    $ kubectl create namespace sleep-allow
    $ kubectl label namespace sleep-allow istio-injection=enabled
    $ kubectl apply -f @samples/sleep/sleep.yaml@ -n sleep-allow
    
  4. 应用如下授权策略以拒绝所有到 httpbin 的请求,除了来自 sleep-allow 命名空间的 sleep 服务。

    $ kubectl apply -f - <<EOF
    apiVersion: security.istio.io/v1beta1
    kind: AuthorizationPolicy
    metadata:
      name: service-httpbin.default.svc.cluster.local
      namespace: default
    spec:
      rules:
      - from:
        - source:
            principals:
            - old-td/ns/sleep-allow/sa/sleep
        to:
        - operation:
            methods:
            - GET
      selector:
        matchLabels:
          app: httpbin
    ---
    EOF
    

请注意授权策略传播到 sidecars 大约需要几十秒。

  1. 验证从以下请求源发送至 httpbin 的请求:

    • 来自 default 命名空间的 sleep 服务的请求被拒绝。
    $ kubectl exec "$(kubectl get pod -l app=sleep -o jsonpath={.items..metadata.name})" -c sleep -- curl http://httpbin.default:8000/ip -sS -o /dev/null -w "%{http_code}\n"
    403
    
    • 来自 sleep-allow 命名空间的 sleep 服务的请求通过了。
    $ kubectl exec "$(kubectl -n sleep-allow get pod -l app=sleep -o jsonpath={.items..metadata.name})" -c sleep -n sleep-allow -- curl http://httpbin.default:8000/ip -sS -o /dev/null -w "%{http_code}\n"
    200
    

迁移信任域但不使用别名

  1. 使用一个新的信任域安装 Istio。

    $ istioctl install --set profile=demo --set meshConfig.trustDomain=new-td
    
  2. 重新部署 istiod 以使信任域更改。

    $ kubectl rollout restart deployment -n istio-system istiod
    

    Istio 网格现在运行于一个新的信任域 new-td 了。

  3. 重新部署 httpbinsleep 应用以从新的 Istio 控制平面获取更新。

    $ kubectl delete pod --all
    
    $ kubectl delete pod --all -n sleep-allow
    
  4. 验证来自 defaultsleep-allow 命名空间的 sleephttpbin 的访问都被拒绝。

    $ kubectl exec "$(kubectl get pod -l app=sleep -o jsonpath={.items..metadata.name})" -c sleep -- curl http://httpbin.default:8000/ip -sS -o /dev/null -w "%{http_code}\n"
    403
    
    $ kubectl exec "$(kubectl -n sleep-allow get pod -l app=sleep -o jsonpath={.items..metadata.name})" -c sleep -n sleep-allow -- curl http://httpbin.default:8000/ip -sS -o /dev/null -w "%{http_code}\n"
    403
    

    这是因为我们指定了一个授权策略,它会拒绝所有到 httpbin 的请求,除非请求来源的身份是 old-td/ns/sleep-allow/sa/sleep,而这个身份是 sleep-allow 命名空间的 sleep 的旧身份。 当我们迁移到一个新的信任域,即 new-tdsleep 应用的身份就变成 new-td/ns/sleep-allow/sa/sleep,与 old-td/ns/sleep-allow/sa/sleep 不同。 因此,sleep-allow 命名空间中的 sleep 应用之前的请求被放行,但现在被拒绝。 在 Istio 1.4 之前,修复该问题的唯一方式就是手动调整授权策略。 而在 Istio 1.4 中,我们引入了一种更简单的方法,如下所示。

使用别名迁移信任域

  1. 使用一个新的信任域和信任域别名安装 Istio。

    $ cat <<EOF > ./td-installation.yaml
    apiVersion: install.istio.io/v1alpha2
    kind: IstioControlPlane
    spec:
      meshConfig:
        trustDomain: new-td
        trustDomainAliases:
          - old-td
    EOF
    $ istioctl install --set profile=demo -f td-installation.yaml -y
    
  2. 不调整授权策略,验证到 httpbin 的请求:

    • 来自 default 命名空间的 sleep 的请求被拒绝。
    $ kubectl exec "$(kubectl get pod -l app=sleep -o jsonpath={.items..metadata.name})" -c sleep -- curl http://httpbin.default:8000/ip -sS -o /dev/null -w "%{http_code}\n"
    403
    
    • 来自 sleep-allow 命名空间的 sleep 通过了。
    $ kubectl exec "$(kubectl -n sleep-allow get pod -l app=sleep -o jsonpath={.items..metadata.name})" -c sleep -n sleep-allow -- curl http://httpbin.default:8000/ip -sS -o /dev/null -w "%{http_code}\n"
    200
    

最佳实践

从 Istio 1.4 起,在编辑授权策略时,您应该在策略中的信任域部分使用 cluster.local。 例如,应该是 cluster.local/ns/sleep-allow/sa/sleep,而不是 old-td/ns/sleep-allow/sa/sleep。 请注意,在这种情况下,cluster.local 并不是 Istio 网格的信任域(信任域依然是 old-td)。 在策略中,cluster.local 是一个指针,指向当前信任域,即 old-td(后来是 new-td)及其别名。 通过在授权策略中使用 cluster.local,当您迁移到新的信任域时,Istio 将检测到此情况,并将新的信任域视为旧的信任域,而无需包含别名。

清理

$ kubectl delete authorizationpolicy service-httpbin.default.svc.cluster.local
$ kubectl delete deploy httpbin; kubectl delete service httpbin; kubectl delete serviceaccount httpbin
$ kubectl delete deploy sleep; kubectl delete service sleep; kubectl delete serviceaccount sleep
$ istioctl x uninstall --purge
$ kubectl delete namespace sleep-allow istio-system
$ rm ./td-installation.yaml
这些信息有用吗?
Do you have any suggestions for improvement?

Thanks for your feedback!