util

package
v1.9.11 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 22, 2024 License: Apache-2.0 Imports: 32 Imported by: 6

Documentation

Index

Constants

View Source
const (
	// TraitPrefixKey is prefix of trait name
	TraitPrefixKey = "trait"

	// Dummy used for dummy definition
	Dummy = "dummy"

	// DummyTraitMessage is a message for trait which don't have definition found
	DummyTraitMessage = "No TraitDefinition found, all framework capabilities will work as default"
)
View Source
const (
	// ErrReconcileErrInCondition indicates one or more error occurs and are recorded in status conditions
	ErrReconcileErrInCondition = "object level reconcile error, type: %q, msg: %q"
	// ErrUpdateStatus is the error while applying status.
	ErrUpdateStatus = "cannot apply status"

	// ErrStoreCapabilityInConfigMap is the error while storing capability in ConfigMap
	ErrStoreCapabilityInConfigMap = "cannot store capability %s in ConfigMap: %v"
	// ErrGenerateOpenAPIV2JSONSchemaForCapability is the error while generating OpenAPI v3 schema
	ErrGenerateOpenAPIV2JSONSchemaForCapability = "cannot generate OpenAPI v3 JSON schema for capability %s: %v"
	// ErrUpdateCapabilityInConfigMap is the error while creating or updating a capability
	ErrUpdateCapabilityInConfigMap = "cannot create or update capability %s in ConfigMap: %v"

	// ErrUpdateComponentDefinition is the error while update ComponentDefinition
	ErrUpdateComponentDefinition = "cannot update ComponentDefinition %s: %v"
	// ErrUpdateTraitDefinition is the error while update TraitDefinition
	ErrUpdateTraitDefinition = "cannot update TraitDefinition %s: %v"
	// ErrUpdateStepDefinition is the error while update WorkflowStepDefinition
	ErrUpdateStepDefinition = "cannot update WorkflowStepDefinition %s: %v"
	// ErrUpdatePolicyDefinition is the error while update PolicyDefinition
	ErrUpdatePolicyDefinition = "cannot update PolicyDefinition %s: %v"
	// ErrUpdateWorkflowStepDefinition is the error while update WorkflowStepDefinition
	ErrUpdateWorkflowStepDefinition = "cannot update WorkflowStepDefinition %s: %v"

	// ErrCreateConvertedWorklaodDefinition is the error while apply a WorkloadDefinition
	ErrCreateConvertedWorklaodDefinition = "cannot create converted WorkloadDefinition %s: %v"

	// ErrRefreshPackageDiscover is the error while refresh PackageDiscover
	ErrRefreshPackageDiscover = "cannot discover the open api of the CRD : %v"

	// ErrGenerateDefinitionRevision is the error while generate DefinitionRevision
	ErrGenerateDefinitionRevision = "cannot generate DefinitionRevision of %s: %v"
	// ErrCreateDefinitionRevision is the error while create or update DefinitionRevision
	ErrCreateDefinitionRevision = "cannot create DefinitionRevision %s: %v"
)
View Source
const (
	// AppDefinitionNamespace is context key to define app namespace
	AppDefinitionNamespace namespaceContextKey = iota
	// XDefinitionNamespace is context key to define the namespace, which x-definition(Component/Trait) is installed to
	XDefinitionNamespace
)
View Source
const ErrBadRevision = "bad revision name"

ErrBadRevision represents an error when the revision name is not standardized

Variables

This section is empty.

Functions

func Abs added in v1.0.2

func Abs(a int) int

Abs for int

func AddAnnotations

func AddAnnotations(o labelAnnotationObject, annos map[string]string)

AddAnnotations will merge annotations with existing ones. If any conflict keys, use new value to override existing value.

func AddLabels

func AddLabels(o labelAnnotationObject, labels map[string]string)

AddLabels will merge labels with existing labels. If any conflict keys, use new value to override existing value.

func AsController added in v1.1.0

AsController converts the supplied object reference to a controller reference. You may also consider using metav1.NewControllerRef.

func AsOwner added in v1.1.0

AsOwner converts the supplied object reference to an owner reference.

func BeEquivalentToError

func BeEquivalentToError(expected error) types.GomegaMatcher

BeEquivalentToError matches the error to take care of nil.

