resource

package
v0.12.0 Latest Latest
Warning

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

Go to latest
Published: Jul 29, 2022 License: Apache-2.0 Imports: 18 Imported by: 87

Documentation

Overview

Package resource implements representations of k8s API resources.

Index

Constants

This section is empty.

Variables

Functions

This section is empty.

Types

type Factory

type Factory struct {

	// When set to true, IncludeLocalConfigs indicates
	// that Factory should include resources with the
	// annotation 'config.kubernetes.io/local-config'.
	// By default these resources are ignored.
	IncludeLocalConfigs bool
	// contains filtered or unexported fields
}

Factory makes instances of Resource.

func NewFactory

func NewFactory(h ifc.KustHasher) *Factory

NewFactory makes an instance of Factory.

func (*Factory) DropLocalNodes added in v0.10.0

func (rf *Factory) DropLocalNodes(nodes []*yaml.RNode) ([]*Resource, error)

DropLocalNodes removes the local nodes by default. Local nodes are detected via the annotation `config.kubernetes.io/local-config: "true"`

func (*Factory) FromBytes

func (rf *Factory) FromBytes(in []byte) (*Resource, error)

FromBytes unmarshalls bytes into one Resource.

func (*Factory) FromMap

func (rf *Factory) FromMap(m map[string]interface{}) *Resource

FromMap returns a new instance of Resource.

func (*Factory) FromMapAndOption

func (rf *Factory) FromMapAndOption(
	m map[string]interface{}, args *types.GeneratorArgs) *Resource

FromMapAndOption returns a new instance of Resource with given options.

func (*Factory) FromMapWithName

func (rf *Factory) FromMapWithName(n string, m map[string]interface{}) *Resource

FromMapWithName returns a new instance with the given "original" name.

func (*Factory) FromMapWithNamespaceAndName

func (rf *Factory) FromMapWithNamespaceAndName(ns string, n string, m map[string]interface{}) *Resource

FromMapWithNamespaceAndName returns a new instance with the given "original" namespace.

func (*Factory) Hasher

func (rf *Factory) Hasher() ifc.KustHasher

Hasher returns an ifc.KustHasher

func (*Factory) MakeConfigMap

func (rf *Factory) MakeConfigMap(kvLdr ifc.KvLoader, args *types.ConfigMapArgs) (*Resource, error)

MakeConfigMap makes an instance of Resource for ConfigMap

func (*Factory) MakeSecret

func (rf *Factory) MakeSecret(kvLdr ifc.KvLoader, args *types.SecretArgs) (*Resource, error)

MakeSecret makes an instance of Resource for Secret

func (*Factory) RNodesFromBytes added in v0.8.6

func (rf *Factory) RNodesFromBytes(b []byte) ([]*yaml.RNode, error)

func (*Factory) ResourcesFromRNodes added in v0.8.6

func (rf *Factory) ResourcesFromRNodes(
	nodes []*yaml.RNode) (result []*Resource, err error)

ResourcesFromRNodes converts RNodes to Resources.

func (*Factory) SliceFromBytes

func (rf *Factory) SliceFromBytes(in []byte) ([]*Resource, error)

SliceFromBytes unmarshals bytes into a Resource slice.

func (*Factory) SliceFromBytesWithNames added in v0.6.0

func (rf *Factory) SliceFromBytesWithNames(names []string, in []byte) ([]*Resource, error)

SliceFromBytesWithNames unmarshals bytes into a Resource slice with specified original name.

func (*Factory) SliceFromPatches

func (rf *Factory) SliceFromPatches(
	ldr ifc.Loader, paths []types.PatchStrategicMerge) ([]*Resource, error)

SliceFromPatches returns a slice of resources given a patch path slice from a kustomization file.

type IdSet added in v0.6.6

type IdSet struct {
	// contains filtered or unexported fields
}

func MakeIdSet added in v0.6.6

func MakeIdSet(slice []*Resource) *IdSet

func (IdSet) Contains added in v0.6.6

func (s IdSet) Contains(id resid.ResId) bool

func (IdSet) Size added in v0.6.6

func (s IdSet) Size() int

type Origin added in v0.9.0

