meta

Documentation

Overview

Package meta provides functions for retrieving API metadata from objects belonging to the Kubernetes API

TODO: move everything in this file to pkg/api/rest

Index

• Variables
• type DefaultRESTMapper
  • func NewDefaultRESTMapper(group string, versions []string, f VersionInterfacesFunc) *DefaultRESTMapper
  • func (m *DefaultRESTMapper) Add(scope RESTScope, kind string, version string, mixedCase bool)
  • func (m *DefaultRESTMapper) AddResourceAlias(alias string, resources ...string)
  • func (m *DefaultRESTMapper) AliasesForResource(alias string) ([]string, bool)
  • func (m *DefaultRESTMapper) GroupForResource(resource string) (string, error)
  • func (m *DefaultRESTMapper) RESTMapping(kind string, versions ...string) (*RESTMapping, error)
  • func (m *DefaultRESTMapper) ResourceSingularizer(resource string) (singular string, err error)
  • func (m *DefaultRESTMapper) VersionAndKindForResource(resource string) (defaultVersion, kind string, err error)
• type Interface
  • func Accessor(obj interface{}) (Interface, error)
• type MetadataAccessor
  • func NewAccessor() MetadataAccessor
• type MultiRESTMapper
  • func (m MultiRESTMapper) AliasesForResource(alias string) (aliases []string, ok bool)
  • func (m MultiRESTMapper) GroupForResource(resource string) (group string, err error)
  • func (m MultiRESTMapper) RESTMapping(kind string, versions ...string) (mapping *RESTMapping, err error)
  • func (m MultiRESTMapper) ResourceSingularizer(resource string) (singular string, err error)
  • func (m MultiRESTMapper) VersionAndKindForResource(resource string) (defaultVersion, kind string, err error)
• type RESTMapper
• type RESTMapping
• type RESTScope
• type RESTScopeName
• type TypeInterface
  • func TypeAccessor(obj interface{}) (TypeInterface, error)
• type VersionInterfaces
• type VersionInterfacesFunc

Variables

var RESTScopeNamespace = &restScope{
	name:             RESTScopeNameNamespace,
	paramName:        "namespaces",
	argumentName:     "namespace",
	paramDescription: "object name and auth scope, such as for teams and projects",
}

var RESTScopeRoot = &restScope{
	name: RESTScopeNameRoot,
}

Types

type DefaultRESTMapper

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

DefaultRESTMapper exposes mappings between the types defined in a runtime.Scheme. It assumes that all types defined the provided scheme can be mapped with the provided MetadataAccessor and Codec interfaces.

The resource name of a Kind is defined as the lowercase, English-plural version of the Kind string. When converting from resource to Kind, the singular version of the resource name is also accepted for convenience.

TODO: Only accept plural for some operations for increased control? (`get pod bar` vs `get pods bar`)

func NewDefaultRESTMapper

func NewDefaultRESTMapper(group string, versions []string, f VersionInterfacesFunc) *DefaultRESTMapper

NewDefaultRESTMapper initializes a mapping between Kind and APIVersion to a resource name and back based on the objects in a runtime.Scheme and the Kubernetes API conventions. Takes a group name, a priority list of the versions to search when an object has no default version (set empty to return an error), and a function that retrieves the correct codec and metadata for a given version.

func (*DefaultRESTMapper) Add

func (m *DefaultRESTMapper) Add(scope RESTScope, kind string, version string, mixedCase bool)

func (*DefaultRESTMapper) AddResourceAlias

func (m *DefaultRESTMapper) AddResourceAlias(alias string, resources ...string)

AddResourceAlias maps aliases to resources

func (*DefaultRESTMapper) AliasesForResource

func (m *DefaultRESTMapper) AliasesForResource(alias string) ([]string, bool)

AliasesForResource returns whether a resource has an alias or not

func (*DefaultRESTMapper) GroupForResource

func (m *DefaultRESTMapper) GroupForResource(resource string) (string, error)

func (*DefaultRESTMapper) RESTMapping

func (m *DefaultRESTMapper) RESTMapping(kind string, versions ...string) (*RESTMapping, error)

