Skip to content

Commit

Permalink
fix(#4948): Refactor common logic between operator and platformcontro…
Browse files Browse the repository at this point in the history
…ller
  • Loading branch information
valdar committed May 13, 2024
1 parent 142ff7b commit f77f281
Show file tree
Hide file tree
Showing 11 changed files with 434 additions and 384 deletions.
2 changes: 1 addition & 1 deletion e2e/common/cli/config_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ import (
"strings"
"testing"

"github.com/apache/camel-k/v2/pkg/cmd"
corev1 "k8s.io/api/core/v1"

. "github.com/onsi/gomega"
Expand All @@ -36,7 +37,6 @@ import (

. "github.com/apache/camel-k/v2/e2e/support"
v1 "github.com/apache/camel-k/v2/pkg/apis/camel/v1"
"github.com/apache/camel-k/v2/pkg/cmd"
)

func TestKamelCLIConfig(t *testing.T) {
Expand Down
193 changes: 193 additions & 0 deletions pkg/cmd/manager/controller.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,193 @@
/*
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/

package manager

import (
"context"
"strconv"
"time"

"github.com/apache/camel-k/v2/pkg/apis"
"github.com/apache/camel-k/v2/pkg/client"
"github.com/apache/camel-k/v2/pkg/util/kubernetes"
logutil "github.com/apache/camel-k/v2/pkg/util/log"
coordination "k8s.io/api/coordination/v1"
"k8s.io/client-go/rest"
"k8s.io/client-go/tools/leaderelection/resourcelock"
"sigs.k8s.io/controller-runtime/pkg/cache"
"sigs.k8s.io/controller-runtime/pkg/client/config"
"sigs.k8s.io/controller-runtime/pkg/healthz"
"sigs.k8s.io/controller-runtime/pkg/manager"
"sigs.k8s.io/controller-runtime/pkg/manager/signals"
metricsserver "sigs.k8s.io/controller-runtime/pkg/metrics/server"
)

type Manager interface {
PrintVersion()
CreateBootstrapClient(cfg *rest.Config) (client.Client, string, error)
GetControllerNamespaceAndLeaderElection(ctx context.Context, bootstrapClient client.Client, leaderElection bool) (string, bool, string, error)
GetManagerOptions(bootstrapClient client.Client) (cache.Options, string, error)
CreateManager(ctx context.Context, healthPort int32, monitoringPort int32, leaderElection bool, leaderElectionID string, cfg *rest.Config, controllerNamespace string, options cache.Options) (manager.Manager, client.Client, string, error)
ControllerPreStartResourcesInit(ctx context.Context, initCtx context.Context, bootstrapClient client.Client, controllerNamespace string, ctrlClient client.Client, mgr manager.Manager) (string, error)
}

func NewControllerCmd(controllerManager Manager, log logutil.Logger) *ControllerCmd {
return &ControllerCmd{
controllerManager: controllerManager,
log: log,
}
}

type ControllerCmd struct {
controllerManager Manager
log logutil.Logger
}

func (c ControllerCmd) Run(healthPort, monitoringPort int32, leaderElection bool, leaderElectionID string) (string, error) {
errMessage, err := setMaxprocs(c.log)
if err != nil {
return errMessage, err
}

c.controllerManager.PrintVersion()
// Will only appear if DEBUG level has been enabled using the env var LOG_LEVEL
c.log.Debug("*** DEBUG level messages will be logged ***")

cfg, err := config.GetConfig()
if err != nil {
return "cannot get client config", err
}
bootstrapClient, errMessage, err := c.controllerManager.CreateBootstrapClient(cfg)
if err != nil {
return errMessage, err
}

ctx := signals.SetupSignalHandler()

controllerNamespace, leaderElection, errMessage, err := c.controllerManager.GetControllerNamespaceAndLeaderElection(ctx, bootstrapClient, leaderElection)
if err != nil {
return errMessage, err
}
if !leaderElection {
c.log.Info("Leader election is disabled!")
}

errMessage, err = setOperatorImage(ctx, bootstrapClient, controllerNamespace)
if err != nil {
return errMessage, err
}

options, errMessage, err := c.controllerManager.GetManagerOptions(bootstrapClient)
if err != nil {
return errMessage, err
}

mgr, ctrlClient, errMessage, err := c.controllerManager.CreateManager(ctx, healthPort, monitoringPort, leaderElection, leaderElectionID, cfg, controllerNamespace, options)
if err != nil {
return errMessage, err
}

initCtx, initCancel := context.WithTimeout(ctx, 1*time.Minute)
defer initCancel()

errMessage, err = c.controllerManager.ControllerPreStartResourcesInit(ctx, initCtx, bootstrapClient, controllerNamespace, ctrlClient, mgr)
if err != nil {
return errMessage, err
}

c.log.Info("Starting the manager")
return "manager exited non-zero", mgr.Start(ctx)
}

type BaseManager struct {
Log logutil.Logger
WatchNamespace string
ControllerNamespace string
AddToManager func(ctx context.Context, manager manager.Manager, client client.Client) error
}

func (bm BaseManager) CreateBootstrapClient(cfg *rest.Config) (client.Client, string, error) {
// Increase maximum burst that is used by client-side throttling,
// to prevent the requests made to apply the bundled Kamelets
// from being throttled.
cfg.QPS = 20
cfg.Burst = 200
bootstrapClient, err := client.NewClientWithConfig(false, cfg)
if err != nil {
return nil, "cannot initialize client", err
}

return bootstrapClient, "", nil
}

func (bm BaseManager) GetControllerNamespaceAndLeaderElection(ctx context.Context, bootstrapClient client.Client, leaderElection bool) (string, bool, string, error) {
controllerNamespace := bm.ControllerNamespace
if controllerNamespace == "" {
// Fallback to using the watch namespace when the operator is not in-cluster.
// It does not support local (off-cluster) operator watching resources globally,
// in which case it's not possible to determine a namespace.
controllerNamespace = bm.WatchNamespace
if controllerNamespace == "" {
leaderElection = false
bm.Log.Info("unable to determine namespace for leader election")
}
}

if ok, err := kubernetes.CheckPermission(ctx, bootstrapClient, coordination.GroupName, "leases", controllerNamespace, "", "create"); err != nil || !ok {
leaderElection = false
if err != nil {
return controllerNamespace, leaderElection, "cannot check permissions for creating Leases", err
}
bm.Log.Info("The operator is not granted permissions to create Leases")
}

return controllerNamespace, leaderElection, "", nil
}

func (bm BaseManager) CreateManager(ctx context.Context, healthPort int32, monitoringPort int32, leaderElection bool, leaderElectionID string, cfg *rest.Config, controllerNamespace string, options cache.Options) (manager.Manager, client.Client, string, error) {
mgr, err := manager.New(cfg, manager.Options{
LeaderElection: leaderElection,
LeaderElectionNamespace: controllerNamespace,
LeaderElectionID: leaderElectionID,
LeaderElectionResourceLock: resourcelock.LeasesResourceLock,
LeaderElectionReleaseOnCancel: true,
HealthProbeBindAddress: ":" + strconv.Itoa(int(healthPort)),
Metrics: metricsserver.Options{BindAddress: ":" + strconv.Itoa(int(monitoringPort))},
Cache: options,
})
if err != nil {
return nil, nil, "", err
}

bm.Log.Info("Configuring manager")
if err := mgr.AddHealthzCheck("health-probe", healthz.Ping); err != nil {
return nil, nil, "Unable add liveness check", err
}
if err := apis.AddToScheme(mgr.GetScheme()); err != nil {
return nil, nil, "", err
}
ctrlClient, err := client.FromManager(mgr)
if err != nil {
return nil, nil, "", err
}
if err := bm.AddToManager(ctx, mgr, ctrlClient); err != nil {
return nil, nil, "", err
}

return mgr, ctrlClient, "", nil
}
55 changes: 55 additions & 0 deletions pkg/cmd/manager/util.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
package manager

import (
"context"
"fmt"
"os"

"github.com/apache/camel-k/v2/pkg/platform"
logutil "github.com/apache/camel-k/v2/pkg/util/log"
"go.uber.org/automaxprocs/maxprocs"
corev1 "k8s.io/api/core/v1"
k8serrors "k8s.io/apimachinery/pkg/api/errors"
ctrl "sigs.k8s.io/controller-runtime/pkg/client"
)

// setMaxprocs set go maxprocs according to the container environment.
func setMaxprocs(log logutil.Logger) (string, error) {
_, err := maxprocs.Set(maxprocs.Logger(func(f string, a ...interface{}) { log.Info(fmt.Sprintf(f, a)) }))

return "failed to set GOMAXPROCS from cgroups", err
}

// setOperatorImage set the operator container image if it runs in-container.
func setOperatorImage(ctx context.Context, bootstrapClient ctrl.Client, controllerNamespace string) (string, error) {
var err error
platform.OperatorImage, err = getOperatorImage(controllerNamespace, platform.GetOperatorPodName(), ctx, bootstrapClient)
return "cannot get operator container image", err
}

// getOperatorImage returns the image currently used by the running operator if present (when running out of cluster, it may be absent).
func getOperatorImage(namespace string, podName string, ctx context.Context, c ctrl.Reader) (string, error) {
if namespace == "" || podName == "" {
return "", nil
}

pod := corev1.Pod{}
if err := c.Get(ctx, ctrl.ObjectKey{Namespace: namespace, Name: podName}, &pod); err != nil && k8serrors.IsNotFound(err) {
return "", nil
} else if err != nil {
return "", err
}
if len(pod.Spec.Containers) == 0 {
return "", fmt.Errorf("no containers found in operator pod")
}
return pod.Spec.Containers[0].Image, nil
}

// GetWatchNamespace returns the Namespace the operator should be watching for changes.
func GetWatchNamespace(watchNamespaceEnvVar string) (string, error) {
ns, found := os.LookupEnv(watchNamespaceEnvVar)
if !found {
return "", fmt.Errorf("%s must be set", watchNamespaceEnvVar)
}
return ns, nil
}
Loading

0 comments on commit f77f281

Please sign in to comment.