type Origin struct {
	// Path is the path to the resource. If a local resource, this path is
	// rooted from the directory upon which `kustomize build` was invoked. If a
	// remote resource, this path is rooted from the root of the remote repo.
	Path string `json:"path,omitempty" yaml:"path,omitempty"`

	// Repo is the remote repository that the resource or transformer originated from if it is
	// not from a local file
	Repo string `json:"repo,omitempty" yaml:"repo,omitempty"`

	// Ref is the ref of the remote repository that the resource or transformer originated from
	// if it is not from a local file
	Ref string `json:"ref,omitempty" yaml:"ref,omitempty"`

	// ConfiguredIn is the file path to the generator or transformer config that created the
	// resource
	ConfiguredIn string `json:"configuredIn,omitempty" yaml:"configuredIn,omitempty"`

	// ConfiguredBy is the ObjectReference of the generator or transformer config
	ConfiguredBy kyaml.ResourceIdentifier `json:"configuredBy,omitempty" yaml:"configuredBy,omitempty"`
}

Origin retains information about the origin of resources and transformer configs that contributed to the output of `kustomize build`

func OriginFromCustomPlugin added in v0.11.0

func OriginFromCustomPlugin(res *Resource) (*Origin, error)

OriginFromCustomPlugin takes a custom plugin defined as a resource and returns an origin object to describe it

func (*Origin) Append added in v0.9.0

func (origin *Origin) Append(path string) *Origin

Append returns a copy of origin with a path appended to it

func (*Origin) Copy added in v0.9.0

func (origin *Origin) Copy() Origin

Copy returns a copy of origin

func (*Origin) String added in v0.9.0

func (origin *Origin) String() (string, error)

String returns a string version of origin

type ResCtx

type ResCtx interface {
	AddNamePrefix(p string)
	AddNameSuffix(s string)
	GetNamePrefixes() []string
	GetNameSuffixes() []string
}

ResCtx is an interface describing the contextual added kept kustomize in the context of each Resource object. Currently mainly the name prefix and name suffix are added.

type ResCtxMatcher

type ResCtxMatcher func(ResCtx) bool

ResCtxMatcher returns true if two Resources are being modified in the same kustomize context.

type Resource

type Resource struct {
	kyaml.RNode
	// contains filtered or unexported fields
}

Resource is an RNode, representing a Kubernetes Resource Model object, paired with metadata used by kustomize.

func (*Resource) AddNamePrefix

func (r *Resource) AddNamePrefix(p string)

Implements ResCtx AddNamePrefix

func (*Resource) AddNameSuffix

func (r *Resource) AddNameSuffix(s string)

Implements ResCtx AddNameSuffix

func (*Resource) AddTransformation added in v0.11.0

func (r *Resource) AddTransformation(origin *Origin) error

func (*Resource) AllowKindChange added in v0.8.10

func (r *Resource) AllowKindChange()

AllowKindChange allows kind changes to the resource.

func (*Resource) AllowNameChange added in v0.8.10

func (r *Resource) AllowNameChange()

AllowNameChange allows name changes to the resource.

func (*Resource) AppendRefBy

func (r *Resource) AppendRefBy(id fmt.Stringer)

AppendRefBy appends a ResId into the refBy list Using any type except fmt.Stringer here results in a compilation error

func (*Resource) AppendRefVarName

func (r *Resource) AppendRefVarName(variable types.Var)

AppendRefVarName appends a name of a var into the refVar list

func (*Resource) ApplyFilter added in v0.6.9

func (r *Resource) ApplyFilter(f kio.Filter) error

func (*Resource) ApplySmPatch added in v0.6.6

func (r *Resource) ApplySmPatch(patch *Resource) error

ApplySmPatch applies the provided strategic merge patch.

func (*Resource) AsYAML

func (r *Resource) AsYAML() ([]byte, error)

AsYAML returns the resource in Yaml form. Easier to read than JSON.

func (*Resource) Behavior

func (r *Resource) Behavior() types.GenerationBehavior

Behavior returns the behavior for the resource.

func (*Resource) ClearTransformations added in v0.11.0

func (r *Resource) ClearTransformations() error

func (*Resource) CopyMergeMetaDataFieldsFrom added in v0.6.8

func (r *Resource) CopyMergeMetaDataFieldsFrom(other *Resource) error

CopyMergeMetaDataFieldsFrom copies everything but the non-metadata in the resource. TODO: move to RNode, use GetMeta to improve performance. TODO: make a version of mergeStringMaps that is build-annotation aware

to avoid repeatedly setting refby and genargs annotations

Must remove the kustomize bit at the end.

func (*Resource) CurId

func (r *Resource) CurId() resid.ResId

CurId returns a ResId for the resource using the mutable parts of the resource. This should be unique in any ResMap.

func (*Resource) DeepCopy

func (r *Resource) DeepCopy() *Resource

DeepCopy returns a new copy of resource

