分散プロファイリング用の XProf Kubernetes デプロイ

このドキュメントでは、ワーカーとアグリゲータに個別のデプロイを使用して、Kubernetes の分散設定で XProf をデプロイする方法について説明します。

Kubernetes 用の XProf アグリゲータワーカーアーキテクチャ

前提条件

Kubernetes クラスタ。このチュートリアルでは、最小限のセットアップに minikube を使用します。
XProf の Docker イメージ。ビルド方法については、XProf Docker イメージのビルドをご覧ください。

Kubernetes の構成

次の YAML 構成は、XProf ワーカーとアグリゲータの Kubernetes Deployment と Service を定義します。

アグリゲータのデプロイは、ユーザーリクエストを受信し、ラウンドロビンポリシーを使用してプロファイリングタスクをワーカーレプリカに分散する単一のレプリカを実行します。--worker_service_address フラグは、ワーカーサービスにリクエストを送信するようにアグリゲータを構成します。

ワーカーデプロイは複数のレプリカを実行します。各レプリカは、--grpc_port フラグを介して gRPC ポートを公開し、アグリゲータからの処理タスクをリッスンします。

情報集約サイト

まず、agg.yaml ファイルを作成し、次の内容を貼り付けます。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: xprof-aggregator-deployment
  labels:
    app: xprof-aggregator-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: xprof-aggregator-app
  template:
    metadata:
      labels:
        app: xprof-aggregator-app
    spec:
      containers:
      - name: aggregator-container
        image: xprof:2.21.3
        imagePullPolicy: Never
        env:
        - name: GRPC_LB_POLICY
          value: "round_robin"
        - name: GRPC_DNS_RESOLVER
          value: "native"
        args:
          - "--port=10000"
          - "--worker_service_address=dns:///xprof-worker-service.default.svc.cluster.local:8891"
          - "-gp=50051"
          - "--hide_capture_profile_button"
        ports:
        - containerPort: 10000

---
apiVersion: v1
kind: Service
metadata:
  name: xprof-agg-service
  labels:
    app: xprof-aggregator-app
spec:
  selector:
    app: xprof-aggregator-app
  type: NodePort
  ports:
  - protocol: TCP
    port: 80
    targetPort: 10000
    nodePort: 30001

ワーカー

ワーカー用に worker.yaml ファイルを作成します。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: xprof-worker-deployment
  labels:
    app: xprof-worker-app
spec:
  replicas: 4
  selector:
    matchLabels:
      app: xprof-worker-app
  template:
    metadata:
      labels:
        app: xprof-worker-app
    spec:
      containers:
      - name: worker-container
        image: xprof:2.21.3
        imagePullPolicy: Never
        args:
          - "--port=9999"
          - "-gp=8891"
          - "--hide_capture_profile_button"
        ports:
        - containerPort: 8891

---
apiVersion: v1
kind: Service
metadata:
  name: xprof-worker-service
  labels:
    app: xprof-worker-app
spec:
  selector:
    app: xprof-worker-app
  clusterIP: None
  ports:
  - protocol: TCP
    port: 80
    targetPort: 8891

Minikube の設定

セットアップをデプロイするには、次のコマンドを実行します。

kubectl apply -f worker.yaml
kubectl apply -f agg.yaml

デプロイされたオブジェクトを検査できる必要があります。

kubectl get services

NAME                   TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)          AGE
kubernetes             ClusterIP   10.96.0.1      <none>        443/TCP          13h
xprof-agg-service      NodePort    10.96.13.172   <none>        8080:30001/TCP   13h
xprof-worker-service   ClusterIP   None           <none>        80/TCP           13h

次に、アグリゲータに接続します。

minikube service xprof-agg-service --url

http://127.0.0.1:50609
❗  Because you are using a Docker driver on darwin, the terminal needs to be open to run it.

これで、ブラウザでアクセスできるようになりました。

XProf アグリゲータのランディングページ