func CheckAppRevision added in v1.0.3

func CheckAppRevision(revs []v1beta1.ApplicationRevision, collection []int) (bool, error)

CheckAppRevision check if appRevision list is right

func ComputeHash

func ComputeHash(trait *unstructured.Unstructured) string

ComputeHash returns a hash value calculated from pod template and a collisionCount to avoid hash collision. The hash will be safe encoded to avoid bad words.

func ConvertDefinitionRevName added in v1.0.5

func ConvertDefinitionRevName(definitionName string) (string, error)

ConvertDefinitionRevName can help convert definition type defined in Application to DefinitionRevision Name e.g., worker@v1.3.1 will be convert to worker-v1.3.1

func ConvertWorkloadGVK2Definition added in v1.0.0

func ConvertWorkloadGVK2Definition(mapper meta.RESTMapper, def common.WorkloadGVK) (common.DefinitionReference, error)

ConvertWorkloadGVK2Definition help convert a GVK to DefinitionReference

func DeepHashObject

func DeepHashObject(hasher hash.Hash, objectToWrite interface{})

DeepHashObject writes specified object to hash using the spew library which follows pointers and prints actual values of the nested objects ensuring the hash does not change when a pointer changes.

func EndReconcileWithNegativeCondition added in v1.1.0

func EndReconcileWithNegativeCondition(ctx context.Context, r client.StatusClient, workload ConditionedObject,
	condition ...condition.Condition) error

EndReconcileWithNegativeCondition is used to handle reconcile failure for a conditioned resource. It will make ctrl-mgr to requeue the resource through patching changed conditions or returning an error. It should not handle reconcile success with positive conditions, otherwise it will trigger infinite requeue.

func EndReconcileWithPositiveCondition added in v1.1.0

func EndReconcileWithPositiveCondition(ctx context.Context, r client.StatusClient, workload ConditionedObject,
	condition ...condition.Condition) error

EndReconcileWithPositiveCondition is used to handle reconcile success for a conditioned resource. It should only accept positive condition which means no need to requeue the resource.

func ExtractComponentName added in v1.1.0

func ExtractComponentName(revisionName string) string

ExtractComponentName will extract the componentName from a revisionName

func ExtractRevisionNum added in v1.0.3

func ExtractRevisionNum(appRevision string, delimiter string) (int, error)

ExtractRevisionNum extract revision number

func GenTraitName

func GenTraitName(componentName string, ct *unstructured.Unstructured, traitType string) string

GenTraitName generate trait name

func GenerateVersion added in v1.8.0

func GenerateVersion(pre string) string

GenerateVersion Generate version numbers by time

func GetCapabilityDefinition added in v1.0.5

func GetCapabilityDefinition(ctx context.Context, cli client.Reader, definition client.Object,
	definitionName string) error

GetCapabilityDefinition can get different versions of ComponentDefinition/TraitDefinition

func GetDefinition added in v0.3.5

func GetDefinition(ctx context.Context, cli client.Reader, definition client.Object, definitionName string) error

GetDefinition get definition from two level namespace

func GetDefinitionFromNamespace added in v1.9.0

func GetDefinitionFromNamespace(ctx context.Context, cli client.Reader, definition client.Object, definitionName, namespace string) error

GetDefinitionFromNamespace get definition from namespace.

func GetDefinitionName

func GetDefinitionName(mapper meta.RESTMapper, u *unstructured.Unstructured, typeLabel string) (string, error)

GetDefinitionName return the Definition name of any resources the format of the definition of a resource is <kind plurals>.<group> Now the definition name of a resource could also be defined as `definition.oam.dev/name` in `metadata.annotations` typeLabel specified which Definition it is, if specified, will directly get definition from label.

func GetDefinitionNamespaceWithCtx added in v0.3.5

func GetDefinitionNamespaceWithCtx(ctx context.Context) string

GetDefinitionNamespaceWithCtx will get namespace from context, it will try get `AppDefinitionNamespace` key, if not found, will use default system level namespace defined in `systemvar.SystemDefinitionNamespace`

func GetGVKFromDefinition

func GetGVKFromDefinition(mapper meta.RESTMapper, definitionRef common.DefinitionReference) (metav1.GroupVersionKind, error)

