#启用 Sidecar 注入

以下操作步骤使用 Bookinfo 应用演示配置 Sidecar 注入的各种方法。

#先决条件

• 已安装 Alauda Service Mesh v2 Operator，已创建 Istio 资源，并且 Operator 已成功部署 Istio。
• 已创建 IstioCNI 资源，并且 Operator 已部署所需的 IstioCNI Pod。
• 已创建计划加入网格的命名空间，并且 Istio 控制平面可以发现这些命名空间。
• 可选：计划加入网格的工作负载已完成部署。在后续示例中，Bookinfo 应用部署在 bookinfo 命名空间中，但尚未配置 Sidecar 注入（如步骤 2 所述）。有关详细信息，请参阅“部署 Bookinfo 应用”。

#使用命名空间标签启用 Sidecar 注入

此方法会将 Sidecar 代理注入给定命名空间中的所有工作负载。当该命名空间中的大多数工作负载都需要加入网格时，这是理想的方法。

#操作步骤

1. 使用以下命令检查 Istio 控制平面的修订版本名称：

   kubectl get istiorevisions

   您应看到类似以下示例的输出：

   示例输出

   NAME      NAMESPACE      PROFILE   READY   STATUS    IN USE   VERSION   AGE
   default   istio-system             True    Healthy   False    v1.30.4   2m

   由于修订版本名称为 default，因此可以使用标准注入标签，而无需指定确切的修订版本。

2. 运行以下命令，确认目标命名空间中的现有工作负载显示 1/1 个就绪容器。这可以验证 Pod 当前未运行 Sidecar。

   kubectl get pods -n bookinfo

   您应看到类似以下示例的输出：

   示例输出

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-c66556f6d-6zldd        1/1     Running   0          3m42s
   productpage-v1-5f568ff46d-kx7nn   1/1     Running   0          3m42s
   ratings-v1-74bcfcb96d-jp4xk       1/1     Running   0          3m42s
   reviews-v1-549bfb5f44-sv2n9       1/1     Running   0          3m42s
   reviews-v2-6486bc9868-56h7n       1/1     Running   0          3m42s
   reviews-v3-6c66dc6cdd-vmczd       1/1     Running   0          3m42s

3. 执行以下命令，为 bookinfo 命名空间应用注入标签：

   kubectl label namespace bookinfo istio-injection=enabled

   示例输出

   namespace/bookinfo labeled

4. 要应用 Sidecar 注入，请重新部署 bookinfo 命名空间中的工作负载。使用以下命令对所有 Deployment 发起滚动更新：

   kubectl -n bookinfo rollout restart deployments

#验证

1. 要验证发布是否完成，请检查新 Pod 是否显示处于 READY 状态的 2/2 个容器，这表示 Sidecar 注入成功。使用以下命令：

   kubectl get pods -n bookinfo

   您应看到类似以下示例的输出：

   示例输出

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-85c7fcfd5b-hftlt       2/2     Running   0          31s
   productpage-v1-775ffc67d8-482s6   2/2     Running   0          31s
   ratings-v1-6c79fdf684-d7jmn       2/2     Running   0          31s
   reviews-v1-685fb87cb6-rch6v       2/2     Running   0          31s
   reviews-v2-76c4659bc6-vjcd8       2/2     Running   0          31s
   reviews-v3-f7b4c8678-zdnm7        2/2     Running   0          31s

#将工作负载排除在网格之外

即使整个命名空间已启用注入，也可以阻止为特定工作负载注入 Sidecar。

#操作步骤

1. 编辑应用的 Deployment 资源。在此示例中，我们将排除 ratings-v1 服务。

   kubectl -n bookinfo edit deployments ratings-v1

2. 在 Deployment 的 spec.template.metadata.labels 部分中，添加标签 sidecar.istio.io/inject: "false" 以禁用 Sidecar 注入。

   kind: Deployment
   apiVersion: apps/v1
   metadata:
   name: ratings-v1
   namespace: bookinfo
   labels:
     app: ratings
     version: v1
   spec:
     template:
       metadata:
         labels:
           sidecar.istio.io/inject: "false"
   NOTE

   如果将此标签添加到 Deployment 顶层的 labels 部分，则不会影响 Sidecar 注入过程。

   更新 Deployment 时会触发发布，从而创建包含修改后 Pod 的新 ReplicaSet。

