daemonset

package
v0.12.4 Latest Latest
Warning

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

Go to latest
Published: Oct 11, 2022 License: Apache-2.0 Imports: 36 Imported by: 1

Documentation

Index

Constants

This section is empty.

Variables

View Source
var (
	ErrInvalidToolsType  = errors.New("type must be string, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object or runtime.Object")
	ErrInvalidCreateType = errors.New("type must be string, []byte, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object, runtime.Object, *unstructured.Unstructured, unstructured.Unstructured or map[string]interface{}")
	ErrInvalidUpdateType = ErrInvalidCreateType
	ErrInvalidApplyType  = ErrInvalidCreateType
	ErrInvalidDeleteType = ErrInvalidCreateType
	ErrInvalidGetType    = ErrInvalidCreateType
	ErrInvalidPatchType  = errors.New("patch data type must be string, []byte, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object, runtime.Object, *unstructured.Unstructured, unstructured.Unstructured or map[string]interface{}")
)

GVK contains the Group, Version, Kind name of daemonset.

GVR contains the Group, Version and Resource name of daemonset.

View Source
var Group = GVK.Group

Group is the daemonset Group name.

View Source
var Kind = GVK.Kind

Kind is the daemonset Kind name.

View Source
var Resource = GVR.Resource

Resource is the daemonset Resource name.

View Source
var Version = GVK.Version

Version is the daemonset Version name.

Functions

This section is empty.

Types

type Handler

type Handler struct {
	Options *types.HandlerOptions
	// contains filtered or unexported fields
}

func New

func New(ctx context.Context, kubeconfig, namespace string) (*Handler, error)

New returns a handler handler from kubeconfig or in-cluster config. The kubeconfig precedence is: * kubeconfig variable passed. * KUBECONFIG environment variable pointing at a file. * $HOME/.kube/config if exists. * In-cluster config if running in cluster.

func NewOrDie added in v0.3.0

func NewOrDie(ctx context.Context, kubeconfig, namespace string) *Handler

NewOrDie simply call New() to get a daemonset handler. panic if there is any error occurs.

func (*Handler) Apply

func (h *Handler) Apply(obj interface{}) (*appsv1.DaemonSet, error)

Apply applies daemonset from type string, []byte, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object, runtime.Object, *unstructured.Unstructured, unstructured.Unstructured or map[string]interface{}.

func (*Handler) ApplyFromBytes

func (h *Handler) ApplyFromBytes(data []byte) (ds *appsv1.DaemonSet, err error)

ApplyFromBytes pply daemonset from bytes data.

func (*Handler) ApplyFromFile

func (h *Handler) ApplyFromFile(filename string) (ds *appsv1.DaemonSet, err error)

ApplyFromFile applies daemonset from yaml or json file.

func (*Handler) ApplyFromMap added in v0.5.0

func (h *Handler) ApplyFromMap(u map[string]interface{}) (*appsv1.DaemonSet, error)

ApplyFromMap applies daemonset from map[string]interface{}.

func (*Handler) ApplyFromObject added in v0.3.0

func (h *Handler) ApplyFromObject(obj interface{}) (*appsv1.DaemonSet, error)

ApplyFromObject applies daemonset from metav1.Object or runtime.Object.

func (*Handler) ApplyFromUnstructured added in v0.3.0

func (h *Handler) ApplyFromUnstructured(u *unstructured.Unstructured) (*appsv1.DaemonSet, error)

ApplyFromUnstructured applies daemonset from *unstructured.Unstructured.

func (*Handler) Clientset added in v0.2.0

func (h *Handler) Clientset() *kubernetes.Clientset

Clientset returns underlying clientset.

func (*Handler) Create

func (h *Handler) Create(obj interface{}) (*appsv1.DaemonSet, error)

Create creates daemonset from type string, []byte, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object, runtime.Object, *unstructured.Unstructured, unstructured.Unstructured or map[string]interface{}.

func (*Handler) CreateFromBytes

func (h *Handler) CreateFromBytes(data []byte) (*appsv1.DaemonSet, error)

CreateFromBytes creates daemonset from bytes data.

func (*Handler) CreateFromFile

