Documentation
¶
Overview ¶
Package configuration contains Kubernetes controllers responsible for configuration.konghq.com grouped API types.
Index ¶
- Constants
- func NewLicenseCache() cache.Store
- func WrapKongLicenseReconcilerToDynamicCRDController(ctx context.Context, mgr ctrl.Manager, r *KongV1Alpha1KongLicenseReconciler) *crds.DynamicCRDController
- type AdminAPIsDiscoverer
- type CoreV1SecretReconciler
- type CoreV1ServiceReconciler
- type DiscoveredAdminAPIsCache
- type DiscoveryV1EndpointSliceReconciler
- type EndpointsNotifier
- type IncubatorV1Alpha1KongServiceFacadeReconciler
- func (r *IncubatorV1Alpha1KongServiceFacadeReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
- func (r *IncubatorV1Alpha1KongServiceFacadeReconciler) SetLogger(l logr.Logger)
- func (r *IncubatorV1Alpha1KongServiceFacadeReconciler) SetupWithManager(mgr ctrl.Manager) error
- type KongAdminAPIServiceReconciler
- type KongUpstreamPolicyReconciler
- type KongV1Alpha1IngressClassParametersReconciler
- func (r *KongV1Alpha1IngressClassParametersReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
- func (r *KongV1Alpha1IngressClassParametersReconciler) SetLogger(l logr.Logger)
- func (r *KongV1Alpha1IngressClassParametersReconciler) SetupWithManager(mgr ctrl.Manager) error
- type KongV1Alpha1KongLicenseReconciler
- func (r *KongV1Alpha1KongLicenseReconciler) GetLicense() mo.Option[kong.License]
- func (r *KongV1Alpha1KongLicenseReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
- func (r *KongV1Alpha1KongLicenseReconciler) SetLogger(l logr.Logger)
- func (r *KongV1Alpha1KongLicenseReconciler) SetupWithManager(mgr ctrl.Manager) error
- type KongV1Alpha1KongVaultReconciler
- type KongV1Beta1KongConsumerGroupReconciler
- type KongV1Beta1TCPIngressReconciler
- type KongV1Beta1UDPIngressReconciler
- type KongV1KongClusterPluginReconciler
- type KongV1KongConsumerReconciler
- type KongV1KongIngressReconciler
- type KongV1KongPluginReconciler
- type NetV1IngressClassReconciler
- type NetV1IngressReconciler
Constants ¶
const ( ConditionTypeProgrammed = "Programmed" // ConditionReasonPickedAsLatest represents that the KongLicense being picked as the newest one. ConditionReasonPickedAsLatest = "PickedAsLatest" // ConditionReasonReplacedByNewer represents that the KongLicense is replaced by other one that is newer. ConditionReasonReplacedByNewer = "ReplacedByNewer" )
const (
CACertLabelKey = "konghq.com/ca-cert"
)
const (
// LicenseControllerType annotates the controller type.
LicenseControllerType = "konghq.com/kong-ingress-controller"
)
Variables ¶
This section is empty.
Functions ¶
func NewLicenseCache ¶ added in v3.1.0
func WrapKongLicenseReconcilerToDynamicCRDController ¶ added in v3.1.0
func WrapKongLicenseReconcilerToDynamicCRDController( ctx context.Context, mgr ctrl.Manager, r *KongV1Alpha1KongLicenseReconciler, ) *crds.DynamicCRDController
WrapKongLicenseReconcilerToDynamicCRDController wraps KongLicenseReconciler to DynamicCRDController to watch precense of KongLicense CRD to avoid aborts if KongLicense is not installed when controller initialized.
Types ¶
type AdminAPIsDiscoverer ¶
type AdminAPIsDiscoverer interface {
AdminAPIsFromEndpointSlice(discoveryv1.EndpointSlice) (
sets.Set[adminapi.DiscoveredAdminAPI],
error,
)
}
type CoreV1SecretReconciler ¶
type CoreV1SecretReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
ReferenceIndexers ctrlref.CacheIndexers
}
CoreV1SecretReconciler reconciles Secret resources.
func (*CoreV1SecretReconciler) Reconcile ¶
func (r *CoreV1SecretReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects.
func (*CoreV1SecretReconciler) SetLogger ¶
func (r *CoreV1SecretReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*CoreV1SecretReconciler) SetupWithManager ¶
func (r *CoreV1SecretReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type CoreV1ServiceReconciler ¶
type CoreV1ServiceReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
ReferenceIndexers ctrlref.CacheIndexers
}
CoreV1ServiceReconciler reconciles Service resources
func (*CoreV1ServiceReconciler) Reconcile ¶
func (r *CoreV1ServiceReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*CoreV1ServiceReconciler) SetLogger ¶
func (r *CoreV1ServiceReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*CoreV1ServiceReconciler) SetupWithManager ¶
func (r *CoreV1ServiceReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type DiscoveredAdminAPIsCache ¶
type DiscoveredAdminAPIsCache map[k8stypes.NamespacedName]sets.Set[adminapi.DiscoveredAdminAPI]
type DiscoveryV1EndpointSliceReconciler ¶
type DiscoveryV1EndpointSliceReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
}
DiscoveryV1EndpointSliceReconciler reconciles EndpointSlice resources
func (*DiscoveryV1EndpointSliceReconciler) Reconcile ¶
func (r *DiscoveryV1EndpointSliceReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*DiscoveryV1EndpointSliceReconciler) SetLogger ¶
func (r *DiscoveryV1EndpointSliceReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*DiscoveryV1EndpointSliceReconciler) SetupWithManager ¶
func (r *DiscoveryV1EndpointSliceReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type EndpointsNotifier ¶
type EndpointsNotifier interface {
Notify(adminAPIs []adminapi.DiscoveredAdminAPI)
}
type IncubatorV1Alpha1KongServiceFacadeReconciler ¶ added in v3.1.0
type IncubatorV1Alpha1KongServiceFacadeReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
StatusQueue *status.Queue
IngressClassName string
DisableIngressClassLookups bool
}
IncubatorV1Alpha1KongServiceFacadeReconciler reconciles KongServiceFacade resources
func (*IncubatorV1Alpha1KongServiceFacadeReconciler) Reconcile ¶ added in v3.1.0
func (r *IncubatorV1Alpha1KongServiceFacadeReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*IncubatorV1Alpha1KongServiceFacadeReconciler) SetLogger ¶ added in v3.1.0
func (r *IncubatorV1Alpha1KongServiceFacadeReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*IncubatorV1Alpha1KongServiceFacadeReconciler) SetupWithManager ¶ added in v3.1.0
func (r *IncubatorV1Alpha1KongServiceFacadeReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongAdminAPIServiceReconciler ¶
type KongAdminAPIServiceReconciler struct {
client.Client
// ServiceNN is the service NamespacedName to watch EndpointSlices for.
ServiceNN k8stypes.NamespacedName
Log logr.Logger
CacheSyncTimeout time.Duration
// EndpointsNotifier is used to notify about Admin API endpoints changes.
// We're going to call this only with endpoints when they change.
EndpointsNotifier EndpointsNotifier
Cache DiscoveredAdminAPIsCache
AdminAPIsDiscoverer AdminAPIsDiscoverer
}
KongAdminAPIServiceReconciler reconciles Kong Admin API Service Endpointslices and notifies the provided notifier about those.
func (*KongAdminAPIServiceReconciler) Reconcile ¶
func (r *KongAdminAPIServiceReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects.
func (*KongAdminAPIServiceReconciler) SetLogger ¶
func (r *KongAdminAPIServiceReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongAdminAPIServiceReconciler) SetupWithManager ¶
func (r *KongAdminAPIServiceReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongUpstreamPolicyReconciler ¶ added in v3.1.0
type KongUpstreamPolicyReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
StatusQueue *status.Queue
// KongServiceFacadeEnabled determines whether the controller should populate the KongUpstreamPolicy's ancestor
// status for KongServiceFacades.
KongServiceFacadeEnabled bool
// HTTPRouteEnabled determines whether the controller should populate the KongUpstreamPolicy's
// ancestor status for Services used in HTTPRoutes.
HTTPRouteEnabled bool
}
KongUpstreamPolicyReconciler reconciles KongUpstreamPolicy resources.
func (*KongUpstreamPolicyReconciler) Reconcile ¶ added in v3.1.0
func (r *KongUpstreamPolicyReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects.
func (*KongUpstreamPolicyReconciler) SetLogger ¶ added in v3.1.0
func (r *KongUpstreamPolicyReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongUpstreamPolicyReconciler) SetupWithManager ¶ added in v3.1.0
func (r *KongUpstreamPolicyReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1Alpha1IngressClassParametersReconciler ¶
type KongV1Alpha1IngressClassParametersReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
}
KongV1Alpha1IngressClassParametersReconciler reconciles IngressClassParameters resources
func (*KongV1Alpha1IngressClassParametersReconciler) Reconcile ¶
func (r *KongV1Alpha1IngressClassParametersReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1Alpha1IngressClassParametersReconciler) SetLogger ¶
func (r *KongV1Alpha1IngressClassParametersReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1Alpha1IngressClassParametersReconciler) SetupWithManager ¶
func (r *KongV1Alpha1IngressClassParametersReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1Alpha1KongLicenseReconciler ¶ added in v3.1.0
type KongV1Alpha1KongLicenseReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
LicenseCache cache.Store
CacheSyncTimeout time.Duration
StatusQueue *status.Queue
// ControllerName is the name of the controller to use in `controllerName` field in controller status item.
ControllerName string
// contains filtered or unexported fields
}
KongV1Alpha1KongLicenseReconciler reconciles KongLicense resources.
func (*KongV1Alpha1KongLicenseReconciler) GetLicense ¶ added in v3.1.0
func (r *KongV1Alpha1KongLicenseReconciler) GetLicense() mo.Option[kong.License]
GetLicense is the interface to get the license in Kong configuration format to use in translator.
func (*KongV1Alpha1KongLicenseReconciler) Reconcile ¶ added in v3.1.0
func (r *KongV1Alpha1KongLicenseReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects.
func (*KongV1Alpha1KongLicenseReconciler) SetLogger ¶ added in v3.1.0
func (r *KongV1Alpha1KongLicenseReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1Alpha1KongLicenseReconciler) SetupWithManager ¶ added in v3.1.0
func (r *KongV1Alpha1KongLicenseReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1Alpha1KongVaultReconciler ¶ added in v3.1.0
type KongV1Alpha1KongVaultReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
StatusQueue *status.Queue
IngressClassName string
DisableIngressClassLookups bool
}
KongV1Alpha1KongVaultReconciler reconciles KongVault resources
func (*KongV1Alpha1KongVaultReconciler) Reconcile ¶ added in v3.1.0
func (r *KongV1Alpha1KongVaultReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1Alpha1KongVaultReconciler) SetLogger ¶ added in v3.1.0
func (r *KongV1Alpha1KongVaultReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1Alpha1KongVaultReconciler) SetupWithManager ¶ added in v3.1.0
func (r *KongV1Alpha1KongVaultReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1Beta1KongConsumerGroupReconciler ¶
type KongV1Beta1KongConsumerGroupReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
StatusQueue *status.Queue
IngressClassName string
DisableIngressClassLookups bool
ReferenceIndexers ctrlref.CacheIndexers
}
KongV1Beta1KongConsumerGroupReconciler reconciles KongConsumerGroup resources
func (*KongV1Beta1KongConsumerGroupReconciler) Reconcile ¶
func (r *KongV1Beta1KongConsumerGroupReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1Beta1KongConsumerGroupReconciler) SetLogger ¶
func (r *KongV1Beta1KongConsumerGroupReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1Beta1KongConsumerGroupReconciler) SetupWithManager ¶
func (r *KongV1Beta1KongConsumerGroupReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1Beta1TCPIngressReconciler ¶
type KongV1Beta1TCPIngressReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
DataplaneAddressFinder *dataplane.AddressFinder
StatusQueue *status.Queue
IngressClassName string
DisableIngressClassLookups bool
ReferenceIndexers ctrlref.CacheIndexers
}
KongV1Beta1TCPIngressReconciler reconciles TCPIngress resources
func (*KongV1Beta1TCPIngressReconciler) Reconcile ¶
func (r *KongV1Beta1TCPIngressReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1Beta1TCPIngressReconciler) SetLogger ¶
func (r *KongV1Beta1TCPIngressReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1Beta1TCPIngressReconciler) SetupWithManager ¶
func (r *KongV1Beta1TCPIngressReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1Beta1UDPIngressReconciler ¶
type KongV1Beta1UDPIngressReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
DataplaneAddressFinder *dataplane.AddressFinder
StatusQueue *status.Queue
IngressClassName string
DisableIngressClassLookups bool
}
KongV1Beta1UDPIngressReconciler reconciles UDPIngress resources
func (*KongV1Beta1UDPIngressReconciler) Reconcile ¶
func (r *KongV1Beta1UDPIngressReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1Beta1UDPIngressReconciler) SetLogger ¶
func (r *KongV1Beta1UDPIngressReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1Beta1UDPIngressReconciler) SetupWithManager ¶
func (r *KongV1Beta1UDPIngressReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1KongClusterPluginReconciler ¶
type KongV1KongClusterPluginReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
IngressClassName string
DisableIngressClassLookups bool
ReferenceIndexers ctrlref.CacheIndexers
}
KongV1KongClusterPluginReconciler reconciles KongClusterPlugin resources
func (*KongV1KongClusterPluginReconciler) Reconcile ¶
func (r *KongV1KongClusterPluginReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1KongClusterPluginReconciler) SetLogger ¶
func (r *KongV1KongClusterPluginReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1KongClusterPluginReconciler) SetupWithManager ¶
func (r *KongV1KongClusterPluginReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1KongConsumerReconciler ¶
type KongV1KongConsumerReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
StatusQueue *status.Queue
IngressClassName string
DisableIngressClassLookups bool
ReferenceIndexers ctrlref.CacheIndexers
}
KongV1KongConsumerReconciler reconciles KongConsumer resources
func (*KongV1KongConsumerReconciler) Reconcile ¶
func (r *KongV1KongConsumerReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1KongConsumerReconciler) SetLogger ¶
func (r *KongV1KongConsumerReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1KongConsumerReconciler) SetupWithManager ¶
func (r *KongV1KongConsumerReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1KongIngressReconciler ¶
type KongV1KongIngressReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
}
KongV1KongIngressReconciler reconciles KongIngress resources
func (*KongV1KongIngressReconciler) Reconcile ¶
func (r *KongV1KongIngressReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1KongIngressReconciler) SetLogger ¶
func (r *KongV1KongIngressReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1KongIngressReconciler) SetupWithManager ¶
func (r *KongV1KongIngressReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type KongV1KongPluginReconciler ¶
type KongV1KongPluginReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
ReferenceIndexers ctrlref.CacheIndexers
}
KongV1KongPluginReconciler reconciles KongPlugin resources
func (*KongV1KongPluginReconciler) Reconcile ¶
func (r *KongV1KongPluginReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*KongV1KongPluginReconciler) SetLogger ¶
func (r *KongV1KongPluginReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*KongV1KongPluginReconciler) SetupWithManager ¶
func (r *KongV1KongPluginReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type NetV1IngressClassReconciler ¶
type NetV1IngressClassReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
}
NetV1IngressClassReconciler reconciles IngressClass resources
func (*NetV1IngressClassReconciler) Reconcile ¶
func (r *NetV1IngressClassReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*NetV1IngressClassReconciler) SetLogger ¶
func (r *NetV1IngressClassReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*NetV1IngressClassReconciler) SetupWithManager ¶
func (r *NetV1IngressClassReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.
type NetV1IngressReconciler ¶
type NetV1IngressReconciler struct {
client.Client
Log logr.Logger
Scheme *runtime.Scheme
DataplaneClient controllers.DataPlane
CacheSyncTimeout time.Duration
DataplaneAddressFinder *dataplane.AddressFinder
StatusQueue *status.Queue
IngressClassName string
DisableIngressClassLookups bool
ReferenceIndexers ctrlref.CacheIndexers
}
NetV1IngressReconciler reconciles Ingress resources
func (*NetV1IngressReconciler) Reconcile ¶
func (r *NetV1IngressReconciler) Reconcile(ctx context.Context, req ctrl.Request) (ctrl.Result, error)
Reconcile processes the watched objects
func (*NetV1IngressReconciler) SetLogger ¶
func (r *NetV1IngressReconciler) SetLogger(l logr.Logger)
SetLogger sets the logger.
func (*NetV1IngressReconciler) SetupWithManager ¶
func (r *NetV1IngressReconciler) SetupWithManager(mgr ctrl.Manager) error
SetupWithManager sets up the controller with the Manager.