Documentation
¶
Overview ¶
+groupName=template.openshift.io Package api is the internal version of the API.
Index ¶
- Constants
- Variables
- func AddObjectsToTemplate(template *Template, objects []runtime.Object, ...) error
- func DeepCopy_template_BrokerTemplateInstance(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_BrokerTemplateInstanceList(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_BrokerTemplateInstanceSpec(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_Parameter(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_Template(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateInstance(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateInstanceCondition(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateInstanceList(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateInstanceObject(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateInstanceRequester(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateInstanceSpec(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateInstanceStatus(in interface{}, out interface{}, c *conversion.Cloner) error
- func DeepCopy_template_TemplateList(in interface{}, out interface{}, c *conversion.Cloner) error
- func IsKindOrLegacy(kind string, gk schema.GroupKind) bool
- func IsResourceOrLegacy(resource string, gr schema.GroupResource) bool
- func Kind(kind string) schema.GroupKind
- func LegacyKind(kind string) schema.GroupKind
- func LegacyResource(resource string) schema.GroupResource
- func RegisterDeepCopies(scheme *runtime.Scheme) error
- func Resource(resource string) schema.GroupResource
- type BrokerTemplateInstance
- type BrokerTemplateInstanceList
- type BrokerTemplateInstanceSpec
- type ExtraValue
- type Parameter
- type Template
- type TemplateInstance
- type TemplateInstanceCondition
- type TemplateInstanceConditionType
- type TemplateInstanceList
- type TemplateInstanceObject
- type TemplateInstanceRequester
- type TemplateInstanceSpec
- type TemplateInstanceStatus
- type TemplateList
Constants ¶
const ( // IconClassAnnotation is the rss class of an icon representing a template IconClassAnnotation = "iconClass" // ServiceBrokerRoot is the API root of the template service broker. ServiceBrokerRoot = "/brokers/template.openshift.io" // ServiceMetadataIconClass is the key for the template iconClass as returned // in the services.metadata map from a service broker catalog response ServiceMetadataIconClass = "console.openshift.io/iconClass" // TemplateUIDIndex is the name of an index on the generated template lister, // initialised and used by the template service broker. TemplateUIDIndex = "templateuid" // ExposeAnnotationPrefix indicates that part of an object in a template // should be exposed in some way, for example implying that it should be // returned by the template service broker in the results of a bind call. // The rest of the annotation name following the prefix may be used by the // exposer as a key name. The annotation value is a Kubernetes JSONPath // template expression which the exposer uses to calculate the exposed // value. JSONPath expressions which return multiple and/or complex objects // are not permitted (with the exception of []byte, which is permitted). // Any []byte values returned are converted to strings. ExposeAnnotationPrefix = "template.openshift.io/expose-" // Base64ExposeAnnotationPrefix is as ExposeAnnotationPrefix, except that // any []byte values returned are base64 encoded. Base64ExposeAnnotationPrefix = "template.openshift.io/base64-expose-" // WaitForReadyAnnotation indicates that the TemplateInstance controller // should wait for the object to be ready before reporting the template // instantiation complete. WaitForReadyAnnotation = "template.alpha.openshift.io/wait-for-ready" // BindableAnnotation indicates whether the template service broker should // advertise the template as being bindable (default is true) BindableAnnotation = "template.openshift.io/bindable" )
annotation keys
const ( GroupName = "template.openshift.io" LegacyGroupName = "" )
Variables ¶
var ( SchemeGroupVersion = schema.GroupVersion{Group: GroupName, Version: runtime.APIVersionInternal} LegacySchemeGroupVersion = schema.GroupVersion{Group: LegacyGroupName, Version: runtime.APIVersionInternal} LegacySchemeBuilder = runtime.NewSchemeBuilder(addLegacyKnownTypes) AddToSchemeInCoreGroup = LegacySchemeBuilder.AddToScheme SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes) AddToScheme = SchemeBuilder.AddToScheme )
SchemeGroupVersion is group version used to register these objects
Functions ¶
func AddObjectsToTemplate ¶
func AddObjectsToTemplate(template *Template, objects []runtime.Object, targetVersions ...schema.GroupVersion) error
AddObjectsToTemplate adds the objects to the template using the target versions to choose the conversion destination
func DeepCopy_template_BrokerTemplateInstance ¶
func DeepCopy_template_BrokerTemplateInstance(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_BrokerTemplateInstance is an autogenerated deepcopy function.
func DeepCopy_template_BrokerTemplateInstanceList ¶
func DeepCopy_template_BrokerTemplateInstanceList(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_BrokerTemplateInstanceList is an autogenerated deepcopy function.
func DeepCopy_template_BrokerTemplateInstanceSpec ¶
func DeepCopy_template_BrokerTemplateInstanceSpec(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_BrokerTemplateInstanceSpec is an autogenerated deepcopy function.
func DeepCopy_template_Parameter ¶
func DeepCopy_template_Parameter(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_Parameter is an autogenerated deepcopy function.
func DeepCopy_template_Template ¶
func DeepCopy_template_Template(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_Template is an autogenerated deepcopy function.
func DeepCopy_template_TemplateInstance ¶
func DeepCopy_template_TemplateInstance(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateInstance is an autogenerated deepcopy function.
func DeepCopy_template_TemplateInstanceCondition ¶
func DeepCopy_template_TemplateInstanceCondition(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateInstanceCondition is an autogenerated deepcopy function.
func DeepCopy_template_TemplateInstanceList ¶
func DeepCopy_template_TemplateInstanceList(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateInstanceList is an autogenerated deepcopy function.
func DeepCopy_template_TemplateInstanceObject ¶
func DeepCopy_template_TemplateInstanceObject(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateInstanceObject is an autogenerated deepcopy function.
func DeepCopy_template_TemplateInstanceRequester ¶
func DeepCopy_template_TemplateInstanceRequester(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateInstanceRequester is an autogenerated deepcopy function.
func DeepCopy_template_TemplateInstanceSpec ¶
func DeepCopy_template_TemplateInstanceSpec(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateInstanceSpec is an autogenerated deepcopy function.
func DeepCopy_template_TemplateInstanceStatus ¶
func DeepCopy_template_TemplateInstanceStatus(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateInstanceStatus is an autogenerated deepcopy function.
func DeepCopy_template_TemplateList ¶
func DeepCopy_template_TemplateList(in interface{}, out interface{}, c *conversion.Cloner) error
DeepCopy_template_TemplateList is an autogenerated deepcopy function.
func IsKindOrLegacy ¶
IsKindOrLegacy checks if the provided GroupKind matches with the given kind by looking up the API group and also the legacy API.
func IsResourceOrLegacy ¶
func IsResourceOrLegacy(resource string, gr schema.GroupResource) bool
IsResourceOrLegacy checks if the provided GroupResources matches with the given resource by looking up the API group and also the legacy API.
func LegacyKind ¶
LegacyKind takes an unqualified kind and returns back a Group qualified GroupKind
func LegacyResource ¶
func LegacyResource(resource string) schema.GroupResource
func RegisterDeepCopies ¶
RegisterDeepCopies adds deep-copy functions to the given scheme. Public to allow building arbitrary schemes.
func Resource ¶
func Resource(resource string) schema.GroupResource
Resource takes an unqualified resource and returns back a Group qualified GroupResource
Types ¶
type BrokerTemplateInstance ¶
type BrokerTemplateInstance struct {
metav1.TypeMeta
metav1.ObjectMeta
// Spec describes the state of this BrokerTemplateInstance.
Spec BrokerTemplateInstanceSpec
}
BrokerTemplateInstance holds the service broker-related state associated with a TemplateInstance. BrokerTemplateInstance is part of an experimental API.
type BrokerTemplateInstanceList ¶
type BrokerTemplateInstanceList struct {
metav1.TypeMeta
metav1.ListMeta
// Items is a list of BrokerTemplateInstances
Items []BrokerTemplateInstance
}
BrokerTemplateInstanceList is a list of BrokerTemplateInstance objects.
type BrokerTemplateInstanceSpec ¶
type BrokerTemplateInstanceSpec struct {
// TemplateInstance is a reference to a TemplateInstance object residing
// in a namespace.
TemplateInstance kapi.ObjectReference
// Secret is a reference to a Secret object residing in a namespace,
// containing the necessary template parameters.
Secret kapi.ObjectReference
// BindingIDs is a list of 'binding_id's provided during successive bind
// calls to the template service broker.
BindingIDs []string
}
BrokerTemplateInstanceSpec describes the state of a BrokerTemplateInstance.
type Parameter ¶
type Parameter struct {
// Required: Parameter name must be set and it can be referenced in Template
// Items using ${PARAMETER_NAME}
Name string
// Optional: The name that will show in UI instead of parameter 'Name'
DisplayName string
// Optional: Parameter can have description
Description string
// Optional: Value holds the Parameter data. If specified, the generator
// will be ignored. The value replaces all occurrences of the Parameter
// ${Name} expression during the Template to Config transformation.
Value string
// Optional: Generate specifies the generator to be used to generate
// random string from an input value specified by From field. The result
// string is stored into Value field. If empty, no generator is being
// used, leaving the result Value untouched.
Generate string
// Optional: From is an input value for the generator.
From string
// Optional: Indicates the parameter must have a value. Defaults to false.
Required bool
}
Parameter defines a name/value variable that is to be processed during the Template to Config transformation.
type Template ¶
type Template struct {
metav1.TypeMeta
metav1.ObjectMeta
// message is an optional instructional message that will
// be displayed when this template is instantiated.
// This field should inform the user how to utilize the newly created resources.
// Parameter substitution will be performed on the message before being
// displayed so that generated credentials and other parameters can be
// included in the output.
Message string
// parameters is an optional array of Parameters used during the
// Template to Config transformation.
Parameters []Parameter
// objects is an array of resources to include in this template.
// If a namespace value is hardcoded in the object, it will be removed
// during template instantiation, however if the namespace value
// is, or contains, a ${PARAMETER_REFERENCE}, the resolved
// value after parameter substitution will be respected and the object
// will be created in that namespace.
Objects []runtime.Object
// objectLabels is an optional set of labels that are applied to every
// object during the Template to Config transformation.
ObjectLabels map[string]string
}
Template contains the inputs needed to produce a Config.
type TemplateInstance ¶
type TemplateInstance struct {
metav1.TypeMeta
metav1.ObjectMeta
// Spec describes the desired state of this TemplateInstance.
Spec TemplateInstanceSpec
// Status describes the current state of this TemplateInstance.
Status TemplateInstanceStatus
}
TemplateInstance requests and records the instantiation of a Template. TemplateInstance is part of an experimental API.
func (*TemplateInstance) HasCondition ¶
func (templateInstance *TemplateInstance) HasCondition(typ TemplateInstanceConditionType, status kapi.ConditionStatus) bool
func (*TemplateInstance) SetCondition ¶
func (templateInstance *TemplateInstance) SetCondition(condition TemplateInstanceCondition)
type TemplateInstanceCondition ¶
type TemplateInstanceCondition struct {
// Type of the condition, currently Ready or InstantiateFailure.
Type TemplateInstanceConditionType
// Status of the condition, one of True, False or Unknown.
Status kapi.ConditionStatus
// LastTransitionTime is the last time a condition status transitioned from
// one state to another.
LastTransitionTime metav1.Time
// Reason is a brief machine readable explanation for the condition's last
// transition.
Reason string
// Message is a human readable description of the details of the last
// transition, complementing reason.
Message string
}
TemplateInstanceCondition contains condition information for a TemplateInstance.
type TemplateInstanceConditionType ¶
type TemplateInstanceConditionType string
TemplateInstanceConditionType is the type of condition pertaining to a TemplateInstance.
const ( // TemplateInstanceReady indicates the readiness of the template // instantiation. TemplateInstanceReady TemplateInstanceConditionType = "Ready" // TemplateInstanceInstantiateFailure indicates the failure of the template // instantiation TemplateInstanceInstantiateFailure TemplateInstanceConditionType = "InstantiateFailure" )
type TemplateInstanceList ¶
type TemplateInstanceList struct {
metav1.TypeMeta
metav1.ListMeta
// Items is a list of Templateinstances
Items []TemplateInstance
}
TemplateInstanceList is a list of TemplateInstance objects.
type TemplateInstanceObject ¶
type TemplateInstanceObject struct {
// ref is a reference to the created object.
Ref kapi.ObjectReference
}
TemplateInstanceObject references an object created by a TemplateInstance.
type TemplateInstanceRequester ¶
type TemplateInstanceRequester struct {
// username uniquely identifies this user among all active users.
Username string
// uid is a unique value that identifies this user across time; if this user is
// deleted and another user by the same name is added, they will have
// different UIDs.
UID string
// groups represent the groups this user is a part of.
Groups []string
// extra holds additional information provided by the authenticator.
Extra map[string]ExtraValue
}
TemplateInstanceRequester holds the identity of an agent requesting a template instantiation.
type TemplateInstanceSpec ¶
type TemplateInstanceSpec struct {
// Template is a full copy of the template for instantiation.
Template Template
// Secret is a reference to a Secret object containing the necessary
// template parameters.
Secret *kapi.LocalObjectReference
// Requester holds the identity of the agent requesting the template
// instantiation.
Requester *TemplateInstanceRequester
}
TemplateInstanceSpec describes the desired state of a TemplateInstance.
type TemplateInstanceStatus ¶
type TemplateInstanceStatus struct {
// Conditions represent the latest available observations of a
// TemplateInstance's current state.
Conditions []TemplateInstanceCondition
// Objects references the objects created by the TemplateInstance.
Objects []TemplateInstanceObject
}
TemplateInstanceStatus describes the current state of a TemplateInstance.
Source Files
¶
Directories
¶
| Path | Synopsis |
|---|---|
|
+groupName=template.openshift.io Package v1 is the v1 version of the API.
|
+groupName=template.openshift.io Package v1 is the v1 version of the API. |
|
Package validation has functions for validating the correctness of Template objects and explaining what is wrong with them when they aren't valid.
|
Package validation has functions for validating the correctness of Template objects and explaining what is wrong with them when they aren't valid. |