func (h *Handler) CreateFromFile(filename string) (*appsv1.DaemonSet, error)

CreateFromFile creates daemonset from yaml or json file.

func (*Handler) CreateFromMap added in v0.5.0

func (h *Handler) CreateFromMap(u map[string]interface{}) (*appsv1.DaemonSet, error)

CreateFromMap creates daemonset from map[string]interface{}.

func (*Handler) CreateFromObject added in v0.3.0

func (h *Handler) CreateFromObject(obj interface{}) (*appsv1.DaemonSet, error)

CreateFromObject creates daemonset from metav1.Object or runtime.Object.

func (*Handler) CreateFromUnstructured added in v0.3.0

func (h *Handler) CreateFromUnstructured(u *unstructured.Unstructured) (*appsv1.DaemonSet, error)

CreateFromUnstructured creates daemonset from *unstructured.Unstructured.

func (*Handler) DaemonSetInformer added in v0.5.0

func (h *Handler) DaemonSetInformer() informersapps.DaemonSetInformer

DaemonSetInformer returns underlying DaemonSetInformer which provides access to a shared informer and lister for daemonset.

func (*Handler) DeepCopy

func (in *Handler) DeepCopy() *Handler

func (*Handler) Delete

func (h *Handler) Delete(obj interface{}) error

Delete deletes daemonset from type string, []byte, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object, runtime.Object, *unstructured.Unstructured, unstructured.Unstructured or map[string]interface{}.

If passed parameter type is string, it will simply call DeleteByName instead of DeleteFromFile. You should always explicitly call DeleteFromFile to delete a daemonset from file path.

func (*Handler) DeleteByName

func (h *Handler) DeleteByName(name string) error

DeleteByName deletes daemonset by name.

func (*Handler) DeleteFromBytes

func (h *Handler) DeleteFromBytes(data []byte) error

DeleteFromBytes deletes daemonset from bytes data.

func (*Handler) DeleteFromFile

func (h *Handler) DeleteFromFile(filename string) error

DeleteFromFile deletes daemonset from yaml or json file.

func (*Handler) DeleteFromMap added in v0.5.0

func (h *Handler) DeleteFromMap(u map[string]interface{}) error

DeleteFromMap deletes daemonset from map[string]interface{}.

func (*Handler) DeleteFromObject added in v0.3.0

func (h *Handler) DeleteFromObject(obj interface{}) error

DeleteFromObject deletes daemonset from metav1.Object or runtime.Object.

func (*Handler) DeleteFromUnstructured added in v0.3.0

func (h *Handler) DeleteFromUnstructured(u *unstructured.Unstructured) error

DeleteFromUnstructured deletes daemonset from *unstructured.Unstructured.

func (*Handler) DiscoveryClient added in v0.2.0

func (h *Handler) DiscoveryClient() *discovery.DiscoveryClient

DiscoveryClient returns underlying discovery client.

func (*Handler) DynamicClient added in v0.2.0

func (h *Handler) DynamicClient() dynamic.Interface

DynamicClient returns underlying dynamic client.

func (*Handler) Get

func (h *Handler) Get(obj interface{}) (*appsv1.DaemonSet, error)

Get gets daemonset from type string, []byte, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object, runtime.Object, *unstructured.Unstructured, unstructured.Unstructured or map[string]interface{}.

If passed parameter type is string, it will simply call GetByName instead of GetFromFile. You should always explicitly call GetFromFile to get a daemonset from file path.

func (*Handler) GetAge

func (h *Handler) GetAge(object interface{}) (time.Duration, error)

GetAge returns daemonset age.

func (*Handler) GetByName

func (h *Handler) GetByName(name string) (*appsv1.DaemonSet, error)

GetByName gets daemonset by name.

func (*Handler) GetContainers added in v0.2.0

func (h *Handler) GetContainers(object interface{}) ([]string, error)

GetContainers get all container of this daemonset.

func (*Handler) GetFromBytes

func (h *Handler) GetFromBytes(data []byte) (*appsv1.DaemonSet, error)

GetFromBytes gets daemonset from bytes data.

func (*Handler) GetFromFile