RESTMapping returns a struct representing the resource path and conversion interfaces a RESTClient should use to operate on the provided kind in order of versions. If a version search order is not provided, the search order provided to DefaultRESTMapper will be used to resolve which APIVersion should be used to access the named kind.

func (*DefaultRESTMapper) ResourceSingularizer

func (m *DefaultRESTMapper) ResourceSingularizer(resource string) (singular string, err error)

ResourceSingularizer implements RESTMapper It converts a resource name from plural to singular (e.g., from pods to pod)

func (*DefaultRESTMapper) VersionAndKindForResource

func (m *DefaultRESTMapper) VersionAndKindForResource(resource string) (defaultVersion, kind string, err error)

VersionAndKindForResource implements RESTMapper

type Interface

type Interface interface {
	TypeInterface

	Namespace() string
	SetNamespace(namespace string)
	Name() string
	SetName(name string)
	GenerateName() string
	SetGenerateName(name string)
	UID() types.UID
	SetUID(uid types.UID)
	ResourceVersion() string
	SetResourceVersion(version string)
	SelfLink() string
	SetSelfLink(selfLink string)
	Labels() map[string]string
	SetLabels(labels map[string]string)
	Annotations() map[string]string
	SetAnnotations(annotations map[string]string)
}

Interface lets you work with object and list metadata from any of the versioned or internal API objects. Attempting to set or retrieve a field on an object that does not support that field (Name, UID, Namespace on lists) will be a no-op and return a default value. TODO: rename to ObjectInterface when we clear up these interfaces.

func Accessor

func Accessor(obj interface{}) (Interface, error)

Accessor takes an arbitrary object pointer and returns meta.Interface. obj must be a pointer to an API type. An error is returned if the minimum required fields are missing. Fields that are not required return the default value and are a no-op if set. TODO: add a fast path for *TypeMeta and *ObjectMeta for internal objects

type MetadataAccessor

type MetadataAccessor interface {
	APIVersion(obj runtime.Object) (string, error)
	SetAPIVersion(obj runtime.Object, version string) error

	Kind(obj runtime.Object) (string, error)
	SetKind(obj runtime.Object, kind string) error

	Namespace(obj runtime.Object) (string, error)
	SetNamespace(obj runtime.Object, namespace string) error

	Name(obj runtime.Object) (string, error)
	SetName(obj runtime.Object, name string) error

	GenerateName(obj runtime.Object) (string, error)
	SetGenerateName(obj runtime.Object, name string) error

	UID(obj runtime.Object) (types.UID, error)
	SetUID(obj runtime.Object, uid types.UID) error

	SelfLink(obj runtime.Object) (string, error)
	SetSelfLink(obj runtime.Object, selfLink string) error

	Labels(obj runtime.Object) (map[string]string, error)
	SetLabels(obj runtime.Object, labels map[string]string) error

	Annotations(obj runtime.Object) (map[string]string, error)
	SetAnnotations(obj runtime.Object, annotations map[string]string) error

	runtime.ResourceVersioner
}

MetadataAccessor lets you work with object and list metadata from any of the versioned or internal API objects. Attempting to set or retrieve a field on an object that does not support that field (Name, UID, Namespace on lists) will be a no-op and return a default value.

MetadataAccessor exposes Interface in a way that can be used with multiple objects.

func NewAccessor

func NewAccessor() MetadataAccessor

NewAccessor returns a MetadataAccessor that can retrieve or manipulate resource version on objects derived from core API metadata concepts.

type MultiRESTMapper

type MultiRESTMapper []RESTMapper

MultiRESTMapper is a wrapper for multiple RESTMappers.

func (MultiRESTMapper) AliasesForResource

func (m MultiRESTMapper) AliasesForResource(alias string) (aliases []string, ok bool)

AliasesForResource finds the first alias response for the provided mappers.

func (MultiRESTMapper) GroupForResource

func (m MultiRESTMapper) GroupForResource(resource string) (group string, err error)

GroupForResource provides the Group mappings for the REST resources. This implementation supports multiple REST schemas and returns the first match.

func (MultiRESTMapper) RESTMapping

func (m MultiRESTMapper) RESTMapping(kind string, versions ...string) (mapping *RESTMapping, err error)

