kubernetes-sigs/controller-runtime

これは何？

主な機能

• 01複数のコントローラーを実行・調整するManager
• 02監視対象やreconcileロジックを宣言するBuilder API
• 03Kubernetesオブジェクトの読み書きに使うキャッシュ付きClient
• 04Webhookとリーダー選出への対応
• 05各リリースとclient-goおよびGoのバージョンの対応を示す互換性テーブル

ユースケース

• GoでカスタムKubernetes Operatorを構築する
• カスタムリソース定義をreconcileするコントローラーを記述する
• Kubebuilderで生成したプロジェクトにコントローラーロジックを追加する

クイックスタート

1. 1

   このライブラリを基盤とする Kubebuilder または Operator SDK から始めましょう（Kubebuilder のクイックスタートを参照）

使う前に知っておきたいこと

• !このプロジェクトはメジャーバージョン 0 のままで、マイナーバージョン間で破壊的変更が行われることがあります。
• !各マイナーバージョンには、対応する client-go のバージョンと最低 Go バージョンが定められているため、Kubernetes の依存関係と一致させる必要があります。

収録されている特集

トピック

よくある質問

controller-runtime とは？

KubernetesコントローラーやOperatorの構築に使うGoライブラリ群。KubebuilderとOperator SDKの基盤です。 controller-runtimeは、Kubernetesコントローラーを記述するためのGoライブラリ群です。コントローラーはクラスター内のリソースを監視し、APIで宣言された望ましい状態に実際の状態を近づけます。このライブラリは、コントローラーを実行するManager、監視対象やreconcileループを設定するBuilder、オブジェクトの読み書きを行うClientなど、このパターンに必要な共通機能を提供します。

controller-runtime は無料で使えますか？ライセンスは？

controller-runtime は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

controller-runtime は今もメンテナンスされていますか？

活発にメンテナンス中。controller-runtime の最終コミットは 2026年11月5日 です。

controller-runtime は何に使えますか？

GoでカスタムKubernetes Operatorを構築する カスタムリソース定義をreconcileするコントローラーを記述する Kubebuilderで生成したプロジェクトにコントローラーロジックを追加する

controller-runtime のインストール方法は？

このライブラリを基盤とする Kubebuilder または Operator SDK から始めましょう（Kubebuilder のクイックスタートを参照）

controller-runtime はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/kubernetes-sigs/controller-runtime