Tous les produits
Search

Ce produit

    Application Real-Time Monitoring Service:Installation de l'agent Java pour les services gérés par Istio

    Centre de documentation

    Application Real-Time Monitoring Service:Installation de l'agent Java pour les services gérés par Istio

    Dernière mise à jour :Aug 10, 2026

    Le composant ack-onepilot utilise un conteneur d'initialisation pour préparer l'agent Application Real-Time Monitoring Service (ARMS) d'une application Java avant son démarrage. Lorsque vous utilisez ack-onepilot avec Istio, la configuration réseau diffère de celle d'un cluster standard. Cette rubrique explique comment mettre à niveau le composant ack-onepilot ou configurer les versions antérieures pour assurer la compatibilité avec Istio.

    Étape 1 : Installation du composant ack-onepilot

    Important

    • Si vous mettez à niveau ack-onepilot vers la version 3.0.19 ou ultérieure, le composant modifie automatiquement la configuration d'interception istio-proxy. Dans ce cas, ignorez l'Étape 2. Pour mettre à niveau le composant, consultez la rubrique Gestion des composants.

    • Pour désactiver la modification automatique de la configuration d'interception istio-proxy, mettez à niveau ack-onepilot vers la version 4.1.2 ou ultérieure et définissez l'option correspondante sur false. Procédez comme suit :

      1. Connectez-vous à la console ACK. Dans le volet de navigation de gauche, cliquez sur Clusters.

      2. Sur la page Clusters, cliquez sur le nom de votre cluster. Dans le volet de navigation de gauche, cliquez sur Workloads > Deployments.

      3. Sur la page Stateless, cliquez sur le composant ack-onepilot, généralement nommé ack-onepilot-ack-onepilot et situé dans le namespace ack-onepilot.

      4. Sur la page des détails du composant, cliquez sur Edit dans le coin supérieur droit. Définissez ensuite la variable d'environnement ARMS_ISTIO_AUTO_INJECT_ENABLE sur false.

    Étape 2 : Modification de la configuration d'interception istio-proxy

    1. Ajoutez les plages d'adresses VIP suivantes à l'annotation de votre pod, en les séparant par des virgules.

      Plages d'adresses IP exclues

      Région

      ID de région

      Endpoint VPC

      Plage d'adresses VIP

      Chine (Hangzhou)

      oss-cn-hangzhou

      oss-cn-hangzhou-internal.aliyuncs.com

      • 100.118.28.0/24

      • 100.114.102.0/24

      • 100.98.170.0/24

      • 100.118.31.0/24

      Chine (Shanghai)

      oss-cn-shanghai

      oss-cn-shanghai-internal.aliyuncs.com

      • 100.98.35.0/24

      • 100.98.110.0/24

      • 100.98.169.0/24

      • 100.118.102.0/24

      Chine (Qingdao)

      oss-cn-qingdao

      oss-cn-qingdao-internal.aliyuncs.com

      • 100.115.173.0/24

      • 100.99.113.0/24

      • 100.99.114.0/24

      • 100.99.115.0/24

      Chine (Pékin)

      oss-cn-beijing

      oss-cn-beijing-internal.aliyuncs.com

      • 100.118.58.0/24

      • 100.118.167.0/24

      • 100.118.170.0/24

      • 100.118.171.0/24

      • 100.118.172.0/24

      • 100.118.173.0/24

      Chine (Zhangjiakou)

      oss-cn-zhangjiakou

      oss-cn-zhangjiakou-internal.aliyuncs.com

      • 100.118.90.0/24

      • 100.98.159.0/24

      • 100.114.0.0/24

      • 100.114.1.0/24

      Chine (Hohhot)

      oss-cn-huhehaote

      oss-cn-huhehaote-internal.aliyuncs.com

      • 100.118.195.0/24

      • 100.99.110.0/24

      • 100.99.111.0/24

      • 100.99.112.0/24

      Chine (Ulanqab)

      oss-cn-wulanchabu

      oss-cn-wulanchabu-internal.aliyuncs.com

      • 100.114.11.0/24

      • 100.114.12.0/24

      • 100.114.100.0/24

      • 100.118.214.0/24

      Chine (Shenzhen)

      oss-cn-shenzhen

      oss-cn-shenzhen-internal.aliyuncs.com

      • 100.118.78.0/24

      • 100.118.203.0/24

      • 100.118.204.0/24

      • 100.118.217.0/24

      Chine (Heyuan)

      oss-cn-heyuan

      oss-cn-heyuan-internal.aliyuncs.com

      • 100.98.83.0/24

      • 100.118.174.0/24

      Chine (Guangzhou)

      oss-cn-guangzhou

      oss-cn-guangzhou-internal.aliyuncs.com

      • 100.115.33.0/24

      • 100.114.101.0/24

      Chine (Chengdu)

      oss-cn-chengdu

      oss-cn-chengdu-internal.aliyuncs.com

      • 100.115.155.0/24

      • 100.99.107.0/24

      • 100.99.108.0/24

      • 100.99.109.0/24

      Chine (Hong Kong)

      oss-cn-hongkong

      oss-cn-hongkong-internal.aliyuncs.com

      • 100.115.61.0/24

      • 100.99.103.0/24

      • 100.99.104.0/24

      • 100.99.106.0/24

      Japon (Tokyo)

      oss-ap-northeast-1

      oss-ap-northeast-1-internal.aliyuncs.com

      • 100.114.211.0/24

      • 100.114.114.0/25

      Singapour

      oss-ap-southeast-1

      oss-ap-southeast-1-internal.aliyuncs.com

      • 100.118.219.0/24

      • 100.99.213.0/24

      • 100.99.116.0/24

      • 100.99.117.0/24

      Malaisie (Kuala Lumpur)

      oss-ap-southeast-3

      oss-ap-southeast-3-internal.aliyuncs.com

      • 100.118.165.0/24

      • 100.99.125.0/24

      • 100.99.130.0/24

      • 100.99.131.0/24

      Indonésie (Jakarta)

      oss-ap-southeast-5

      oss-ap-southeast-5-internal.aliyuncs.com

      100.114.98.0/24

      Allemagne (Francfort)

      oss-eu-central-1

      oss-eu-central-1-internal.aliyuncs.com

      100.115.154.0/24

      Royaume-Uni (Londres)

      oss-eu-west-1

      oss-eu-west-1-internal.aliyuncs.com

      100.114.114.128/25

      États-Unis (Silicon Valley)

      oss-us-west-1

      oss-us-west-1-internal.aliyuncs.com

      100.115.107.0/24

      États-Unis (Virginie)

      oss-us-east-1

      oss-us-east-1-internal.aliyuncs.com

      • 100.115.60.0/24

      • 100.99.100.0/24

      • 100.99.101.0/24

      • 100.99.102.0/24

      Arabie saoudite (Riyad - Région partenaire)

      me-central-1

      oss-me-central-1-internal.aliyuncs.com

      100.99.121.0/24

      Exemple pour la région Chine (Hangzhou) :

        traffic.sidecar.istio.io/excludeOutboundIPRanges: "100.118.28.0/24,100.114.102.0/24,100.98.170.0/24,100.118.31.0/24"

    2. Ajoutez les annotations suivantes à la section spec.template.metadata du fichier YAML de votre application.

      Exemple YAML complet

      apiVersion: v1