RESTMapping provides the REST mapping for the resource based on the resource kind and version. This implementation supports multiple REST schemas and return the first match.

func (MultiRESTMapper) ResourceSingularizer

func (m MultiRESTMapper) ResourceSingularizer(resource string) (singular string, err error)

ResourceSingularizer converts a REST resource name from plural to singular (e.g., from pods to pod) This implementation supports multiple REST schemas and return the first match.

func (MultiRESTMapper) VersionAndKindForResource

func (m MultiRESTMapper) VersionAndKindForResource(resource string) (defaultVersion, kind string, err error)

VersionAndKindForResource provides the Version and Kind mappings for the REST resources. This implementation supports multiple REST schemas and return the first match.

type RESTMapper

type RESTMapper interface {
	VersionAndKindForResource(resource string) (defaultVersion, kind string, err error)
	// TODO(caesarxuchao): Remove GroupForResource when multi-group support is in (since
	// group will be part of the version).
	GroupForResource(resource string) (string, error)
	RESTMapping(kind string, versions ...string) (*RESTMapping, error)
	AliasesForResource(resource string) ([]string, bool)
	ResourceSingularizer(resource string) (singular string, err error)
}

RESTMapper allows clients to map resources to kind, and map kind and version to interfaces for manipulating those objects. It is primarily intended for consumers of Kubernetes compatible REST APIs as defined in docs/api-conventions.md.

The Kubernetes API provides versioned resources and object kinds which are scoped to API groups. In other words, kinds and resources should not be assumed to be unique across groups.

TODO(caesarxuchao): Add proper multi-group support so that kinds & resources are scoped to groups. See http://issues.k8s.io/12413 and http://issues.k8s.io/10009.

type RESTMapping

type RESTMapping struct {
	// Resource is a string representing the name of this resource as a REST client would see it
	Resource string
	// APIVersion represents the APIVersion that represents the resource as presented. It is provided
	// for convenience for passing around a consistent mapping.
	APIVersion string
	Kind       string

	// Scope contains the information needed to deal with REST Resources that are in a resource hierarchy
	Scope RESTScope

	runtime.Codec
	runtime.ObjectConvertor
	MetadataAccessor
}

RESTMapping contains the information needed to deal with objects of a specific resource and kind in a RESTful manner.

type RESTScope

type RESTScope interface {
	// Name of the scope
	Name() RESTScopeName
	// ParamName is the optional name of the parameter that should be inserted in the resource url
	// If empty, no param will be inserted
	ParamName() string
	// ArgumentName is the optional name that should be used for the variable holding the value.
	ArgumentName() string
	// ParamDescription is the optional description to use to document the parameter in api documentation
	ParamDescription() string
}

RESTScope contains the information needed to deal with REST resources that are in a resource hierarchy TODO After we deprecate v1beta1 and v1beta2, we can look a supporting removing the flexibility of supporting either a query or path param, and instead just support path param

type RESTScopeName

type RESTScopeName string

const (
	RESTScopeNameNamespace RESTScopeName = "namespace"
	RESTScopeNameRoot      RESTScopeName = "root"
)

type TypeInterface

type TypeInterface interface {
	APIVersion() string
	SetAPIVersion(version string)
	Kind() string
	SetKind(kind string)
}

TypeInterface exposes the type and APIVersion of versioned or internal API objects.

func TypeAccessor

func TypeAccessor(obj interface{}) (TypeInterface, error)

TypeAccessor returns an interface that allows retrieving and modifying the APIVersion and Kind of an in-memory internal object. TODO: this interface is used to test code that does not have ObjectMeta or ListMeta in round tripping (objects which can use apiVersion/kind, but do not fit the Kube api conventions).

type VersionInterfaces

type VersionInterfaces struct {
	runtime.Codec
	runtime.ObjectConvertor
	MetadataAccessor
}

VersionInterfaces contains the interfaces one should use for dealing with types of a particular version.

type VersionInterfacesFunc

type VersionInterfacesFunc func(apiVersion string) (*VersionInterfaces, error)

VersionInterfacesFunc returns the appropriate codec, typer, and metadata accessor for a given api version, or an error if no such api version exists.