Rebalancer は指定したポリシーに基づき外部のメトリクスを参照して複数環境間の重み付けを調整するための Kubernetes Operator です。
実行するのに Kubernetes クラスタが必要です。ローカル環境で検証するには KIND を利用してください。
- Install Instances of Custom Resources:
make install- Build and push your image to the location specified by
IMG:
make docker-build docker-push IMG=<some-registry>/rebalance-controller:tag- Deploy the controller to the cluster with the image specified by
IMG:
make deploy IMG=<some-registry>/rebalance-controller:tagTo delete the CRDs from the cluster:
make uninstallUnDeploy the controller to the cluster:
make undeploy
Policyはどのような戦略で重み付けをするかの設定です。
Targetは重み付けの操作対象でRoute53のweightedレコードなどを設定します。現在のweightを取得したり、Policyによって決定されたweightに更新されます。
MetricsはPrometheus等のメトリクスサーバーと実行するクエリを設定します。Policyが最適なweightを計算するのに使われます。
次の例は、prometheusでtest-svcへの分間リクエスト数が1000 req/min以下になるようtargetで指定しているRoute53のexample.com Aレコードのweightを自動調整する設定です。
基準となるレコードのweightが8に設定されているため、spec.policy.targettracking.baseValueが8に設定されています。
このとき3000req/minあった場合、targetのweightは16に設定されます。
apiVersion: rebalancer.ch1aki.github.io/v1
kind: Rebalance
metadata:
name: aws-env
spec:
dryRun: true
interval: 1m
policy:
targettracking:
targetValue: 1000 # metricsで維持してほしい値
baseValue: 8 # ベースとなるweight
target:
route53:
hostedZoneID: hostedzone/XXXXXXXXXX
region: ap-northeast-1
resource:
name: example.com
type: A
identifier: aws
auth:
secretRef:
accessKeyIDSecretRef:
name: rebalancer-aws-secret
key: access-key
secretAccessKeySecretRef:
name: rebalancer-aws-secret
key: secret-access-key
metrics:
prometheus:
address: http://prometheus-operated-exposed.nke-system.svc.cluster.local:9090
timeout: 30
query: |-
sum(irate(istio_requests_total{reporter="source",destination_service_name=~"test-svc"}[5m]))このプロジェクトはKubernetes Operator pattern に従うことを目指します。
クラスターで目的の状態に達するまでリソースを同期する調整機能を提供する Controller を利用します。
- 開発ツールをaquaを利用してインストールします:
aqua install- 開発用のローカルkindクラスタを起動します:
make start- Tiltを起動します:
tilt up