GetGVKFromDefinition help get Group Version Kind from DefinitionReference

func GetObjectGivenGVKAndName added in v0.3.1

func GetObjectGivenGVKAndName(ctx context.Context, client client.Reader,
	gvk schema.GroupVersionKind, namespace, name string) (*unstructured.Unstructured, error)

GetObjectGivenGVKAndName fetches the kubernetes object given its gvk and name

func GetObjectsGivenGVKAndLabels added in v0.3.3

func GetObjectsGivenGVKAndLabels(ctx context.Context, cli client.Reader,
	gvk schema.GroupVersionKind, namespace string, labels map[string]string) (*unstructured.UnstructuredList, error)

GetObjectsGivenGVKAndLabels fetches the kubernetes object given its gvk and labels by list API

func GetXDefinitionNamespaceWithCtx added in v1.9.2

func GetXDefinitionNamespaceWithCtx(ctx context.Context) string

GetXDefinitionNamespaceWithCtx will get namespace from context, it will try get `XDefinitionNamespace` key, if not found, will use default system level namespace defined in `vela-system`

func IsConditionChanged added in v1.1.0

func IsConditionChanged(newCondition []condition.Condition, workload ConditionedObject) bool

IsConditionChanged will check if conditions in workload are changed compare to newCondition

func JSONMarshal

func JSONMarshal(o interface{}) []byte

JSONMarshal returns the JSON encoding

func Max added in v1.0.2

func Max(a, b int) int

Max for int

func MergeMapOverrideWithDst

func MergeMapOverrideWithDst(src, dst map[string]string) map[string]string

MergeMapOverrideWithDst merges two could be nil maps. Keep the dst for any conflicts,

func Min added in v1.0.2

func Min(a, b int) int

Min for int

func MustJSONMarshal added in v1.1.0

func MustJSONMarshal(obj interface{}) []byte

MustJSONMarshal json-marshals an object into bytes. It panics on err.

func Object2Map

func Object2Map(obj interface{}) (map[string]interface{}, error)

Object2Map turn the Object to a map

func Object2RawExtension added in v1.0.0

func Object2RawExtension(obj interface{}) *runtime.RawExtension

Object2RawExtension converts an object to a rawExtension

func Object2Unstructured

func Object2Unstructured(obj interface{}) (*unstructured.Unstructured, error)

Object2Unstructured converts an object to an unstructured struct

func PassLabelAndAnnotation

func PassLabelAndAnnotation(parentObj, childObj labelAnnotationObject)

PassLabelAndAnnotation passes through labels and annotation objectMeta from the parent to the child object when annotation or labels has conflicts, the parentObj will override the childObj.

func PatchCondition

func PatchCondition(ctx context.Context, r client.StatusClient, workload ConditionedObject,
	condition ...condition.Condition) error

PatchCondition will patch status with condition and return, it generally used by cases which don't want to reconcile after patch

func RawExtension2Application added in v1.1.0

func RawExtension2Application(raw runtime.RawExtension) (*v1beta1.Application, error)

RawExtension2Application converts runtime.RawExtension to Application

func RawExtension2Map added in v0.3.0

func RawExtension2Map(raw *runtime.RawExtension) (map[string]interface{}, error)

RawExtension2Map will convert rawExtension to map

func RawExtension2Unstructured added in v1.0.0

func RawExtension2Unstructured(raw *runtime.RawExtension) (*unstructured.Unstructured, error)

RawExtension2Unstructured converts a rawExtension to an unstructured struct

func RemoveAnnotations added in v1.0.0

func RemoveAnnotations(o labelAnnotationObject, removeKeys []string)

RemoveAnnotations removes keys that contains in the removekeys slice from the annotation

func RemoveLabels added in v1.0.0

func RemoveLabels(o labelAnnotationObject, removeKeys []string)

RemoveLabels removes keys that contains in the removekeys slice from the label

func SetNamespaceInCtx added in v1.0.0

func SetNamespaceInCtx(ctx context.Context, namespace string) context.Context

SetNamespaceInCtx set app namespace in context, Sometimes webhook handler may receive a request that appNs is empty string, and will cause error when search definition So if namespace is empty, it will use `default` namespace by default.

