dynamic

Documentation

Overview

Package dynamic provides a client interface to arbitrary Kubernetes APIs that exposes common high level operations and exposes common metadata.

Index

• Variables
• func LegacyAPIPathResolverFunc(groupVersion unversioned.GroupVersion) string
• func NewDiscoveryRESTMapper(resources []*unversioned.APIResourceList, ...) (*meta.DefaultRESTMapper, error)
• func NewObjectTyper(resources []*unversioned.APIResourceList) (runtime.ObjectTyper, error)
• func VersionInterfaces(unversioned.GroupVersion) (*meta.VersionInterfaces, error)
• type APIPathResolverFunc
• type Client
  • func NewClient(conf *restclient.Config) (*Client, error)
  • func (c *Client) ParameterCodec(parameterCodec runtime.ParameterCodec) *ClientWithParameterCodec
  • func (c *Client) Resource(resource *unversioned.APIResource, namespace string) *ResourceClient
• type ClientPool
  • func NewClientPool(config *restclient.Config, apiPathResolverFunc APIPathResolverFunc) ClientPool
• type ClientWithParameterCodec
  • func (c *ClientWithParameterCodec) Resource(resource *unversioned.APIResource, namespace string) *ResourceClient
• type ObjectTyper
  • func (ot *ObjectTyper) ObjectKinds(obj runtime.Object) ([]unversioned.GroupVersionKind, bool, error)
  • func (ot *ObjectTyper) Recognizes(gvk unversioned.GroupVersionKind) bool
• type ResourceClient
  • func (rc *ResourceClient) Create(obj *runtime.Unstructured) (*runtime.Unstructured, error)
  • func (rc *ResourceClient) Delete(name string, opts *v1.DeleteOptions) error
  • func (rc *ResourceClient) DeleteCollection(deleteOptions *v1.DeleteOptions, listOptions runtime.Object) error
  • func (rc *ResourceClient) Get(name string) (*runtime.Unstructured, error)
  • func (rc *ResourceClient) List(opts runtime.Object) (*runtime.UnstructuredList, error)
  • func (rc *ResourceClient) Patch(name string, pt api.PatchType, data []byte) (*runtime.Unstructured, error)
  • func (rc *ResourceClient) Update(obj *runtime.Unstructured) (*runtime.Unstructured, error)
  • func (rc *ResourceClient) Watch(opts runtime.Object) (watch.Interface, error)

Variables

var VersionedParameterEncoderWithV1Fallback runtime.ParameterCodec = versionedParameterEncoderWithV1Fallback{}

VersionedParameterEncoderWithV1Fallback is useful for encoding query parameters for thirdparty resources. It tries to convert object to the specified version before converting it to query parameters, and falls back to converting to v1 if the object is not registered in the specified version. For the record, currently API server always treats query parameters sent to a thirdparty resource endpoint as v1.

Functions

func LegacyAPIPathResolverFunc

func LegacyAPIPathResolverFunc(groupVersion unversioned.GroupVersion) string

LegacyAPIPathResolverFunc can resolve paths properly with the legacy API.

func NewDiscoveryRESTMapper

func NewDiscoveryRESTMapper(resources []*unversioned.APIResourceList, versionFunc meta.VersionInterfacesFunc) (*meta.DefaultRESTMapper, error)

NewDiscoveryRESTMapper returns a RESTMapper based on discovery information.

func NewObjectTyper

func NewObjectTyper(resources []*unversioned.APIResourceList) (runtime.ObjectTyper, error)

NewObjectTyper constructs an ObjectTyper from discovery information.

func VersionInterfaces

func VersionInterfaces(unversioned.GroupVersion) (*meta.VersionInterfaces, error)

VersionInterfaces provides an object converter and metadata accessor appropriate for use with unstructured objects.

Types

type APIPathResolverFunc

type APIPathResolverFunc func(groupVersion unversioned.GroupVersion) string

APIPathResolverFunc knows how to convert a groupVersion to its API path.

type Client

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

Client is a Kubernetes client that allows you to access metadata and manipulate metadata of a Kubernetes API group.

func NewClient

func NewClient(conf *restclient.Config) (*Client, error)

NewClient returns a new client based on the passed in config. The codec is ignored, as the dynamic client uses it's own codec.

func (*Client) ParameterCodec

func (c *Client) ParameterCodec(parameterCodec runtime.ParameterCodec) *ClientWithParameterCodec

ParameterCodec wraps a parameterCodec around the Client.

func (*Client) Resource

func (c *Client) Resource(resource *unversioned.APIResource, namespace string) *ResourceClient

Resource returns an API interface to the specified resource for this client's group and version. If resource is not a namespaced resource, then namespace is ignored.

type ClientPool

type ClientPool interface {
	// ClientForGroupVersion returns a client configured for the specified groupVersion.
	ClientForGroupVersion(groupVersion unversioned.GroupVersion) (*Client, error)
}

ClientPool manages a pool of dynamic clients.

func NewClientPool

func NewClientPool(config *restclient.Config, apiPathResolverFunc APIPathResolverFunc) ClientPool

NewClientPool returns a ClientPool from the specified config

type ClientWithParameterCodec

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

func (*ClientWithParameterCodec) Resource

func (c *ClientWithParameterCodec) Resource(resource *unversioned.APIResource, namespace string) *ResourceClient

Resource returns an API interface to the specified resource for this client's group and version. If resource is not a namespaced resource, then namespace is ignored. The ResourceClient inherits the parameter codec of c.

type ObjectTyper

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

ObjectTyper provides an ObjectTyper implementation for runtime.Unstructured object based on discovery information.

func (*ObjectTyper) ObjectKinds

func (ot *ObjectTyper) ObjectKinds(obj runtime.Object) ([]unversioned.GroupVersionKind, bool, error)

ObjectKinds returns a slice of one element with the group,version,kind of the provided object, or an error if the object is not *runtime.Unstructured or has no group,version,kind information.

func (*ObjectTyper) Recognizes

func (ot *ObjectTyper) Recognizes(gvk unversioned.GroupVersionKind) bool

Recognizes returns true if the provided group,version,kind was in the discovery information.

type ResourceClient

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

ResourceClient is an API interface to a specific resource under a dynamic client.

func (*ResourceClient) Create

func (rc *ResourceClient) Create(obj *runtime.Unstructured) (*runtime.Unstructured, error)

Create creates the provided resource.

func (*ResourceClient) Delete

func (rc *ResourceClient) Delete(name string, opts *v1.DeleteOptions) error

Delete deletes the resource with the specified name.

func (*ResourceClient) DeleteCollection

func (rc *ResourceClient) DeleteCollection(deleteOptions *v1.DeleteOptions, listOptions runtime.Object) error

DeleteCollection deletes a collection of objects.

func (*ResourceClient) Get

func (rc *ResourceClient) Get(name string) (*runtime.Unstructured, error)

Get gets the resource with the specified name.

func (*ResourceClient) List

func (rc *ResourceClient) List(opts runtime.Object) (*runtime.UnstructuredList, error)

List returns a list of objects for this resource.

func (*ResourceClient) Patch

func (rc *ResourceClient) Patch(name string, pt api.PatchType, data []byte) (*runtime.Unstructured, error)

func (*ResourceClient) Update

func (rc *ResourceClient) Update(obj *runtime.Unstructured) (*runtime.Unstructured, error)

Update updates the provided resource.

func (*ResourceClient) Watch

func (rc *ResourceClient) Watch(opts runtime.Object) (watch.Interface, error)

Watch returns a watch.Interface that watches the resource.