Skip to content

Commit

Permalink
Move the autoclean tasks to their own module (jaegertracing#2276)
Browse files Browse the repository at this point in the history
* Refactor the autodetect module to reduce the number of writes/reads in viper

Signed-off-by: Israel Blancas <[email protected]>

* Fix linting

Signed-off-by: Israel Blancas <[email protected]>

* Move the cleaning tasks outside the autodetection

Signed-off-by: Israel Blancas <[email protected]>

---------

Signed-off-by: Israel Blancas <[email protected]>
  • Loading branch information
iblancasa authored Aug 4, 2023
1 parent da5cc99 commit fb1078c
Show file tree
Hide file tree
Showing 5 changed files with 337 additions and 211 deletions.
158 changes: 158 additions & 0 deletions pkg/autoclean/main.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
package autoclean

import (
"context"
"strings"
"time"

"github.com/spf13/viper"

appsv1 "k8s.io/api/apps/v1"
"k8s.io/apimachinery/pkg/labels"
"k8s.io/apimachinery/pkg/selection"
"k8s.io/client-go/discovery"
"sigs.k8s.io/controller-runtime/pkg/client"
"sigs.k8s.io/controller-runtime/pkg/log"
"sigs.k8s.io/controller-runtime/pkg/manager"

v1 "github.com/jaegertracing/jaeger-operator/apis/v1"
"github.com/jaegertracing/jaeger-operator/pkg/inject"
)

type Background struct {
cl client.Client
clReader client.Reader
dcl discovery.DiscoveryInterface
ticker *time.Ticker
}

// New creates a new auto-clean runner
func New(mgr manager.Manager) (*Background, error) {
dcl, err := discovery.NewDiscoveryClientForConfig(mgr.GetConfig())
if err != nil {
return nil, err
}

return WithClients(mgr.GetClient(), dcl, mgr.GetAPIReader()), nil
}

// WithClients builds a new Background with the provided clients
func WithClients(cl client.Client, dcl discovery.DiscoveryInterface, clr client.Reader) *Background {
return &Background{
cl: cl,
dcl: dcl,
clReader: clr,
}
}

// Start initializes the auto-clean process that runs in the background
func (b *Background) Start() {
b.ticker = time.NewTicker(5 * time.Second)
b.autoClean()

go func() {
for {
<-b.ticker.C
b.autoClean()
}
}()
}

// Stop causes the background process to stop auto clean capabilities
func (b *Background) Stop() {
b.ticker.Stop()
}

func (b *Background) autoClean() {
ctx := context.Background()
b.cleanDeployments(ctx)
}

func (b *Background) cleanDeployments(ctx context.Context) {
log.Log.V(-1).Info("cleaning orphaned deployments.")

instancesMap := make(map[string]*v1.Jaeger)
deployments := &appsv1.DeploymentList{}
deployOpts := []client.ListOption{
matchingLabelKeys(map[string]string{inject.Label: ""}),
}

// if we are not watching all namespaces, we have to get items from each namespace being watched
if namespaces := viper.GetString(v1.ConfigWatchNamespace); namespaces != v1.WatchAllNamespaces {
for _, ns := range strings.Split(namespaces, ",") {
nsDeps := &appsv1.DeploymentList{}
if err := b.clReader.List(ctx, nsDeps, append(deployOpts, client.InNamespace(ns))...); err != nil {
log.Log.Error(
err,
"error getting a list of deployments to analyze in namespace",
"namespace", ns,
)
}
deployments.Items = append(deployments.Items, nsDeps.Items...)

instances := &v1.JaegerList{}
if err := b.clReader.List(ctx, instances, client.InNamespace(ns)); err != nil {
log.Log.Error(
err,
"error getting a list of existing jaeger instances in namespace",
"namespace", ns,
)
}
for i := range instances.Items {
instancesMap[instances.Items[i].Name] = &instances.Items[i]
}
}
} else {
if err := b.clReader.List(ctx, deployments, deployOpts...); err != nil {
log.Log.Error(
err,
"error getting a list of deployments to analyze",
)
}

instances := &v1.JaegerList{}
if err := b.clReader.List(ctx, instances); err != nil {
log.Log.Error(
err,
"error getting a list of existing jaeger instances",
)
}
for i := range instances.Items {
instancesMap[instances.Items[i].Name] = &instances.Items[i]
}
}

// check deployments to see which one needs to be cleaned.
for i := range deployments.Items {
dep := deployments.Items[i]
if instanceName, ok := dep.Labels[inject.Label]; ok {
_, instanceExists := instancesMap[instanceName]
if !instanceExists { // Jaeger instance not exist anymore, we need to clean this up.
inject.CleanSidecar(instanceName, &dep)
if err := b.cl.Update(ctx, &dep); err != nil {
log.Log.Error(
err,
"error cleaning orphaned deployment",
"deploymentName", dep.Name,
"deploymentNamespace", dep.Namespace,
)
}
}
}
}
}

type matchingLabelKeys map[string]string

func (m matchingLabelKeys) ApplyToList(opts *client.ListOptions) {
sel := labels.NewSelector()
for k := range map[string]string(m) {
req, err := labels.NewRequirement(k, selection.Exists, []string{})
if err != nil {
log.Log.Error(err, "failed to build label selector")
return
}
sel.Add(*req)
}
opts.LabelSelector = sel
}
168 changes: 168 additions & 0 deletions pkg/autoclean/main_test.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
package autoclean

import (
"context"
"testing"

"github.com/spf13/viper"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
appsv1 "k8s.io/api/apps/v1"
corev1 "k8s.io/api/core/v1"
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
"k8s.io/apimachinery/pkg/runtime"
"k8s.io/apimachinery/pkg/types"
"k8s.io/apimachinery/pkg/version"
"k8s.io/client-go/discovery"
"k8s.io/client-go/kubernetes/scheme"
"sigs.k8s.io/controller-runtime/pkg/client/fake"

v1 "github.com/jaegertracing/jaeger-operator/apis/v1"
"github.com/jaegertracing/jaeger-operator/pkg/inject"
)

func TestCleanDeployments(t *testing.T) {
for _, tt := range []struct {
cap string // caption for the test
watchNamespace string // the value for WATCH_NAMESPACE
jaegerNamespace string // in which namespace the jaeger exists, empty for non existing
deleted bool // whether the sidecar should have been deleted
}{
{
cap: "existing-same-namespace",
watchNamespace: "observability",
jaegerNamespace: "observability",
deleted: false,
},
{
cap: "not-existing-same-namespace",
watchNamespace: "observability",
jaegerNamespace: "",
deleted: true,
},
{
cap: "existing-watched-namespace",
watchNamespace: "observability,other-observability",
jaegerNamespace: "other-observability",
deleted: false,
},
{
cap: "existing-non-watched-namespace",
watchNamespace: "observability",
jaegerNamespace: "other-observability",
deleted: true,
},
{
cap: "existing-watching-all-namespaces",
watchNamespace: v1.WatchAllNamespaces,
jaegerNamespace: "other-observability",
deleted: false,
},
} {
t.Run(tt.cap, func(t *testing.T) {
// prepare the test data
viper.Set(v1.ConfigWatchNamespace, tt.watchNamespace)
defer viper.Reset()

jaeger := v1.NewJaeger(types.NamespacedName{
Name: "my-instance",
Namespace: "observability", // at first, it exists in the same namespace as the deployment
})

dep := &appsv1.Deployment{
ObjectMeta: metav1.ObjectMeta{
Name: "mydep",
Namespace: "observability",
Annotations: map[string]string{inject.Annotation: jaeger.Name},
},
Spec: appsv1.DeploymentSpec{
Template: corev1.PodTemplateSpec{
ObjectMeta: metav1.ObjectMeta{},
Spec: corev1.PodSpec{
Containers: []corev1.Container{
{
Name: "C1",
Image: "image1",
},
},
},
},
},
}
dep = inject.Sidecar(jaeger, dep)

// sanity check
require.Equal(t, 2, len(dep.Spec.Template.Spec.Containers))

// prepare the list of existing objects
objs := []runtime.Object{dep}
if len(tt.jaegerNamespace) > 0 {
jaeger.Namespace = tt.jaegerNamespace // now, it exists only in this namespace
objs = append(objs, jaeger)
}

// prepare the client
s := scheme.Scheme
s.AddKnownTypes(v1.GroupVersion, &v1.Jaeger{})
s.AddKnownTypes(v1.GroupVersion, &v1.JaegerList{})
cl := fake.NewClientBuilder().WithRuntimeObjects(objs...).Build()
b := WithClients(cl, &fakeDiscoveryClient{}, cl)

// test
b.cleanDeployments(context.Background())

// verify
persisted := &appsv1.Deployment{}
err := cl.Get(context.Background(), types.NamespacedName{
Namespace: dep.Namespace,
Name: dep.Name,
}, persisted)
require.NoError(t, err)

// should the sidecar have been deleted?
if tt.deleted {
assert.Equal(t, 1, len(persisted.Spec.Template.Spec.Containers))
assert.NotContains(t, persisted.Labels, inject.Label)
} else {
assert.Equal(t, 2, len(persisted.Spec.Template.Spec.Containers))
assert.Contains(t, persisted.Labels, inject.Label)
}
})
}
}

type fakeDiscoveryClient struct {
discovery.DiscoveryInterface
ServerGroupsFunc func() (apiGroupList *metav1.APIGroupList, err error)
ServerResourcesForGroupVersionFunc func(groupVersion string) (resources *metav1.APIResourceList, err error)
}

func (d *fakeDiscoveryClient) ServerGroups() (apiGroupList *metav1.APIGroupList, err error) {
if d.ServerGroupsFunc == nil {
return &metav1.APIGroupList{}, nil
}
return d.ServerGroupsFunc()
}

func (d *fakeDiscoveryClient) ServerResourcesForGroupVersion(groupVersion string) (resources *metav1.APIResourceList, err error) {
if d.ServerGroupsFunc == nil {
return &metav1.APIResourceList{}, nil
}
return d.ServerResourcesForGroupVersionFunc(groupVersion)
}

func (d *fakeDiscoveryClient) ServerResources() ([]*metav1.APIResourceList, error) {
return []*metav1.APIResourceList{}, nil
}

func (d *fakeDiscoveryClient) ServerPreferredResources() ([]*metav1.APIResourceList, error) {
return []*metav1.APIResourceList{}, nil
}

func (d *fakeDiscoveryClient) ServerPreferredNamespacedResources() ([]*metav1.APIResourceList, error) {
return []*metav1.APIResourceList{}, nil
}

func (d *fakeDiscoveryClient) ServerVersion() (*version.Info, error) {
return &version.Info{}, nil
}
Loading

0 comments on commit fb1078c

Please sign in to comment.