apiregistration

Documentation

Overview

Package api is the internal version of the API. +groupName=apiregistration.k8s.io

Index

• Constants
• Variables
• func APIServiceNameToGroupVersion(apiServiceName string) schema.GroupVersion
• func IsAPIServiceConditionTrue(apiService *APIService, conditionType APIServiceConditionType) bool
• func Kind(kind string) schema.GroupKind
• func RegisterDeepCopies(scheme *runtime.Scheme) error
• func Resource(resource string) schema.GroupResource
• func SetAPIServiceCondition(apiService *APIService, newCondition APIServiceCondition)
• func SortedByGroupAndVersion(servers []*APIService) [][]*APIService
• type APIService
  • func (in *APIService) DeepCopy() *APIService
  • func (in *APIService) DeepCopyInto(out *APIService)
  • func (in *APIService) DeepCopyObject() runtime.Object
• type APIServiceCondition
  • func NewLocalAvailableAPIServiceCondition() APIServiceCondition
  • func (in *APIServiceCondition) DeepCopy() *APIServiceCondition
  • func (in *APIServiceCondition) DeepCopyInto(out *APIServiceCondition)
• type APIServiceConditionType
• type APIServiceList
  • func (in *APIServiceList) DeepCopy() *APIServiceList
  • func (in *APIServiceList) DeepCopyInto(out *APIServiceList)
  • func (in *APIServiceList) DeepCopyObject() runtime.Object
• type APIServiceSpec
  • func (in *APIServiceSpec) DeepCopy() *APIServiceSpec
  • func (in *APIServiceSpec) DeepCopyInto(out *APIServiceSpec)
• type APIServiceStatus
  • func (in *APIServiceStatus) DeepCopy() *APIServiceStatus
  • func (in *APIServiceStatus) DeepCopyInto(out *APIServiceStatus)
• type ByGroupPriorityMinimum
  • func (s ByGroupPriorityMinimum) Len() int
  • func (s ByGroupPriorityMinimum) Less(i, j int) bool
  • func (s ByGroupPriorityMinimum) Swap(i, j int)
• type ByVersionPriority
  • func (s ByVersionPriority) Len() int
  • func (s ByVersionPriority) Less(i, j int) bool
  • func (s ByVersionPriority) Swap(i, j int)
• type ConditionStatus
• type ServiceReference
  • func (in *ServiceReference) DeepCopy() *ServiceReference
  • func (in *ServiceReference) DeepCopyInto(out *ServiceReference)

Constants

const GroupName = "apiregistration.k8s.io"

Variables

var (
	SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes)
	AddToScheme   = SchemeBuilder.AddToScheme
)

var SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: runtime.APIVersionInternal}

SchemeGroupVersion is group version used to register these objects

Functions

func APIServiceNameToGroupVersion

func APIServiceNameToGroupVersion(apiServiceName string) schema.GroupVersion

APIServiceNameToGroupVersion returns the GroupVersion for a given apiServiceName. The name must be valid, but any object you get back from an informer will be valid.

func IsAPIServiceConditionTrue

func IsAPIServiceConditionTrue(apiService *APIService, conditionType APIServiceConditionType) bool

IsAPIServiceConditionTrue indicates if the condition is present and strictly true

func Kind

func Kind(kind string) schema.GroupKind

Kind takes an unqualified kind and returns back a Group qualified GroupKind

func RegisterDeepCopies

func RegisterDeepCopies(scheme *runtime.Scheme) error

RegisterDeepCopies adds deep-copy functions to the given scheme. Public to allow building arbitrary schemes.

Deprecated: deepcopy registration will go away when static deepcopy is fully implemented.

func Resource

func Resource(resource string) schema.GroupResource

Resource takes an unqualified resource and returns back a Group qualified GroupResource

func SetAPIServiceCondition

func SetAPIServiceCondition(apiService *APIService, newCondition APIServiceCondition)

SetAPIServiceCondition sets the status condition. It either overwrites the existing one or creates a new one

func SortedByGroupAndVersion

func SortedByGroupAndVersion(servers []*APIService) [][]*APIService

Types

type APIService

type APIService struct {
	metav1.TypeMeta
	metav1.ObjectMeta

	// Spec contains information for locating and communicating with a server
	Spec APIServiceSpec
	// Status contains derived information about an API server
	Status APIServiceStatus
}

APIService represents a server for a particular GroupVersion. Name must be "version.group".

func (*APIService) DeepCopy

func (in *APIService) DeepCopy() *APIService

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new APIService.

func (*APIService) DeepCopyInto

func (in *APIService) DeepCopyInto(out *APIService)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*APIService) DeepCopyObject

func (in *APIService) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type APIServiceCondition

type APIServiceCondition struct {
	// Type is the type of the condition.
	Type APIServiceConditionType
	// Status is the status of the condition.
	// Can be True, False, Unknown.
	Status ConditionStatus
	// Last time the condition transitioned from one status to another.
	LastTransitionTime metav1.Time
	// Unique, one-word, CamelCase reason for the condition's last transition.
	Reason string
	// Human-readable message indicating details about last transition.
	Message string
}

APIServiceCondition describes conditions for an APIService

func NewLocalAvailableAPIServiceCondition

func NewLocalAvailableAPIServiceCondition() APIServiceCondition

NewLocalAvailableAPIServiceCondition returns a condition for an available local APIService.

func (*APIServiceCondition) DeepCopy

func (in *APIServiceCondition) DeepCopy() *APIServiceCondition

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new APIServiceCondition.