func (*Resource) EnableHashSuffix added in v0.9.0

func (r *Resource) EnableHashSuffix()

EnableHashSuffix marks the resource as needing a content hash to be appended to the name of the resource.

func (*Resource) ErrIfNotEquals added in v0.6.6

func (r *Resource) ErrIfNotEquals(o *Resource) error

func (*Resource) GetGvk added in v0.4.2

func (r *Resource) GetGvk() resid.Gvk

func (*Resource) GetNamePrefixes

func (r *Resource) GetNamePrefixes() []string

Implements ResCtx GetNamePrefixes

func (*Resource) GetNameSuffixes

func (r *Resource) GetNameSuffixes() []string

Implements ResCtx GetNameSuffixes

func (*Resource) GetOrigin added in v0.11.0

func (r *Resource) GetOrigin() (*Origin, error)

func (*Resource) GetRefBy

func (r *Resource) GetRefBy() []resid.ResId

GetRefBy returns the ResIds that referred to current resource

func (*Resource) GetRefVarNames

func (r *Resource) GetRefVarNames() []string

GetRefVarNames returns vars that refer to current resource

func (*Resource) GetTransformations added in v0.11.0

func (r *Resource) GetTransformations() (Transformations, error)

func (*Resource) Hash added in v0.8.6

func (r *Resource) Hash(h ifc.KustHasher) (string, error)

func (*Resource) KindChangeAllowed added in v0.8.6

func (r *Resource) KindChangeAllowed() bool

KindChangeAllowed checks if a patch resource is allowed to change another resource's kind.

func (*Resource) MergeBinaryDataMapFrom added in v0.8.1

func (r *Resource) MergeBinaryDataMapFrom(o *Resource)

func (*Resource) MergeDataMapFrom added in v0.6.8

func (r *Resource) MergeDataMapFrom(o *Resource)

func (*Resource) MustYaml added in v0.6.9

func (r *Resource) MustYaml() string

MustYaml returns YAML or panics.

func (*Resource) NameChangeAllowed added in v0.8.6

func (r *Resource) NameChangeAllowed() bool

NameChangeAllowed checks if a patch resource is allowed to change another resource's name.

func (*Resource) NeedHashSuffix

func (r *Resource) NeedHashSuffix() bool

NeedHashSuffix returns true if a resource content hash should be appended to the name of the resource.

func (*Resource) OrgId

func (r *Resource) OrgId() resid.ResId

OrgId returns the original, immutable ResId for the resource. This doesn't have to be unique in a ResMap.

func (*Resource) PrefixesSuffixesEquals

func (r *Resource) PrefixesSuffixesEquals(o ResCtx) bool

PrefixesSuffixesEquals is conceptually doing the same task as OutermostPrefixSuffix but performs a deeper comparison of the suffix and prefix slices.

func (*Resource) PrevIds added in v0.6.9

func (r *Resource) PrevIds() []resid.ResId

PrevIds returns a list of ResIds that includes every previous ResId the resource has had through all of its GVKN transformations, in the order that it had that ID. I.e. the oldest ID is first. The returned array does not include the resource's current ID. If there are no previous IDs, this will return nil.

func (*Resource) ReferencesEqual

func (r *Resource) ReferencesEqual(other *Resource) bool

func (*Resource) RemoveBuildAnnotations added in v0.6.9

func (r *Resource) RemoveBuildAnnotations()

RemoveBuildAnnotations removes annotations created by the build process. These are internal-only to kustomize, added to the data pipeline to track name changes so name references can be fixed.

func (*Resource) ResetRNode added in v0.8.10

func (r *Resource) ResetRNode(incoming *Resource)

func (*Resource) SetBehavior added in v0.9.0

func (r *Resource) SetBehavior(behavior types.GenerationBehavior)

SetBehavior sets the behavior for the resource.

func (*Resource) SetGvk added in v0.4.2

func (r *Resource) SetGvk(gvk resid.Gvk)

func (*Resource) SetOrigin added in v0.11.0

func (r *Resource) SetOrigin(origin *Origin) error

func (*Resource) StorePreviousId added in v0.6.9

func (r *Resource) StorePreviousId()

StorePreviousId stores the resource's current ID via build annotations.

func (*Resource) String

func (r *Resource) String() string

String returns resource as JSON.

type Transformations added in v0.11.0

type Transformations []*Origin

Transformations is a list of Origin

func (*Transformations) String added in v0.11.0

func (transformations *Transformations) String() (string, error)

String returns a string version of Transformations

Jump to

Keyboard shortcuts

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