func SetXDefinitionNamespaceInCtx added in v1.9.2

func SetXDefinitionNamespaceInCtx(ctx context.Context, namespace string) context.Context

SetXDefinitionNamespaceInCtx set x-definition namespace in context, Sometimes x-definition is installed to customized namespace So it is empty, it will use `vela-system` namespace by default.

func UnMarshalStringToComponentDefinition added in v1.0.0

func UnMarshalStringToComponentDefinition(s string) (*v1beta1.ComponentDefinition, error)

UnMarshalStringToComponentDefinition parse a string to a componentDefinition object

func UnMarshalStringToPolicyDefinition added in v1.5.0

func UnMarshalStringToPolicyDefinition(s string) (*v1beta1.PolicyDefinition, error)

UnMarshalStringToPolicyDefinition parse a string to a policyDefinition object

func UnMarshalStringToTraitDefinition added in v0.3.1

func UnMarshalStringToTraitDefinition(s string) (*v1beta1.TraitDefinition, error)

UnMarshalStringToTraitDefinition parse a string to a traitDefinition object

Types

type AlreadyExistMatcher

type AlreadyExistMatcher struct {
}

AlreadyExistMatcher matches the error to be already exist

func (AlreadyExistMatcher) FailureMessage

func (matcher AlreadyExistMatcher) FailureMessage(actual interface{}) (message string)

FailureMessage builds an error message.

func (AlreadyExistMatcher) Match

func (matcher AlreadyExistMatcher) Match(actual interface{}) (success bool, err error)

Match matches error.

func (AlreadyExistMatcher) NegatedFailureMessage

func (matcher AlreadyExistMatcher) NegatedFailureMessage(actual interface{}) (message string)

NegatedFailureMessage builds an error message.

type ConditionedObject

type ConditionedObject interface {
	client.Object

	oam.Conditioned
}

A ConditionedObject is an Object type with condition field

type ErrorMatcher

type ErrorMatcher struct {
	ExpectedError error
}

ErrorMatcher matches errors.

func (ErrorMatcher) FailureMessage

func (matcher ErrorMatcher) FailureMessage(actual interface{}) (message string)

FailureMessage builds an error message.

func (ErrorMatcher) Match

func (matcher ErrorMatcher) Match(actual interface{}) (success bool, err error)

Match matches an error.

func (ErrorMatcher) NegatedFailureMessage

func (matcher ErrorMatcher) NegatedFailureMessage(actual interface{}) (message string)

NegatedFailureMessage builds an error message.

type NamespaceAccessor added in v1.4.6

type NamespaceAccessor interface {
	For(obj client.Object) string
	Namespace() string
}

NamespaceAccessor namespace accessor for resource

func NewApplicationResourceNamespaceAccessor added in v1.4.6

func NewApplicationResourceNamespaceAccessor(appNs, overrideNs string) NamespaceAccessor

NewApplicationResourceNamespaceAccessor create namespace accessor for resource in application

type NotFoundMatcher

type NotFoundMatcher struct {
}

NotFoundMatcher matches the error to be not found.

func (NotFoundMatcher) FailureMessage

func (matcher NotFoundMatcher) FailureMessage(actual interface{}) (message string)

FailureMessage builds an error message.

func (NotFoundMatcher) Match

func (matcher NotFoundMatcher) Match(actual interface{}) (success bool, err error)

Match matches the api error.

func (NotFoundMatcher) NegatedFailureMessage

func (matcher NotFoundMatcher) NegatedFailureMessage(actual interface{}) (message string)

NegatedFailureMessage builds an error message.

type WorkloadType added in v1.0.0

type WorkloadType string

WorkloadType describe the workload type of ComponentDefinition

const (
	// ComponentDef describe a workload of Defined by ComponentDefinition
	ComponentDef WorkloadType = "ComponentDef"

	// KubeDef describe a workload refer to raw K8s resource
	KubeDef WorkloadType = "KubeDef"

	// HELMDef describe a workload refer to HELM
	HELMDef WorkloadType = "HelmDef"

	// TerraformDef describes a workload refer to Terraform
	TerraformDef WorkloadType = "TerraformDef"

	// ReferWorkload describe an existing workload
	ReferWorkload WorkloadType = "ReferWorkload"
)

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL