unkin-agent
9da206dc7c
PVCs and CloudNativePG Clusters need S3 buckets and backup schedules
provisioned consistently. This operator watches the
backups.unkin.net/{schedule,destination} annotations on those objects and
provisions everything needed to back them up, with no new CRDs.
- Add a PVC controller that provisions cephrgw ObjectStoreUser/Bucket/BucketAccess,
auto-generates a restic repo-password Secret and creates a k8up Schedule scoped
to the PVC via spec.backup.volumes[].persistentVolumeClaim.claimName.
- Add a CNPG Cluster controller that provisions the same bucket stack, idempotently
patches spec.backup.barmanObjectStore (leaving a user-set destinationPath alone
with a Warning event) and creates a ScheduledBackup.
- Resolve destinations through a ConfigMap lookup table; requeue until the
BucketAccess is Ready before creating schedule resources; own-reference created
resources and retain bucket data by default.
- Add schedule-mapping helpers (k8up 5-field/shortcut pass-through, CNPG 6-field
seconds-first) and deterministic, length-bounded name derivation.
- Add unit tests (schedule mapping, name derivation, destination resolution) and
envtest controller tests for both paths, wiring the external CRDs into envtest.
- Add kubebuilder-generated RBAC, a Dockerfile (distroless/nonroot), Woodpecker
lint/test/build pipelines and a tag-triggered image push to the artifactapi
docker-internal registry, plus a version-bump Makefile and deploy manifests.
106 lines
3.2 KiB
Go
106 lines
3.2 KiB
Go
/*
|
|
Copyright 2018 The Kubernetes Authors.
|
|
|
|
Licensed 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 log contains utilities for fetching a new logger
|
|
// when one is not already available.
|
|
//
|
|
// # The Log Handle
|
|
//
|
|
// This package contains a root logr.Logger Log. It may be used to
|
|
// get a handle to whatever the root logging implementation is. By
|
|
// default, no implementation exists, and the handle returns "promises"
|
|
// to loggers. When the implementation is set using SetLogger, these
|
|
// "promises" will be converted over to real loggers.
|
|
//
|
|
// # Logr
|
|
//
|
|
// All logging in controller-runtime is structured, using a set of interfaces
|
|
// defined by a package called logr
|
|
// (https://pkg.go.dev/github.com/go-logr/logr). The sub-package zap provides
|
|
// helpers for setting up logr backed by Zap (go.uber.org/zap).
|
|
package log
|
|
|
|
import (
|
|
"bytes"
|
|
"context"
|
|
"fmt"
|
|
"os"
|
|
"runtime/debug"
|
|
"sync/atomic"
|
|
"time"
|
|
|
|
"github.com/go-logr/logr"
|
|
)
|
|
|
|
// SetLogger sets a concrete logging implementation for all deferred Loggers.
|
|
func SetLogger(l logr.Logger) {
|
|
logFullfilled.Store(true)
|
|
rootLog.Fulfill(l.GetSink())
|
|
}
|
|
|
|
func eventuallyFulfillRoot() {
|
|
if logFullfilled.Load() {
|
|
return
|
|
}
|
|
if time.Since(rootLogCreated).Seconds() >= 30 {
|
|
if logFullfilled.CompareAndSwap(false, true) {
|
|
stack := debug.Stack()
|
|
stackLines := bytes.Count(stack, []byte{'\n'})
|
|
sep := []byte{'\n', '\t', '>', ' ', ' '}
|
|
|
|
fmt.Fprintf(os.Stderr,
|
|
"[controller-runtime] log.SetLogger(...) was never called; logs will not be displayed.\nDetected at:%s%s", sep,
|
|
// prefix every line, so it's clear this is a stack trace related to the above message
|
|
bytes.Replace(stack, []byte{'\n'}, sep, stackLines-1),
|
|
)
|
|
SetLogger(logr.New(NullLogSink{}))
|
|
}
|
|
}
|
|
}
|
|
|
|
var (
|
|
logFullfilled atomic.Bool
|
|
)
|
|
|
|
// Log is the base logger used by kubebuilder. It delegates
|
|
// to another logr.Logger. You *must* call SetLogger to
|
|
// get any actual logging. If SetLogger is not called within
|
|
// the first 30 seconds of a binaries lifetime, it will get
|
|
// set to a NullLogSink.
|
|
var (
|
|
rootLog, rootLogCreated = func() (*delegatingLogSink, time.Time) {
|
|
return newDelegatingLogSink(NullLogSink{}), time.Now()
|
|
}()
|
|
Log = logr.New(rootLog)
|
|
)
|
|
|
|
// FromContext returns a logger with predefined values from a context.Context.
|
|
func FromContext(ctx context.Context, keysAndValues ...any) logr.Logger {
|
|
log := Log
|
|
if ctx != nil {
|
|
if logger, err := logr.FromContext(ctx); err == nil {
|
|
log = logger
|
|
}
|
|
}
|
|
return log.WithValues(keysAndValues...)
|
|
}
|
|
|
|
// IntoContext takes a context and sets the logger as one of its values.
|
|
// Use FromContext function to retrieve the logger.
|
|
func IntoContext(ctx context.Context, log logr.Logger) context.Context {
|
|
return logr.NewContext(ctx, log)
|
|
}
|