func (h *Handler) GetFromFile(filename string) (*appsv1.DaemonSet, error)

GetFromFile gets daemonset from yaml or json file.

func (*Handler) GetFromMap added in v0.5.0

func (h *Handler) GetFromMap(u map[string]interface{}) (*appsv1.DaemonSet, error)

GetFromMap gets daemonset from map[string]interface{}.

func (*Handler) GetFromObject added in v0.3.0

func (h *Handler) GetFromObject(obj interface{}) (*appsv1.DaemonSet, error)

GetFromObject gets daemonset from metav1.Object or runtime.Object.

func (*Handler) GetFromUnstructured added in v0.3.0

func (h *Handler) GetFromUnstructured(u *unstructured.Unstructured) (*appsv1.DaemonSet, error)

GetFromUnstructured gets daemonset from *unstructured.Unstructured.

func (*Handler) GetImages added in v0.2.0

func (h *Handler) GetImages(object interface{}) ([]string, error)

GetImages get all container images of this daemonset.

func (*Handler) GetPV

func (h *Handler) GetPV(object interface{}) ([]string, error)

GetPV get all persistentvolumes mounted by the daemonset.

func (*Handler) GetPVC

func (h *Handler) GetPVC(object interface{}) ([]string, error)

GetPVC get all persistentvolumeclaims mounted by the daemonset.

func (*Handler) GetPods

func (h *Handler) GetPods(object interface{}) ([]*corev1.Pod, error)

GetPods get all pods created by the daemonset.

func (*Handler) Informer added in v0.5.0

func (h *Handler) Informer() cache.SharedIndexInformer

Informer returns underlying SharedIndexInformer which provides add and Indexers ability based on SharedInformer.

func (*Handler) InformerFactory added in v0.5.0

func (h *Handler) InformerFactory() informers.SharedInformerFactory

InformerFactory returns underlying SharedInformerFactory which provides shared informer for resources in all known API group version.

func (*Handler) List

func (h *Handler) List() ([]*appsv1.DaemonSet, error)

List list all daemonsets in the k8s cluster, it simply call `ListAll`.

func (*Handler) ListAll

func (h *Handler) ListAll() ([]*appsv1.DaemonSet, error)

ListAll list all daemonsets in the k8s cluster.

func (*Handler) ListByField added in v0.7.0

func (h *Handler) ListByField(field string) ([]*appsv1.DaemonSet, error)

ListByField list daemonsets by field, work like `kubectl get xxx --field-selector=xxx`.

func (*Handler) ListByLabel

func (h *Handler) ListByLabel(labels string) ([]*appsv1.DaemonSet, error)

ListByLabel list daemonsets by labels. Multiple labels separated by comma(",") eg: "name=myapp,role=devops", and there is an "And" relationship between multiple labels.

func (*Handler) ListByNamespace

func (h *Handler) ListByNamespace(namespace string) ([]*appsv1.DaemonSet, error)

ListByNamespace list all daemonsets in the specified namespace.

func (*Handler) Lister added in v0.5.0

func (h *Handler) Lister() listersapps.DaemonSetLister

Lister returns underlying DaemonSetLister which helps list daemonsets.

func (*Handler) NumAvailable added in v0.2.0

func (h *Handler) NumAvailable(object interface{}) (int32, error)

NumAvailable

func (*Handler) NumCurrent added in v0.2.0

func (h *Handler) NumCurrent(object interface{}) (int32, error)

NumCurrent returns the total number of pods that currently running.

func (*Handler) NumDesired added in v0.2.0

func (h *Handler) NumDesired(object interface{}) (int32, error)

NumDesired returns the total number of pods that should be running.

func (*Handler) NumReady added in v0.2.0

func (h *Handler) NumReady(object interface{}) (int32, error)

NumReady

func (*Handler) Patch added in v0.11.1

func (h *Handler) Patch(original *appsv1.DaemonSet, patch interface{}, patchOptions ...types.PatchType) (*appsv1.DaemonSet, error)

Patch use the default patch type(Strategic Merge Patch) to patch daemonset. Supported patch types are: "StrategicMergePatchType", "MergePatchType", "JSONPatchType".