func (*APIServiceCondition) DeepCopyInto

func (in *APIServiceCondition) DeepCopyInto(out *APIServiceCondition)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type APIServiceConditionType

type APIServiceConditionType string

APIConditionConditionType is a valid value for APIServiceCondition.Type

const (
	// Available indicates that the service exists and is reachable
	Available APIServiceConditionType = "Available"
)

type APIServiceList

type APIServiceList struct {
	metav1.TypeMeta
	metav1.ListMeta

	Items []APIService
}

APIServiceList is a list of APIService objects.

func (*APIServiceList) DeepCopy

func (in *APIServiceList) DeepCopy() *APIServiceList

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new APIServiceList.

func (*APIServiceList) DeepCopyInto

func (in *APIServiceList) DeepCopyInto(out *APIServiceList)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

func (*APIServiceList) DeepCopyObject

func (in *APIServiceList) DeepCopyObject() runtime.Object

DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.

type APIServiceSpec

type APIServiceSpec struct {
	// Service is a reference to the service for this API server.  It must communicate
	// on port 443
	// If the Service is nil, that means the handling for the API groupversion is handled locally on this server.
	// The call will simply delegate to the normal handler chain to be fulfilled.
	Service *ServiceReference
	// Group is the API group name this server hosts
	Group string
	// Version is the API version this server hosts.  For example, "v1"
	Version string

	// InsecureSkipTLSVerify disables TLS certificate verification when communicating with this server.
	// This is strongly discouraged.  You should use the CABundle instead.
	InsecureSkipTLSVerify bool
	// CABundle is a PEM encoded CA bundle which will be used to validate an API server's serving certificate.
	CABundle []byte

	// GroupPriorityMininum is the priority this group should have at least. Higher priority means that the group is prefered by clients over lower priority ones.
	// Note that other versions of this group might specify even higher GroupPriorityMininum values such that the whole group gets a higher priority.
	// The primary sort is based on GroupPriorityMinimum, ordered highest number to lowest (20 before 10).
	// The secondary sort is based on the alphabetical comparison of the name of the object.  (v1.bar before v1.foo)
	// We'd recommend something like: *.k8s.io (except extensions) at 18000 and
	// PaaSes (OpenShift, Deis) are recommended to be in the 2000s
	GroupPriorityMinimum int32

	// VersionPriority controls the ordering of this API version inside of its group.  Must be greater than zero.
	// The primary sort is based on VersionPriority, ordered highest to lowest (20 before 10).
	// The secondary sort is based on the alphabetical comparison of the name of the object.  (v1.bar before v1.foo)
	// Since it's inside of a group, the number can be small, probably in the 10s.
	VersionPriority int32
}

APIServiceSpec contains information for locating and communicating with a server. Only https is supported, though you are able to disable certificate verification.

func (*APIServiceSpec) DeepCopy

func (in *APIServiceSpec) DeepCopy() *APIServiceSpec

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new APIServiceSpec.

func (*APIServiceSpec) DeepCopyInto

func (in *APIServiceSpec) DeepCopyInto(out *APIServiceSpec)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type APIServiceStatus

type APIServiceStatus struct {
	// Current service state of apiService.
	Conditions []APIServiceCondition
}

APIServiceStatus contains derived information about an API server

func (*APIServiceStatus) DeepCopy

func (in *APIServiceStatus) DeepCopy() *APIServiceStatus

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new APIServiceStatus.

func (*APIServiceStatus) DeepCopyInto

func (in *APIServiceStatus) DeepCopyInto(out *APIServiceStatus)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.

type ByGroupPriorityMinimum

type ByGroupPriorityMinimum []*APIService

ByGroupPriorityMinimum sorts with the highest group number first, then by name. This is not a simple reverse, because we want the name sorting to be alpha, not reverse alpha.

func (ByGroupPriorityMinimum) Len

func (s ByGroupPriorityMinimum) Len() int

func (ByGroupPriorityMinimum) Less

func (s ByGroupPriorityMinimum) Less(i, j int) bool

func (ByGroupPriorityMinimum) Swap

func (s ByGroupPriorityMinimum) Swap(i, j int)

type ByVersionPriority

type ByVersionPriority []*APIService

ByVersionPriority sorts with the highest version number first, then by name. This is not a simple reverse, because we want the name sorting to be alpha, not reverse alpha.

func (ByVersionPriority) Len

func (s ByVersionPriority) Len() int

func (ByVersionPriority) Less

func (s ByVersionPriority) Less(i, j int) bool

func (ByVersionPriority) Swap

func (s ByVersionPriority) Swap(i, j int)

type ConditionStatus

type ConditionStatus string

const (
	ConditionTrue    ConditionStatus = "True"
	ConditionFalse   ConditionStatus = "False"
	ConditionUnknown ConditionStatus = "Unknown"
)

These are valid condition statuses. "ConditionTrue" means a resource is in the condition; "ConditionFalse" means a resource is not in the condition; "ConditionUnknown" means kubernetes can't decide if a resource is in the condition or not. In the future, we could add other intermediate conditions, e.g. ConditionDegraded.

type ServiceReference

type ServiceReference struct {
	// Namespace is the namespace of the service
	Namespace string
	// Name is the name of the service
	Name string
}

ServiceReference holds a reference to Service.legacy.k8s.io

func (*ServiceReference) DeepCopy

func (in *ServiceReference) DeepCopy() *ServiceReference

DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceReference.

func (*ServiceReference) DeepCopyInto

func (in *ServiceReference) DeepCopyInto(out *ServiceReference)

DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.