kind: Namespace
metadata:
  name: arms-demo
---
apiVersion: apps/v1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-springboot-demo
  namespace: arms-demo
  labels:
    app: arms-springboot-demo
spec:
  replicas: 2
  selector:
    matchLabels:
      app: arms-springboot-demo
  template:
    metadata:
      annotations:
          traffic.sidecar.istio.io/excludeOutboundIPRanges: "100.118.28.0/24,100.114.102.0/24,100.98.170.0/24,100.118.31.0/24"
      labels:
        app: arms-springboot-demo
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "arms-k8s-demo"
        one-agent.jdk.version: "OpenJDK18"
    spec:
      containers:
        - resources:
            limits:
              cpu: 0.5
          image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-springboot-demo:v0.1
          imagePullPolicy: Always
          name: arms-springboot-demo
          env:
            - name: SELF_INVOKE_SWITCH
              value: "true"
            - name: COMPONENT_HOST
              value: "arms-demo-component"
            - name: COMPONENT_PORT
              value: "6666"
            - name: MYSQL_SERVICE_HOST
              value: "arms-demo-mysql"
            - name: MYSQL_SERVICE_PORT
              value: "3306"
---
apiVersion: apps/v1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-springboot-demo-subcomponent
  namespace: arms-demo
  labels:
    app: arms-springboot-demo-subcomponent
spec:
  replicas: 2
  selector:
    matchLabels:
      app: arms-springboot-demo-subcomponent
  template:
    metadata:
      labels:
        app: arms-springboot-demo-subcomponent
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "arms-k8s-demo-subcomponent"
        one-agent.jdk.version: "OpenJDK18"
    spec:
      containers:
        - resources:
            limits:
              cpu: 0.5
          image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-springboot-demo:v0.1
          imagePullPolicy: Always
          name: arms-springboot-demo-subcomponent
          env:
            - name: SELF_INVOKE_SWITCH
              value: "false"
            - name: MYSQL_SERVICE_HOST
              value: "arms-demo-mysql"
            - name: MYSQL_SERVICE_PORT
              value: "3306"
---
apiVersion: v1
kind: Service
metadata:
  labels:
    name: arms-demo-component
  name: arms-demo-component
  namespace: arms-demo
spec:
  ports:
    # the port that this service should serve on
    - name: arms-demo-component-svc
      port: 6666
      targetPort: 8888
  # label keys and values that must match in order to receive traffic for this service
  selector:
    app: arms-springboot-demo-subcomponent
---
apiVersion: apps/v1 # for versions before 1.8.0 use apps/v1beta1
kind: Deployment
metadata:
  name: arms-demo-mysql
  namespace: arms-demo
  labels:
    app: mysql
spec:
  replicas: 1
  selector:
    matchLabels:
      app: mysql
  template:
    metadata:
      labels:
        app: mysql
    spec:
      containers:
        - resources:
            limits:
              cpu: 0.5
          image: registry.cn-hangzhou.aliyuncs.com/arms-docker-repo/arms-demo-mysql:v0.1
          name: mysql
          ports:
            - containerPort: 3306
              name: mysql
---
apiVersion: v1
kind: Service
metadata:
  labels:
    name: mysql
  name: arms-demo-mysql
  namespace: arms-demo
spec:
  ports:
    # the port that this service should serve on
    - name: arms-mysql-svc
      port: 3306
      targetPort: 3306
  # label keys and values that must match in order to receive traffic for this service
  selector:
    app: mysql
---