全部产品
Search

搜索本产品

    服务网格 ASM：宽松模式流量泳道实施前的准备

    文档中心

    服务网格 ASM：宽松模式流量泳道实施前的准备

    更新时间：Dec 26, 2024

    在使用宽松模式的流量泳道实施全链路流量管理之前，需要进行一些准备工作，以确保在开始执行后续场景中的具体步骤之前，已经满足了所有必要的条件，从而避免遇到不必要的错误和障碍。本文介绍使用宽松模式流量泳道实施全链路流量管理前的一些准备工作。

    前提条件

    准备工作

    创建ingressgateway网关规则

    使用以下内容创建ingressgateway且命名空间为istio-system的网关规则。具体操作，请参见管理网关规则。

    展开查看网关规则YAML示例

    apiVersion: networking.istio.io/v1beta1
kind: Gateway
metadata:
  name: ingressgateway
  namespace: istio-system
spec:
  selector:
    istio: ingressgateway
  servers:
    - port:
        number: 80
        name: http
        protocol: HTTP
      hosts:
        - '*'

    部署示例服务（适用于场景一、场景二）

    1. 为default命名空间启用Sidecar网格代理自动注入。具体操作，请参见启用自动注入。

      关于自动注入的更多信息，请参见配置Sidecar注入策略。

    2. 在ACK集群中执行以下命令，部署示例服务。

      kubectl apply -f https://alibabacloudservicemesh.oss-cn-beijing.aliyuncs.com/asm-labs/swimlane/v1/mock-tracing-v1.yaml
kubectl apply -f https://alibabacloudservicemesh.oss-cn-beijing.aliyuncs.com/asm-labs/swimlane/v2/mock-tracing-v2.yaml
kubectl apply -f https://alibabacloudservicemesh.oss-cn-beijing.aliyuncs.com/asm-labs/swimlane/v3/mock-tracing-v3.yaml
      说明

      场景一、场景二中的示例应用基于Golang开发，场景三中的示例应用基于Java开发。这是由于baggage透传机制对于服务采用的开发语言存在限制。更多信息，请参见Auto-instrumentation。

    配置服务透传Baggage上下文（适用于场景三）

    本节主要展示如何通过OpenTelemetry Operator自动插装的方法，为Kubernetes集群中的服务添加Baggage透传能力。

    1. 部署OpenTelemetry Operator。

      1. 通过kubectl连接到ASM实例添加的Kubernetes集群。执行以下命令，创建opentelemetry-operator-system命名空间。

        kubectl create namespace opentelemetry-operator-system

      2. 执行以下命令，使用Helm在opentelemetry-operator-system命名空间下安装OpenTelemetry Operator。关于如何安装Helm，请参见Install Helm。

        helm repo add open-telemetry https://open-telemetry.github.io/opentelemetry-helm-charts
helm install  \
    --namespace=opentelemetry-operator-system \
    --version=0.46.0 \
    --set admissionWebhooks.certManager.enabled=false \
    --set admissionWebhooks.certManager.autoGenerateCert=true \
    --set manager.image.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/opentelemetry-operator" \
    --set manager.image.tag="0.92.1" \
    --set kubeRBACProxy.image.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/kube-rbac-proxy" \
    --set kubeRBACProxy.image.tag="v0.13.1" \
    --set manager.collectorImage.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/opentelemetry-collector" \
    --set manager.collectorImage.tag="0.97.0" \
    --set manager.opampBridgeImage.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/operator-opamp-bridge" \
    --set manager.opampBridgeImage.tag="0.97.0" \
    --set manager.targetAllocatorImage.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/target-allocator" \
    --set manager.targetAllocatorImage.tag="0.97.0" \
    --set manager.autoInstrumentationImage.java.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/autoinstrumentation-java" \
    --set manager.autoInstrumentationImage.java.tag="1.32.1" \
    --set manager.autoInstrumentationImage.nodejs.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/autoinstrumentation-nodejs" \
    --set manager.autoInstrumentationImage.nodejs.tag="0.49.1" \
    --set manager.autoInstrumentationImage.python.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/autoinstrumentation-python" \
    --set manager.autoInstrumentationImage.python.tag="0.44b0" \
    --set manager.autoInstrumentationImage.dotnet.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/autoinstrumentation-dotnet" \
    --set manager.autoInstrumentationImage.dotnet.tag="1.2.0" \
    --set manager.autoInstrumentationImage.go.repository="registry-cn-hangzhou.ack.aliyuncs.com/acs/opentelemetry-go-instrumentation" \
    --set manager.autoInstrumentationImage.go.tag="v0.10.1.alpha-2-aliyun" \
    opentelemetry-operator open-telemetry/opentelemetry-operator

      3. 执行以下命令，检查opentelemetry-operator是否正常运行。

        kubectl get pod -n opentelemetry-operator-system

        预期输出：

        NAME                                      READY   STATUS    RESTARTS   AGE
opentelemetry-operator-854fb558b5-pvllj   2/2     Running   0          1m

    2. 配置自动插装（auto-instrumentation）。

      1. 使用以下内容，创建instrumentation.yaml文件。

        重要

        未部署OpenTelemetry collector的自动插装配置未开启指标采集和链路追踪，若您已经部署了OpenTelemetry collector，并且希望上报指标采集和链路追踪数据，请参考已部署OpenTelemetry collector的自动插装配置。

        未部署OpenTelemetry collector

        apiVersion: opentelemetry.io/v1alpha1
kind: Instrumentation
metadata:
  name: demo-instrumentation
spec:
  env:
  - name: OTEL_METRICS_EXPORTER
    value: none
  propagators:
  - baggage
  sampler:
    argument: "1"
    type: always_off

        已部署OpenTelemetry collector

        apiVersion: opentelemetry.io/v1alpha1
kind: Instrumentation
metadata:
  name: demo-instrumentation
spec:
  propagators:
    - baggage
  sampler:
    type: parentbased_traceidratio
    argument: "1"

      2. 执行以下命令，在default命名空间下声明自动插装。

        kubectl apply -f instrumentation.yaml
        说明

        对于OpenTelemetry框架来说，其最佳实践还包括部署OpenTelemetry Collector以收集可观测数据。由于本文主要演示OpenTelemetry自动插装实现的Baggage链路透传，因此没有包含部署OpenTelemetry Collector的步骤。有关服务网格ASM如何通过OpenTelemetry上报链路追踪数据，请参考见将链路追踪数据采集到阿里云可观测链路OpenTelemetry版。