Istio で管理されるサービスの Java エージェントのインストール - Application Real-Time Monitoring Service

ack-onepilot コンポーネントは、init コンテナを使用して、Java アプリケーションが開始する前に Application Real-Time Monitoring Service (ARMS) エージェントを準備します。ack-onepilot を Istio と共に使用する場合、ネットワーク構成が標準クラスターとは異なります。このトピックでは、ack-onepilot コンポーネントをアップグレードするか、古いバージョンで Istio との互換性を確保するための設定を行う方法について説明します。

ステップ 1：ack-onepilot コンポーネントのインストール

Container Service for Kubernetes (ACK) クラスターについては、「ack-onepilot コンポーネントを使用して ACK および ACS クラスターに Java エージェントをインストールする」をご参照ください。
ACK One 登録済みクラスターについては、「Application Real-Time Monitoring Service (ARMS) を登録済みクラスターに接続する」をご参照ください。
自己管理型 Kubernetes クラスターについては、「自己管理型 Kubernetes クラスターにエージェントを自動的にインストールする」をご参照ください。

重要

ack-onepilot をバージョン 3.0.19 以降にアップグレードすると、istio-proxy のインターセプト構成が自動的に変更されます。この場合、ステップ 2 をスキップできます。コンポーネントをアップグレードするには、「コンポーネントの管理」をご参照ください。
istio-proxy インターセプト構成の自動変更を無効にするには、ack-onepilot をバージョン 4.1.2 以降にアップグレードし、対応するオプションを false に設定します。次の手順を実行します：
1. ACK コンソールにログインします。左側のナビゲーションウィンドウで、クラスターリスト をクリックします。
2. クラスターリスト ページで、対象クラスターの名前をクリックします。左側のナビゲーションウィンドウで、ワークロード > デプロイメント をクリックします。
3. ステータスなし ページで、ack-onepilot コンポーネントをクリックします。このコンポーネントは通常 ack-onepilot-ack-onepilot という名前で、ack-onepilot 名前空間にあります。
4. コンポーネントの詳細ページで、右上の [編集] をクリックします。次に、ARMS_ISTIO_AUTO_INJECT_ENABLE 環境変数を false に設定します。

ステップ 2：istio-proxy インターセプト構成の変更

次の VIP 範囲を Pod のアノテーションにカンマ区切りで追加します。

除外する IP 範囲

リージョン	リージョン ID	VPC エンドポイント	VIP 範囲
中国 (杭州)	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
中国 (上海)	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
中国 (青島)	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
中国 (北京)	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
中国 (張家口)	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
中国 (フフホト)	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
中国 (ウランチャブ)	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
中国 (深セン)	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
中国 (河源)	oss-cn-heyuan	oss-cn-heyuan-internal.aliyuncs.com	100.98.83.0/24 100.118.174.0/24
中国 (広州)	oss-cn-guangzhou	oss-cn-guangzhou-internal.aliyuncs.com	100.115.33.0/24 100.114.101.0/24
中国 (成都)	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
中国 (香港)	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
日本 (東京)	oss-ap-northeast-1	oss-ap-northeast-1-internal.aliyuncs.com	100.114.211.0/24 100.114.114.0/25
シンガポール	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
マレーシア (クアラルンプール)	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
インドネシア (ジャカルタ)	oss-ap-southeast-5	oss-ap-southeast-5-internal.aliyuncs.com	100.114.98.0/24
ドイツ (フランクフルト)	oss-eu-central-1	oss-eu-central-1-internal.aliyuncs.com	100.115.154.0/24
イギリス (ロンドン)	oss-eu-west-1	oss-eu-west-1-internal.aliyuncs.com	100.114.114.128/25
米国 (シリコンバレー)	oss-us-west-1	oss-us-west-1-internal.aliyuncs.com	100.115.107.0/24
米国 (バージニア)	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
サウジアラビア (リヤド - パートナー運営)	me-central-1	oss-me-central-1-internal.aliyuncs.com	100.99.121.0/24

中国 (杭州) リージョンの例：

  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"

アプリケーションの YAML ファイルの spec.template.metadata セクションに、次の annotations を追加します。

完全な YAML の例

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
---