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.
127 lines
4.2 KiB
Go
127 lines
4.2 KiB
Go
/*
|
|
Copyright 2017 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 util
|
|
|
|
import (
|
|
"reflect"
|
|
"strings"
|
|
)
|
|
|
|
// [DEPRECATED] ToCanonicalName converts Golang package/type canonical name into REST friendly OpenAPI name.
|
|
// This method is deprecated because it has a misleading name. Please use ToRESTFriendlyName
|
|
// instead
|
|
//
|
|
// NOTE: actually the "canonical name" in this method should be named "REST friendly OpenAPI name",
|
|
// which is different from "canonical name" defined in GetCanonicalTypeName. The "canonical name" defined
|
|
// in GetCanonicalTypeName means Go type names with full package path.
|
|
//
|
|
// Examples of REST friendly OpenAPI name:
|
|
//
|
|
// Input: k8s.io/api/core/v1.Pod
|
|
// Output: io.k8s.api.core.v1.Pod
|
|
//
|
|
// Input: k8s.io/api/core/v1
|
|
// Output: io.k8s.api.core.v1
|
|
//
|
|
// Input: csi.storage.k8s.io/v1alpha1.CSINodeInfo
|
|
// Output: io.k8s.storage.csi.v1alpha1.CSINodeInfo
|
|
func ToCanonicalName(name string) string {
|
|
return ToRESTFriendlyName(name)
|
|
}
|
|
|
|
// ToRESTFriendlyName converts Golang package/type canonical name into REST friendly OpenAPI name.
|
|
//
|
|
// Examples of REST friendly OpenAPI name:
|
|
//
|
|
// Input: k8s.io/api/core/v1.Pod
|
|
// Output: io.k8s.api.core.v1.Pod
|
|
//
|
|
// Input: k8s.io/api/core/v1
|
|
// Output: io.k8s.api.core.v1
|
|
//
|
|
// Input: csi.storage.k8s.io/v1alpha1.CSINodeInfo
|
|
// Output: io.k8s.storage.csi.v1alpha1.CSINodeInfo
|
|
func ToRESTFriendlyName(name string) string {
|
|
nameParts := strings.Split(name, "/")
|
|
// Reverse first part. e.g., io.k8s... instead of k8s.io...
|
|
if len(nameParts) > 0 && strings.Contains(nameParts[0], ".") {
|
|
parts := strings.Split(nameParts[0], ".")
|
|
for i, j := 0, len(parts)-1; i < j; i, j = i+1, j-1 {
|
|
parts[i], parts[j] = parts[j], parts[i]
|
|
}
|
|
nameParts[0] = strings.Join(parts, ".")
|
|
}
|
|
return strings.Join(nameParts, ".")
|
|
}
|
|
|
|
// OpenAPICanonicalTypeNamer is an interface for models without Go type to seed model name.
|
|
//
|
|
// OpenAPI canonical names are Go type names with full package path, for uniquely indentifying
|
|
// a model / Go type. If a Go type is vendored from another package, only the path after "/vendor/"
|
|
// should be used. For custom resource definition (CRD), the canonical name is expected to be
|
|
//
|
|
// group/version.kind
|
|
//
|
|
// Examples of canonical name:
|
|
//
|
|
// Go type: k8s.io/kubernetes/pkg/apis/core.Pod
|
|
// CRD: csi.storage.k8s.io/v1alpha1.CSINodeInfo
|
|
//
|
|
// Example for vendored Go type:
|
|
//
|
|
// Original full path: k8s.io/kubernetes/vendor/k8s.io/api/core/v1.Pod
|
|
// Canonical name: k8s.io/api/core/v1.Pod
|
|
//
|
|
// Original full path: vendor/k8s.io/api/core/v1.Pod
|
|
// Canonical name: k8s.io/api/core/v1.Pod
|
|
type OpenAPICanonicalTypeNamer interface {
|
|
OpenAPICanonicalTypeName() string
|
|
}
|
|
|
|
// OpenAPIModelNamer is an interface Go types may implement to provide an OpenAPI model name.
|
|
//
|
|
// This takes precedence over OpenAPICanonicalTypeNamer, and should be used when a Go type has a model
|
|
// name that differs from its canonical type name as determined by Go package name reflection.
|
|
type OpenAPIModelNamer interface {
|
|
OpenAPIModelName() string
|
|
}
|
|
|
|
// GetCanonicalTypeName will find the canonical type name of a sample object, removing
|
|
// the "vendor" part of the path
|
|
func GetCanonicalTypeName(model interface{}) string {
|
|
switch namer := model.(type) {
|
|
case OpenAPIModelNamer:
|
|
return namer.OpenAPIModelName()
|
|
case OpenAPICanonicalTypeNamer:
|
|
return namer.OpenAPICanonicalTypeName()
|
|
}
|
|
t := reflect.TypeOf(model)
|
|
if t.Kind() == reflect.Ptr {
|
|
t = t.Elem()
|
|
}
|
|
if t.PkgPath() == "" {
|
|
return t.Name()
|
|
}
|
|
path := t.PkgPath()
|
|
if strings.Contains(path, "/vendor/") {
|
|
path = path[strings.Index(path, "/vendor/")+len("/vendor/"):]
|
|
} else if strings.HasPrefix(path, "vendor/") {
|
|
path = strings.TrimPrefix(path, "vendor/")
|
|
}
|
|
return path + "." + t.Name()
|
|
}
|