For further more Strategic Merge patch, see:

https://kubernetes.io/docs/tasks/manage-kubernetes-objects/update-api-object-kubectl-patch/#before-you-begin

For a comparison of JSON patch and JSON merge patch, see:

https://erosb.github.io/post/json-patch-vs-merge-patch/

func (*Handler) RESTClient added in v0.2.0

func (h *Handler) RESTClient() *rest.RESTClient

RESTClient returns underlying rest client.

func (*Handler) RESTConfig added in v0.3.0

func (h *Handler) RESTConfig() *rest.Config

RESTConfig returns underlying rest config.

func (*Handler) ResetNamespace added in v0.11.4

func (h *Handler) ResetNamespace(namespace string)

func (*Handler) RunInformer

func (h *Handler) RunInformer(
	stopCh <-chan struct{},
	addFunc func(obj interface{}),
	updateFunc func(oldObj, newObj interface{}),
	deleteFunc func(obj interface{}))

RunInformer start and run the shared informer, returning after it stops. The informer will be stopped when stopCh is closed.

AddFunc, updateFunc, and deleteFunc are used to handle add, update, and delete event of k8s daemonset resource, respectively.

func (*Handler) SetForceDelete

func (h *Handler) SetForceDelete(force bool)

func (*Handler) SetInformerFactoryNamespace added in v0.10.4

func (h *Handler) SetInformerFactoryNamespace(namespace string)

SetInformerFactoryNamespace limit the scope of informer list-and-watch k8s resource. informer list-and-watch all namespace k8s resource by default.

func (*Handler) SetInformerFactoryResyncPeriod added in v0.10.4

func (h *Handler) SetInformerFactoryResyncPeriod(resyncPeriod time.Duration)

SetInformerFactoryResyncPeriod will set informer resync period.

func (*Handler) SetInformerFactoryTweakListOptions added in v0.10.4

func (h *Handler) SetInformerFactoryTweakListOptions(tweakListOptions internalinterfaces.TweakListOptionsFunc)

SetInformerFactoryTweakListOptions sets a custom filter on all listers of the configured SharedInformerFactory.

func (*Handler) SetLimit

func (h *Handler) SetLimit(limit int64)

func (*Handler) SetTimeout

func (h *Handler) SetTimeout(timeout int64)

func (*Handler) StartInformer added in v0.10.1

func (h *Handler) StartInformer(
	stopCh <-chan struct{},
	addFunc func(obj interface{}),
	updateFunc func(oldObj, newObj interface{}),
	deleteFunc func(obj interface{}))

StartInformer simply call RunInformer.

func (*Handler) Update

func (h *Handler) Update(obj interface{}) (*appsv1.DaemonSet, error)

Update updates daemonset from type string, []byte, *appsv1.DaemonSet, appsv1.DaemonSet, metav1.Object, runtime.Object, *unstructured.Unstructured, unstructured.Unstructured or map[string]interface{}.

func (*Handler) UpdateFromBytes

func (h *Handler) UpdateFromBytes(data []byte) (*appsv1.DaemonSet, error)

UpdateFromBytes updates daemonset from bytes data.

func (*Handler) UpdateFromFile

func (h *Handler) UpdateFromFile(filename string) (*appsv1.DaemonSet, error)

UpdateFromFile updates daemonset from yaml or json file.

func (*Handler) UpdateFromMap added in v0.5.0

func (h *Handler) UpdateFromMap(u map[string]interface{}) (*appsv1.DaemonSet, error)

UpdateFromMap updates daemonset from map[string]interface{}.

func (*Handler) UpdateFromObject added in v0.3.0

func (h *Handler) UpdateFromObject(obj interface{}) (*appsv1.DaemonSet, error)

UpdateFromObject updates daemonset from metav1.Object or runtime.Object.

func (*Handler) UpdateFromUnstructured added in v0.3.0

func (h *Handler) UpdateFromUnstructured(u *unstructured.Unstructured) (*appsv1.DaemonSet, error)

UpdateFromUnstructured updates daemonset from *unstructured.Unstructured.

func (*Handler) WaitReady

func (h *Handler) WaitReady(name string) error

