コントローラ マネージャーのレート制限を構成する

このページでは、Config Connector でコントローラ マネージャに全体的なレート制限（トークン バケット レート制限）を構成する方法について説明します。

レート制限は、Config Connector が Kubernetes API サーバーに送信するリクエストの数を制御します。次の 2 種類の設定があります。

  • qps（秒間クエリ数）設定は、Config Connector が Kubernetes API サーバーにリクエストを送信できる平均レートを決定します。

  • burst 値を使用すると、短期間に qps の上限を超えるリクエストが許可されます。これにより、GitOps を使用して新しい構成のバッチを適用する場合など、Kubernetes API サーバーへのクエリが必要になる場合でも、Config Connector による迅速な調整が可能になります。

レート制限の「トークン バケット」アルゴリズムは、容量 burst トークンのバケットが qps レートで補充されると考えることができます。各リクエストには、バケットから取得したトークンが 1 つ必要です。バケットが空の場合、トークンが使用可能になるまでリクエストは遅延します。

名前空間コントローラ マネージャーのレート制限を構成する

Config Connector が名前空間モードで実行されるように構成されている場合は、NamespacedControllerReconciler カスタム リソースを使用して、指定された名前空間内で cnrm-controller-manager コントローラの Kubernetes クライアントのレート制限を構成できます。このコントローラのレート制限は、Config Connector バージョン 1.119 以上で構成できます。

  1. configure-rate-limit.yaml という名前のファイルを作成して、次の YAML ファイルをコピーします。

    apiVersion: customize.core.cnrm.cloud.google.com/v1alpha1
kind: NamespacedControllerReconciler
metadata:
  name: cnrm-controller-manager # name must not contain the namespace ID suffix
  namespace: NAMESPACE
spec:
  rateLimit:
    qps: 80 # the default value is 20
    burst: 40 # the default value is 30

    NAMESPACE を実際のバケット名で置き換えます。

  2. kubectl apply を使用して、クラスタにレート制限の構成を適用します。

    kubectl apply -f configure-rate-limit.yaml

  3. 次のコマンドを実行して、構成が成功したことを確認します。

    kubectl get namespacedcontrollerreconciler cnrm-controller-manager -n NAMESPACE -o jsonpath='{.status.healthy}'

    出力には、true に設定された status.healthy フィールドが表示されます。

  4. 次のコマンドを実行して、--qps フラグと --burst フラグが cnrm-controller-manager コントローラのマネージャー コンテナに追加されたことを確認します。

    kubectl describe statefulsets -n cnrm-system -l "cnrm.cloud.google.com/scoped-namespace=NAMESPACE"

    出力に次の内容が含まれているはずです。

    Containers:
manager:
  Image:      gcr.io/gke-release/cnrm/controller:fd4c42c
  Port:       23232/TCP
  Host Port:  0/TCP
  Command:
    /configconnector/manager
  Args:
    --qps=80
    --burst=40
    --scoped-namespace=config-control
    --prometheus-scrape-endpoint=:8888