resource

package
v0.8.12-0...-8b0f5fa Latest Latest
Warning

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

 Go to latest Published: Jul 28, 2021 License: Apache-2.0 Imports: 16 Imported by: 0

Documentation

Overview

Package resource implements representations of k8s API resources.

Index

Constants

This section is empty.

Variables

View Source 
var BuildAnnotations = []string{
	utils.BuildAnnotationPreviousKinds,
	utils.BuildAnnotationPreviousNames,
	utils.BuildAnnotationPrefixes,
	utils.BuildAnnotationSuffixes,
	utils.BuildAnnotationPreviousNamespaces,
	utils.BuildAnnotationAllowNameChange,
	utils.BuildAnnotationAllowKindChange,
	utils.BuildAnnotationsRefBy,
	utils.BuildAnnotationsGenOptions,

	kioutil.PathAnnotation,
	kioutil.IndexAnnotation,
	kioutil.SeqIndentAnnotation,
}

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) 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 

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

func (*Factory) ResourcesFromRNodes 

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 

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 

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

func MakeIdSet 

func MakeIdSet(slice []*Resource) *IdSet

func (IdSet) Contains 

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

func (IdSet) Size 

func (s IdSet) Size() int

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) AllowKindChange 

func (r *Resource) AllowKindChange()

AllowKindChange allows kind changes to the resource.

func (*Resource) AllowNameChange 

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 

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

func (*Resource) ApplySmPatch 

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) CopyMergeMetaDataFieldsFrom 

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) ErrIfNotEquals 

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

func (*Resource) GetGvk 

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) 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) Hash 

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

func (*Resource) KindChangeAllowed 

func (r *Resource) KindChangeAllowed() bool

func (*Resource) MergeBinaryDataMapFrom 

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

func (*Resource) MergeDataMapFrom 

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

func (*Resource) MustYaml 

func (r *Resource) MustYaml() string

MustYaml returns YAML or panics.

func (*Resource) NameChangeAllowed 

func (r *Resource) NameChangeAllowed() bool

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 

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 

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 

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

func (*Resource) SetGvk 

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

func (*Resource) SetOptions 

func (r *Resource) SetOptions(o *types.GenArgs)

SetOptions updates the generator options for the resource.

func (*Resource) StorePreviousId 

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.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.
JackTT - Gopher 🇻🇳