WaitReady waiting for the daemonset to be in the ready status.

func (*Handler) Watch

func (h *Handler) Watch(addFunc, modifyFunc, deleteFunc func(obj interface{})) error

Watch watch all daemonset resources.

Object as the parameter of addFunc, modifyFunc, deleteFunc:

  • If Event.Type is Added or Modified: the new state of the object.
  • If Event.Type is Deleted: the state of the object immediately before deletion.
  • If Event.Type is Bookmark: the object (instance of a type being watched) where only ResourceVersion field is set. On successful restart of watch from a bookmark resourceVersion, client is guaranteed to not get repeat event nor miss any events.
  • If Event.Type is Error: *api.Status is recommended; other types may make sense depending on context.

func (*Handler) WatchByField added in v0.11.1

func (h *Handler) WatchByField(field string, addFunc, modifyFunc, deleteFunc func(obj interface{})) error

WatchByField watch a single or multiple DaemonSet resources selected by the field.

Object as the parameter of addFunc, modifyFunc, deleteFunc:

  • If Event.Type is Added or Modified: the new state of the object.
  • If Event.Type is Deleted: the state of the object immediately before deletion.
  • If Event.Type is Bookmark: the object (instance of a type being watched) where only ResourceVersion field is set. On successful restart of watch from a bookmark resourceVersion, client is guaranteed to not get repeat event nor miss any events.
  • If Event.Type is Error: *api.Status is recommended; other types may make sense depending on context.

func (*Handler) WatchByLabel

func (h *Handler) WatchByLabel(labels string, addFunc, modifyFunc, deleteFunc func(obj interface{})) error

WatchByLabel watch a single or multiple DaemonSet resources selected by the label. Multiple labels are separated by ",", label key and value conjunctaed by "=".

Object as the parameter of addFunc, modifyFunc, deleteFunc:

  • If Event.Type is Added or Modified: the new state of the object.
  • If Event.Type is Deleted: the state of the object immediately before deletion.
  • If Event.Type is Bookmark: the object (instance of a type being watched) where only ResourceVersion field is set. On successful restart of watch from a bookmark resourceVersion, client is guaranteed to not get repeat event nor miss any events.
  • If Event.Type is Error: *api.Status is recommended; other types may make sense depending on context.

func (*Handler) WatchByName

func (h *Handler) WatchByName(name string, addFunc, modifyFunc, deleteFunc func(obj interface{})) error

WatchByName watch a single daemonset reseource.

Object as the parameter of addFunc, modifyFunc, deleteFunc:

  • If Event.Type is Added or Modified: the new state of the object.
  • If Event.Type is Deleted: the state of the object immediately before deletion.
  • If Event.Type is Bookmark: the object (instance of a type being watched) where only ResourceVersion field is set. On successful restart of watch from a bookmark resourceVersion, client is guaranteed to not get repeat event nor miss any events.
  • If Event.Type is Error: *api.Status is recommended; other types may make sense depending on context.

func (*Handler) WatchByNamespace added in v0.11.1

func (h *Handler) WatchByNamespace(namespace string, addFunc, modifyFunc, deleteFunc func(obj interface{})) error

WatchByNamespace watch all daemonset resources in the specified namespace.

Object as the parameter of addFunc, modifyFunc, deleteFunc:

  • If Event.Type is Added or Modified: the new state of the object.
  • If Event.Type is Deleted: the state of the object immediately before deletion.
  • If Event.Type is Bookmark: the object (instance of a type being watched) where only ResourceVersion field is set. On successful restart of watch from a bookmark resourceVersion, client is guaranteed to not get repeat event nor miss any events.
  • If Event.Type is Error: *api.Status is recommended; other types may make sense depending on context.

func (*Handler) WithDryRun

func (h *Handler) WithDryRun() *Handler

WithDryRun deep copies a new handler and prints the create/update/apply/delete operations, without sending it to apiserver.

func (*Handler) WithNamespace

func (h *Handler) WithNamespace(namespace string) *Handler

WithNamespace deep copies a new handler, but set the handler.namespace to the provided namespace.

Jump to

Keyboard shortcuts

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