#验证

1. 执行以下命令，确认更新后的 Pod 不包含 Sidecar 容器，并显示 1/1 个运行中容器：

   kubectl get pods -n bookinfo

   您应看到类似以下示例的输出：

   示例输出

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-85c7fcfd5b-hftlt       2/2     Running   0          4m7s
   productpage-v1-775ffc67d8-482s6   2/2     Running   0          4m7s
   ratings-v1-7988b9b7f4-7hdwm       1/1     Running   0          16s
   reviews-v1-685fb87cb6-rch6v       2/2     Running   0          4m7s
   reviews-v2-76c4659bc6-vjcd8       2/2     Running   0          4m7s
   reviews-v3-f7b4c8678-zdnm7        2/2     Running   0          4m7s

#使用 Pod 标签启用 Sidecar 注入

使用此方法，可以选择单个工作负载进行 Sidecar 注入，而不必为整个命名空间启用注入。此方法最适用于只有少量工作负载需要加入服务网格的情况。此示例还展示了如何使用修订版本标签进行 Sidecar 注入，其中 Istio 资源名为 my-mesh。当一个集群中存在多个 Istio 控制平面，或在基于修订版本进行控制平面升级期间，必须使用不同的 Istio 资源名称。

#操作步骤

1. 运行以下命令，检查 Istio 控制平面的修订版本名称：

   kubectl get istiorevisions

   您应看到类似以下示例的输出：

   示例输出

   NAME      NAMESPACE      PROFILE   READY   STATUS    IN USE   VERSION   AGE
   my-mesh   istio-system             True    Healthy   False    v1.30.4   22s

   由于修订版本名称为 my-mesh，因此必须使用修订版本标签 istio.io/rev=my-mesh 来激活 Sidecar 注入。

2. 检查现有 Pod 是否显示处于 READY 状态的 1/1 个容器，以确认它们在未使用 Sidecar 的情况下运行。使用以下命令：

   kubectl get pods -n bookinfo

   您应看到类似以下示例的输出：

   示例输出

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-85c7fcfd5b-8kzrc       1/1     Running   0          74s
   productpage-v1-775ffc67d8-rtbxj   1/1     Running   0          74s
   ratings-v1-6c79fdf684-ntzdr       1/1     Running   0          74s
   reviews-v1-685fb87cb6-l9fvr       1/1     Running   0          74s
   reviews-v2-76c4659bc6-7gt2l       1/1     Running   0          74s
   reviews-v3-f7b4c8678-lw59c        1/1     Running   0          74s

3. 编辑应用的 Deployment 资源。在此示例中，修改 ratings-v1 服务。

   kubectl -n bookinfo edit deployments ratings-v1

4. 修改 Deployment 的 spec.template.metadata.labels 部分，添加所需的 Pod 注入标签或修订版本标签。此处为 istio.io/rev: my-mesh：

   kind: Deployment
   apiVersion: apps/v1
   metadata:
   name: ratings-v1
   namespace: bookinfo
   labels:
     app: ratings
     version: v1
   spec:
     template:
       metadata:
         labels:
           istio.io/rev: my-mesh
   NOTE

   将标签放在 Deployment 资源的顶层 labels 部分中不会影响 Sidecar 注入。

   此 Deployment 更新会发起发布，从而生成包含已更改 Pod 的新 ReplicaSet。

#验证

1. 验证只有 ratings-v1 Pod 显示 2/2 个就绪容器，以确认 Sidecar 已成功注入。运行以下命令：

   kubectl get pods -n bookinfo

   您应看到类似以下示例的输出：

   示例输出

   NAME                              READY   STATUS    RESTARTS   AGE
   details-v1-85c7fcfd5b-8kzrc       1/1     Running   0          2m29s
   productpage-v1-775ffc67d8-rtbxj   1/1     Running   0          2m29s
   ratings-v1-86d864565d-g8sqw       2/2     Running   0          17s
   reviews-v1-685fb87cb6-l9fvr       1/1     Running   0          2m29s
   reviews-v2-76c4659bc6-7gt2l       1/1     Running   0          2m29s
   reviews-v3-f7b4c8678-lw59c        1/1     Running   0          2m29s

2. 对要添加到网格中的任何其他工作负载重复相同的操作步骤。