Documentation ¶
Overview ¶
+k8s:deepcopy-gen=package +groupName=serving.knative.dev
Index ¶
- Constants
- Variables
- func Kind(kind string) schema.GroupKind
- func Resource(resource string) schema.GroupResource
- func RevisionLastPinnedString(t time.Time) string
- func ValidateContainerConcurrency(cc RevisionContainerConcurrencyType, cm RevisionRequestConcurrencyModelType) *apis.FieldError
- func ValidateObjectMetadata(meta metav1.Object) *apis.FieldError
- type AnnotationParseError
- type Configuration
- func (in *Configuration) DeepCopy() *Configuration
- func (in *Configuration) DeepCopyInto(out *Configuration)
- func (in *Configuration) DeepCopyObject() runtime.Object
- func (r *Configuration) GetGroupVersionKind() schema.GroupVersionKind
- func (c *Configuration) SetDefaults()
- func (c *Configuration) Validate() *apis.FieldError
- type ConfigurationList
- type ConfigurationSpec
- type ConfigurationStatus
- func (in *ConfigurationStatus) DeepCopy() *ConfigurationStatus
- func (in *ConfigurationStatus) DeepCopyInto(out *ConfigurationStatus)
- func (cs *ConfigurationStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
- func (cs *ConfigurationStatus) GetConditions() duckv1alpha1.Conditions
- func (cs *ConfigurationStatus) InitializeConditions()
- func (cs *ConfigurationStatus) IsLatestReadyRevisionNameUpToDate() bool
- func (cs *ConfigurationStatus) IsReady() bool
- func (cs *ConfigurationStatus) MarkLatestCreatedFailed(name, message string)
- func (cs *ConfigurationStatus) MarkLatestReadyDeleted()
- func (cs *ConfigurationStatus) MarkRevisionCreationFailed(message string)
- func (cs *ConfigurationStatus) SetConditions(conditions duckv1alpha1.Conditions)
- func (cs *ConfigurationStatus) SetLatestCreatedRevisionName(name string)
- func (cs *ConfigurationStatus) SetLatestReadyRevisionName(name string)
- type DeprecatedRevisionServingStateType
- type LastPinnedParseError
- type ManualType
- type PinnedType
- type RawExtension
- func (re *RawExtension) As(x interface{}) error
- func (re *RawExtension) AsDuck(x interface{}) error
- func (in *RawExtension) DeepCopy() *RawExtension
- func (in *RawExtension) DeepCopyInto(out *RawExtension)
- func (re RawExtension) MarshalJSON() ([]byte, error)
- func (re *RawExtension) UnmarshalJSON(in []byte) error
- type ReleaseType
- type Revision
- func (r *Revision) BuildRef() *corev1.ObjectReference
- func (current *Revision) CheckImmutableFields(og apis.Immutable) *apis.FieldError
- func (in *Revision) DeepCopy() *Revision
- func (in *Revision) DeepCopyInto(out *Revision)
- func (in *Revision) DeepCopyObject() runtime.Object
- func (r *Revision) GetConfigurationGeneration() (int64, error)
- func (r *Revision) GetGroupVersionKind() schema.GroupVersionKind
- func (r *Revision) GetLastPinned() (time.Time, error)
- func (r *Revision) SetDefaults()
- func (r *Revision) SetLastPinned(t time.Time)
- func (rt *Revision) Validate() *apis.FieldError
- type RevisionContainerConcurrencyType
- type RevisionList
- type RevisionRequestConcurrencyModelType
- type RevisionSpec
- type RevisionStatus
- func (in *RevisionStatus) DeepCopy() *RevisionStatus
- func (in *RevisionStatus) DeepCopyInto(out *RevisionStatus)
- func (rs *RevisionStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
- func (rs *RevisionStatus) GetConditions() duckv1alpha1.Conditions
- func (rs *RevisionStatus) InitializeBuildCondition()
- func (rs *RevisionStatus) InitializeConditions()
- func (rs *RevisionStatus) IsActivationRequired() bool
- func (rs *RevisionStatus) IsReady() bool
- func (rs *RevisionStatus) IsRoutable() bool
- func (rs *RevisionStatus) MarkActivating(reason, message string)
- func (rs *RevisionStatus) MarkActive()
- func (rs *RevisionStatus) MarkContainerHealthy()
- func (rs *RevisionStatus) MarkContainerMissing(message string)
- func (rs *RevisionStatus) MarkDeploying(reason string)
- func (rs *RevisionStatus) MarkInactive(reason, message string)
- func (rs *RevisionStatus) MarkProgressDeadlineExceeded(message string)
- func (rs *RevisionStatus) MarkResourcesAvailable()
- func (rs *RevisionStatus) MarkServiceTimeout()
- func (rs *RevisionStatus) PropagateBuildStatus(bs duckv1alpha1.KResourceStatus)
- func (rs *RevisionStatus) SetConditions(conditions duckv1alpha1.Conditions)
- type RevisionTemplateSpec
- type Route
- type RouteList
- type RouteSpec
- type RouteStatus
- func (in *RouteStatus) DeepCopy() *RouteStatus
- func (in *RouteStatus) DeepCopyInto(out *RouteStatus)
- func (rs *RouteStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
- func (rs *RouteStatus) GetConditions() duckv1alpha1.Conditions
- func (rs *RouteStatus) InitializeConditions()
- func (rs *RouteStatus) IsReady() bool
- func (rs *RouteStatus) MarkConfigurationFailed(name string)
- func (rs *RouteStatus) MarkConfigurationNotReady(name string)
- func (rs *RouteStatus) MarkMissingTrafficTarget(kind, name string)
- func (rs *RouteStatus) MarkRevisionFailed(name string)
- func (rs *RouteStatus) MarkRevisionNotReady(name string)
- func (rs *RouteStatus) MarkTrafficAssigned()
- func (rs *RouteStatus) MarkUnknownTrafficError(msg string)
- func (rs *RouteStatus) PropagateClusterIngressStatus(cs v1alpha1.IngressStatus)
- func (rs *RouteStatus) SetConditions(conditions duckv1alpha1.Conditions)
- type RunLatestType
- type Service
- type ServiceList
- type ServiceSpec
- type ServiceStatus
- func (in *ServiceStatus) DeepCopy() *ServiceStatus
- func (in *ServiceStatus) DeepCopyInto(out *ServiceStatus)
- func (ss *ServiceStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
- func (ss *ServiceStatus) GetConditions() duckv1alpha1.Conditions
- func (ss *ServiceStatus) InitializeConditions()
- func (ss *ServiceStatus) IsReady() bool
- func (ss *ServiceStatus) PropagateConfigurationStatus(cs ConfigurationStatus)
- func (ss *ServiceStatus) PropagateRouteStatus(rs RouteStatus)
- func (ss *ServiceStatus) SetConditions(conditions duckv1alpha1.Conditions)
- func (ss *ServiceStatus) SetManualStatus()
- type TrafficTarget
Constants ¶
const ( // RevisionConditionReady is set when the revision is starting to materialize // runtime resources, and becomes true when those resources are ready. RevisionConditionReady = duckv1alpha1.ConditionReady // RevisionConditionBuildSucceeded is set when the revision has an associated build // and is marked True if/once the Build has completed successfully. RevisionConditionBuildSucceeded duckv1alpha1.ConditionType = "BuildSucceeded" // RevisionConditionResourcesAvailable is set when underlying // Kubernetes resources have been provisioned. RevisionConditionResourcesAvailable duckv1alpha1.ConditionType = "ResourcesAvailable" // RevisionConditionContainerHealthy is set when the revision readiness check completes. RevisionConditionContainerHealthy duckv1alpha1.ConditionType = "ContainerHealthy" // RevisionConditionActive is set when the revision is receiving traffic. RevisionConditionActive duckv1alpha1.ConditionType = "Active" )
const ( AnnotationParseErrorTypeMissing = "Missing" AnnotationParseErrorTypeInvalid = "Invalid" )
const ( // RouteConditionReady is set when the service is configured // and has available backends ready to receive traffic. RouteConditionReady = duckv1alpha1.ConditionReady // RouteConditionAllTrafficAssigned is set to False when the // service is not configured properly or has no available // backends ready to receive traffic. RouteConditionAllTrafficAssigned duckv1alpha1.ConditionType = "AllTrafficAssigned" // RouteConditionIngressReady is set to False when the // ClusterIngress fails to become Ready. RouteConditionIngressReady duckv1alpha1.ConditionType = "IngressReady" )
const ( // ServiceConditionReady is set when the service is configured // and has available backends ready to receive traffic. ServiceConditionReady = duckv1alpha1.ConditionReady // ServiceConditionRoutesReady is set when the service's underlying // routes have reported readiness. ServiceConditionRoutesReady duckv1alpha1.ConditionType = "RoutesReady" // ServiceConditionConfigurationsReady is set when the service's underlying // configurations have reported readiness. ServiceConditionConfigurationsReady duckv1alpha1.ConditionType = "ConfigurationsReady" )
ConditionType represents a Service condition value
const ( // ConfigurationConditionReady is set when the configuration's latest // underlying revision has reported readiness. ConfigurationConditionReady = duckv1alpha1.ConditionReady )
Variables ¶
var ( SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes) AddToScheme = SchemeBuilder.AddToScheme )
var SchemeGroupVersion = schema.GroupVersion{Group: serving.GroupName, Version: "v1alpha1"}
SchemeGroupVersion is group version used to register these objects
Functions ¶
func Resource ¶
func Resource(resource string) schema.GroupResource
Resource takes an unqualified resource and returns a Group qualified GroupResource
func RevisionLastPinnedString ¶ added in v0.2.0
func ValidateContainerConcurrency ¶ added in v0.2.0
func ValidateContainerConcurrency(cc RevisionContainerConcurrencyType, cm RevisionRequestConcurrencyModelType) *apis.FieldError
func ValidateObjectMetadata ¶ added in v0.2.0
func ValidateObjectMetadata(meta metav1.Object) *apis.FieldError
Types ¶
type AnnotationParseError ¶ added in v0.2.0
+k8s:deepcopy-gen=false
type Configuration ¶
type Configuration struct { metav1.TypeMeta `json:",inline"` // +optional metav1.ObjectMeta `json:"metadata,omitempty"` // Spec holds the desired state of the Configuration (from the client). // +optional Spec ConfigurationSpec `json:"spec,omitempty"` // Status communicates the observed state of the Configuration (from the controller). // +optional Status ConfigurationStatus `json:"status,omitempty"` }
Configuration represents the "floating HEAD" of a linear history of Revisions, and optionally how the containers those revisions reference are built. Users create new Revisions by updating the Configuration's spec. The "latest created" revision's name is available under status, as is the "latest ready" revision's name. See also: https://github.com/knative/serving/blob/master/docs/spec/overview.md#configuration
func (*Configuration) DeepCopy ¶
func (in *Configuration) DeepCopy() *Configuration
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Configuration.
func (*Configuration) DeepCopyInto ¶
func (in *Configuration) DeepCopyInto(out *Configuration)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*Configuration) DeepCopyObject ¶
func (in *Configuration) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (*Configuration) GetGroupVersionKind ¶ added in v0.2.0
func (r *Configuration) GetGroupVersionKind() schema.GroupVersionKind
func (*Configuration) SetDefaults ¶
func (c *Configuration) SetDefaults()
func (*Configuration) Validate ¶
func (c *Configuration) Validate() *apis.FieldError
type ConfigurationList ¶
type ConfigurationList struct { metav1.TypeMeta `json:",inline"` metav1.ListMeta `json:"metadata"` Items []Configuration `json:"items"` }
ConfigurationList is a list of Configuration resources
func (*ConfigurationList) DeepCopy ¶
func (in *ConfigurationList) DeepCopy() *ConfigurationList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ConfigurationList.
func (*ConfigurationList) DeepCopyInto ¶
func (in *ConfigurationList) DeepCopyInto(out *ConfigurationList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ConfigurationList) DeepCopyObject ¶
func (in *ConfigurationList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type ConfigurationSpec ¶
type ConfigurationSpec struct { // TODO: Generation does not work correctly with CRD. They are scrubbed // by the APIserver (https://github.com/kubernetes/kubernetes/issues/58778) // So, we add Generation here. Once that gets fixed, remove this and use // ObjectMeta.Generation instead. // +optional Generation int64 `json:"generation,omitempty"` // Build optionally holds the specification for the build to // perform to produce the Revision's container image. // +optional Build *RawExtension `json:"build,omitempty"` // RevisionTemplate holds the latest specification for the Revision to // be stamped out. If a Build specification is provided, then the // RevisionTemplate's BuildName field will be populated with the name of // the Build object created to produce the container for the Revision. // +optional RevisionTemplate RevisionTemplateSpec `json:"revisionTemplate"` }
ConfigurationSpec holds the desired state of the Configuration (from the client).
func (*ConfigurationSpec) DeepCopy ¶
func (in *ConfigurationSpec) DeepCopy() *ConfigurationSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ConfigurationSpec.
func (*ConfigurationSpec) DeepCopyInto ¶
func (in *ConfigurationSpec) DeepCopyInto(out *ConfigurationSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ConfigurationSpec) SetDefaults ¶
func (cs *ConfigurationSpec) SetDefaults()
func (*ConfigurationSpec) Validate ¶
func (cs *ConfigurationSpec) Validate() *apis.FieldError
type ConfigurationStatus ¶
type ConfigurationStatus struct { // Conditions communicates information about ongoing/complete // reconciliation processes that bring the "spec" inline with the observed // state of the world. // +optional Conditions duckv1alpha1.Conditions `json:"conditions,omitempty"` // LatestReadyRevisionName holds the name of the latest Revision stamped out // from this Configuration that has had its "Ready" condition become "True". // +optional LatestReadyRevisionName string `json:"latestReadyRevisionName,omitempty"` // LatestCreatedRevisionName is the last revision that was created from this // Configuration. It might not be ready yet, for that use LatestReadyRevisionName. // +optional LatestCreatedRevisionName string `json:"latestCreatedRevisionName,omitempty"` // ObservedGeneration is the 'Generation' of the Configuration that // was last processed by the controller. The observed generation is updated // even if the controller failed to process the spec and create the Revision. // +optional ObservedGeneration int64 `json:"observedGeneration,omitempty"` }
ConfigurationStatus communicates the observed state of the Configuration (from the controller).
func (*ConfigurationStatus) DeepCopy ¶
func (in *ConfigurationStatus) DeepCopy() *ConfigurationStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ConfigurationStatus.
func (*ConfigurationStatus) DeepCopyInto ¶
func (in *ConfigurationStatus) DeepCopyInto(out *ConfigurationStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ConfigurationStatus) GetCondition ¶
func (cs *ConfigurationStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
func (*ConfigurationStatus) GetConditions ¶ added in v0.2.0
func (cs *ConfigurationStatus) GetConditions() duckv1alpha1.Conditions
GetConditions returns the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
func (*ConfigurationStatus) InitializeConditions ¶
func (cs *ConfigurationStatus) InitializeConditions()
func (*ConfigurationStatus) IsLatestReadyRevisionNameUpToDate ¶
func (cs *ConfigurationStatus) IsLatestReadyRevisionNameUpToDate() bool
IsLatestReadyRevisionNameUpToDate returns true if the Configuration is ready and LatestCreateRevisionName is equal to LatestReadyRevisionName. Otherwise it returns false.
func (*ConfigurationStatus) IsReady ¶
func (cs *ConfigurationStatus) IsReady() bool
IsReady looks at the conditions to see if they are happy.
func (*ConfigurationStatus) MarkLatestCreatedFailed ¶
func (cs *ConfigurationStatus) MarkLatestCreatedFailed(name, message string)
func (*ConfigurationStatus) MarkLatestReadyDeleted ¶
func (cs *ConfigurationStatus) MarkLatestReadyDeleted()
func (*ConfigurationStatus) MarkRevisionCreationFailed ¶
func (cs *ConfigurationStatus) MarkRevisionCreationFailed(message string)
func (*ConfigurationStatus) SetConditions ¶ added in v0.2.0
func (cs *ConfigurationStatus) SetConditions(conditions duckv1alpha1.Conditions)
SetConditions sets the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
func (*ConfigurationStatus) SetLatestCreatedRevisionName ¶
func (cs *ConfigurationStatus) SetLatestCreatedRevisionName(name string)
func (*ConfigurationStatus) SetLatestReadyRevisionName ¶
func (cs *ConfigurationStatus) SetLatestReadyRevisionName(name string)
type DeprecatedRevisionServingStateType ¶ added in v0.2.0
type DeprecatedRevisionServingStateType string
DeprecatedRevisionServingStateType is an enumeration of the levels of serving readiness of the Revision. See also: https://github.com/knative/serving/blob/master/docs/spec/errors.md#error-conditions-and-reporting
const ( // The revision is ready to serve traffic. It should have Kubernetes // resources, and the Istio route should be pointed to the given resources. DeprecatedRevisionServingStateActive DeprecatedRevisionServingStateType = "Active" // The revision is not currently serving traffic, but could be made to serve // traffic quickly. It should have Kubernetes resources, but the Istio route // should be pointed to the activator. DeprecatedRevisionServingStateReserve DeprecatedRevisionServingStateType = "Reserve" // The revision has been decommissioned and is not needed to serve traffic // anymore. It should not have any Istio routes or Kubernetes resources. // A Revision may be brought out of retirement, but it may take longer than // it would from a "Reserve" state. // Note: currently not set anywhere. See https://github.com/knative/serving/issues/1203 DeprecatedRevisionServingStateRetired DeprecatedRevisionServingStateType = "Retired" )
func (DeprecatedRevisionServingStateType) Validate ¶ added in v0.2.0
func (ss DeprecatedRevisionServingStateType) Validate() *apis.FieldError
type LastPinnedParseError ¶ added in v0.2.0
type LastPinnedParseError AnnotationParseError
+k8s:deepcopy-gen=false
func (LastPinnedParseError) Error ¶ added in v0.2.0
func (e LastPinnedParseError) Error() string
type ManualType ¶ added in v0.2.0
type ManualType struct { }
ManualType contains the options for configuring a manual service. See ServiceSpec for more details.
func (*ManualType) DeepCopy ¶ added in v0.2.0
func (in *ManualType) DeepCopy() *ManualType
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ManualType.
func (*ManualType) DeepCopyInto ¶ added in v0.2.0
func (in *ManualType) DeepCopyInto(out *ManualType)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ManualType) Validate ¶ added in v0.2.0
func (m *ManualType) Validate() *apis.FieldError
Validate validates the fields belonging to ManualType
type PinnedType ¶
type PinnedType struct { // The revision name to pin this service to until changed // to a different service type. // +optional RevisionName string `json:"revisionName,omitempty"` // The configuration for this service. // +optional Configuration ConfigurationSpec `json:"configuration,omitempty"` }
PinnedType is DEPRECATED. ReleaseType should be used instead. To get the behavior of PinnedType set ReleaseType.Revisions to []string{PinnedType.RevisionName} and ReleaseType.RolloutPercent to 0.
func (*PinnedType) DeepCopy ¶
func (in *PinnedType) DeepCopy() *PinnedType
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new PinnedType.
func (*PinnedType) DeepCopyInto ¶
func (in *PinnedType) DeepCopyInto(out *PinnedType)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*PinnedType) Validate ¶
func (pt *PinnedType) Validate() *apis.FieldError
Validate validates the fields belonging to PinnedType
type RawExtension ¶ added in v0.2.0
type RawExtension struct { // Field order is the precedence for JSON marshaling if multiple // fields are set. Raw []byte Object runtime.Object BuildSpec *buildv1alpha1.BuildSpec }
RawExtension is modeled after runtime.RawExtension, and should be replaced with it (or an alias) once we can stop supporting embedded BuildSpecs.
func (*RawExtension) As ¶ added in v0.2.0
func (re *RawExtension) As(x interface{}) error
As is a helper to decode the raw object into a particular type. The type is expected to exhaustively specify the fields encountered.
func (*RawExtension) AsDuck ¶ added in v0.2.0
func (re *RawExtension) AsDuck(x interface{}) error
AsDuck is a helper to decode the raw object into a particular duck type. The type may only represent a subset of the fields present.
func (*RawExtension) DeepCopy ¶ added in v0.2.0
func (in *RawExtension) DeepCopy() *RawExtension
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RawExtension.
func (*RawExtension) DeepCopyInto ¶ added in v0.2.0
func (in *RawExtension) DeepCopyInto(out *RawExtension)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (RawExtension) MarshalJSON ¶ added in v0.2.0
func (re RawExtension) MarshalJSON() ([]byte, error)
MarshalJSON may get called on pointers or values, so implement MarshalJSON on value. http://stackoverflow.com/questions/21390979/custom-marshaljson-never-gets-called-in-go
func (*RawExtension) UnmarshalJSON ¶ added in v0.2.0
func (re *RawExtension) UnmarshalJSON(in []byte) error
type ReleaseType ¶ added in v0.2.0
type ReleaseType struct { // Revisions is an ordered list of 1 or 2 revisions. The first will // have a TrafficTarget with a name of "current" and the second will have // a name of "candidate". // +optional Revisions []string `json:"revisions,omitempty"` // RolloutPercent is the percent of traffic that should be sent to the "candidate" // revision. Valid values are between 0 and 99 inclusive. // +optional RolloutPercent int `json:"rolloutPercent,omitempty"` // The configuration for this service. All revisions from this service must // come from a single configuration. // +optional Configuration ConfigurationSpec `json:"configuration,omitempty"` }
ReleaseType contains the options for slowly releasing revisions. See ServiceSpec for more details.
func (*ReleaseType) DeepCopy ¶ added in v0.2.0
func (in *ReleaseType) DeepCopy() *ReleaseType
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ReleaseType.
func (*ReleaseType) DeepCopyInto ¶ added in v0.2.0
func (in *ReleaseType) DeepCopyInto(out *ReleaseType)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ReleaseType) Validate ¶ added in v0.2.0
func (rt *ReleaseType) Validate() *apis.FieldError
Validate validates the fields belonging to ReleaseType
type Revision ¶
type Revision struct { metav1.TypeMeta `json:",inline"` // +optional metav1.ObjectMeta `json:"metadata,omitempty"` // Spec holds the desired state of the Revision (from the client). // +optional Spec RevisionSpec `json:"spec,omitempty"` // Status communicates the observed state of the Revision (from the controller). // +optional Status RevisionStatus `json:"status,omitempty"` }
Revision is an immutable snapshot of code and configuration. A revision references a container image, and optionally a build that is responsible for materializing that container image from source. Revisions are created by updates to a Configuration.
See also: https://github.com/knative/serving/blob/master/docs/spec/overview.md#revision
func (*Revision) BuildRef ¶ added in v0.2.0
func (r *Revision) BuildRef() *corev1.ObjectReference
func (*Revision) CheckImmutableFields ¶
func (current *Revision) CheckImmutableFields(og apis.Immutable) *apis.FieldError
func (*Revision) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Revision.
func (*Revision) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*Revision) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (*Revision) GetConfigurationGeneration ¶ added in v0.2.0
func (*Revision) GetGroupVersionKind ¶ added in v0.2.0
func (r *Revision) GetGroupVersionKind() schema.GroupVersionKind
func (*Revision) GetLastPinned ¶ added in v0.2.0
func (*Revision) SetDefaults ¶
func (r *Revision) SetDefaults()
func (*Revision) SetLastPinned ¶ added in v0.2.0
func (*Revision) Validate ¶
func (rt *Revision) Validate() *apis.FieldError
type RevisionContainerConcurrencyType ¶ added in v0.2.0
type RevisionContainerConcurrencyType int64
RevisionContainerConcurrencyType is an integer expressing a number of in-flight (concurrent) requests.
const ( // The maximum configurable container concurrency. RevisionContainerConcurrencyMax RevisionContainerConcurrencyType = 1000 )
type RevisionList ¶
type RevisionList struct { metav1.TypeMeta `json:",inline"` metav1.ListMeta `json:"metadata"` Items []Revision `json:"items"` }
RevisionList is a list of Revision resources
func (*RevisionList) DeepCopy ¶
func (in *RevisionList) DeepCopy() *RevisionList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RevisionList.
func (*RevisionList) DeepCopyInto ¶
func (in *RevisionList) DeepCopyInto(out *RevisionList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RevisionList) DeepCopyObject ¶
func (in *RevisionList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type RevisionRequestConcurrencyModelType ¶
type RevisionRequestConcurrencyModelType string
RevisionRequestConcurrencyModelType is an enumeration of the concurrency models supported by a Revision. Deprecated in favor of RevisionContainerConcurrencyType.
const ( // RevisionRequestConcurrencyModelSingle guarantees that only one // request will be handled at a time (concurrently) per instance // of Revision Container. RevisionRequestConcurrencyModelSingle RevisionRequestConcurrencyModelType = "Single" // RevisionRequestConcurencyModelMulti allows more than one request to // be handled at a time (concurrently) per instance of Revision // Container. RevisionRequestConcurrencyModelMulti RevisionRequestConcurrencyModelType = "Multi" )
func (RevisionRequestConcurrencyModelType) Validate ¶
func (cm RevisionRequestConcurrencyModelType) Validate() *apis.FieldError
type RevisionSpec ¶
type RevisionSpec struct { // TODO: Generation does not work correctly with CRD. They are scrubbed // by the APIserver (https://github.com/kubernetes/kubernetes/issues/58778) // So, we add Generation here. Once that gets fixed, remove this and use // ObjectMeta.Generation instead. // +optional Generation int64 `json:"generation,omitempty"` // DeprecatedServingState holds a value describing the desired state the Kubernetes // resources should be in for this Revision. // Users must not specify this when creating a revision. These values are no longer // updated by the system. // +optional DeprecatedServingState DeprecatedRevisionServingStateType `json:"servingState,omitempty"` // ConcurrencyModel specifies the desired concurrency model // (Single or Multi) for the // Revision. Defaults to Multi. // Deprecated in favor of ContainerConcurrency. // +optional ConcurrencyModel RevisionRequestConcurrencyModelType `json:"concurrencyModel,omitempty"` // ContainerConcurrency specifies the maximum allowed // in-flight (concurrent) requests per container of the Revision. // Defaults to `0` which means unlimited concurrency. // This field replaces ConcurrencyModel. A value of `1` // is equivalent to `Single` and `0` is equivalent to `Multi`. // +optional ContainerConcurrency RevisionContainerConcurrencyType `json:"containerConcurrency,omitempty"` // ServiceAccountName holds the name of the Kubernetes service account // as which the underlying K8s resources should be run. If unspecified // this will default to the "default" service account for the namespace // in which the Revision exists. // This may be used to provide access to private container images by // following: https://kubernetes.io/docs/tasks/configure-pod-container/configure-service-account/#add-imagepullsecrets-to-a-service-account // TODO(ZhiminXiang): verify the corresponding service account exists. // +optional ServiceAccountName string `json:"serviceAccountName,omitempty"` // BuildName optionally holds the name of the Build responsible for // producing the container image for its Revision. // DEPRECATED: Use BuildRef instead. // +optional BuildName string `json:"buildName,omitempty"` // BuildRef holds the reference to the build (if there is one) responsible // for producing the container image for this Revision. Otherwise, nil // +optional BuildRef *corev1.ObjectReference `json:"buildRef,omitempty"` // Container defines the unit of execution for this Revision. // In the context of a Revision, we disallow a number of the fields of // this Container, including: name, resources, ports, and volumeMounts. // TODO(mattmoor): Link to the runtime contract tracked by: // https://github.com/knative/serving/issues/627 // +optional Container corev1.Container `json:"container,omitempty"` }
RevisionSpec holds the desired state of the Revision (from the client).
func (*RevisionSpec) DeepCopy ¶
func (in *RevisionSpec) DeepCopy() *RevisionSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RevisionSpec.
func (*RevisionSpec) DeepCopyInto ¶
func (in *RevisionSpec) DeepCopyInto(out *RevisionSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RevisionSpec) SetDefaults ¶
func (rs *RevisionSpec) SetDefaults()
func (*RevisionSpec) Validate ¶
func (rs *RevisionSpec) Validate() *apis.FieldError
type RevisionStatus ¶
type RevisionStatus struct { // ServiceName holds the name of a core Kubernetes Service resource that // load balances over the pods backing this Revision. When the Revision // is Active, this service would be an appropriate ingress target for // targeting the revision. // +optional ServiceName string `json:"serviceName,omitempty"` // Conditions communicates information about ongoing/complete // reconciliation processes that bring the "spec" inline with the observed // state of the world. // +optional Conditions duckv1alpha1.Conditions `json:"conditions,omitempty"` // ObservedGeneration is the 'Generation' of the Configuration that // was last processed by the controller. The observed generation is updated // even if the controller failed to process the spec and create the Revision. // +optional ObservedGeneration int64 `json:"observedGeneration,omitempty"` // LogURL specifies the generated logging url for this particular revision // based on the revision url template specified in the controller's config. // +optional LogURL string `json:"logUrl,omitempty"` // ImageDigest holds the resolved digest for the image specified // within .Spec.Container.Image. The digest is resolved during the creation // of Revision. This field holds the digest value regardless of whether // a tag or digest was originally specified in the Container object. It // may be empty if the image comes from a registry listed to skip resolution. // +optional ImageDigest string `json:"imageDigest,omitempty"` }
RevisionStatus communicates the observed state of the Revision (from the controller).
func (*RevisionStatus) DeepCopy ¶
func (in *RevisionStatus) DeepCopy() *RevisionStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RevisionStatus.
func (*RevisionStatus) DeepCopyInto ¶
func (in *RevisionStatus) DeepCopyInto(out *RevisionStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RevisionStatus) GetCondition ¶
func (rs *RevisionStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
func (*RevisionStatus) GetConditions ¶ added in v0.2.0
func (rs *RevisionStatus) GetConditions() duckv1alpha1.Conditions
GetConditions returns the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
func (*RevisionStatus) InitializeBuildCondition ¶
func (rs *RevisionStatus) InitializeBuildCondition()
func (*RevisionStatus) InitializeConditions ¶
func (rs *RevisionStatus) InitializeConditions()
func (*RevisionStatus) IsActivationRequired ¶
func (rs *RevisionStatus) IsActivationRequired() bool
func (*RevisionStatus) IsReady ¶
func (rs *RevisionStatus) IsReady() bool
IsReady looks at the conditions and if the Status has a condition RevisionConditionReady returns true if ConditionStatus is True
func (*RevisionStatus) IsRoutable ¶
func (rs *RevisionStatus) IsRoutable() bool
func (*RevisionStatus) MarkActivating ¶ added in v0.2.0
func (rs *RevisionStatus) MarkActivating(reason, message string)
func (*RevisionStatus) MarkActive ¶ added in v0.2.0
func (rs *RevisionStatus) MarkActive()
func (*RevisionStatus) MarkContainerHealthy ¶
func (rs *RevisionStatus) MarkContainerHealthy()
func (*RevisionStatus) MarkContainerMissing ¶
func (rs *RevisionStatus) MarkContainerMissing(message string)
func (*RevisionStatus) MarkDeploying ¶
func (rs *RevisionStatus) MarkDeploying(reason string)
func (*RevisionStatus) MarkInactive ¶
func (rs *RevisionStatus) MarkInactive(reason, message string)
func (*RevisionStatus) MarkProgressDeadlineExceeded ¶
func (rs *RevisionStatus) MarkProgressDeadlineExceeded(message string)
func (*RevisionStatus) MarkResourcesAvailable ¶
func (rs *RevisionStatus) MarkResourcesAvailable()
func (*RevisionStatus) MarkServiceTimeout ¶
func (rs *RevisionStatus) MarkServiceTimeout()
func (*RevisionStatus) PropagateBuildStatus ¶
func (rs *RevisionStatus) PropagateBuildStatus(bs duckv1alpha1.KResourceStatus)
func (*RevisionStatus) SetConditions ¶ added in v0.2.0
func (rs *RevisionStatus) SetConditions(conditions duckv1alpha1.Conditions)
SetConditions sets the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
type RevisionTemplateSpec ¶
type RevisionTemplateSpec struct { // +optional metav1.ObjectMeta `json:"metadata,omitempty"` // +optional Spec RevisionSpec `json:"spec,omitempty"` }
RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190
func (*RevisionTemplateSpec) DeepCopy ¶
func (in *RevisionTemplateSpec) DeepCopy() *RevisionTemplateSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RevisionTemplateSpec.
func (*RevisionTemplateSpec) DeepCopyInto ¶
func (in *RevisionTemplateSpec) DeepCopyInto(out *RevisionTemplateSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RevisionTemplateSpec) Validate ¶
func (rt *RevisionTemplateSpec) Validate() *apis.FieldError
type Route ¶
type Route struct { metav1.TypeMeta `json:",inline"` // +optional metav1.ObjectMeta `json:"metadata,omitempty"` // Spec holds the desired state of the Route (from the client). // +optional Spec RouteSpec `json:"spec,omitempty"` // Status communicates the observed state of the Route (from the controller). // +optional Status RouteStatus `json:"status,omitempty"` }
Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for "latest ready" revision changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/master/docs/spec/overview.md#route
func (*Route) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Route.
func (*Route) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*Route) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (*Route) GetGroupVersionKind ¶ added in v0.2.0
func (r *Route) GetGroupVersionKind() schema.GroupVersionKind
func (*Route) SetDefaults ¶
func (r *Route) SetDefaults()
func (*Route) Validate ¶
func (r *Route) Validate() *apis.FieldError
type RouteList ¶
type RouteList struct { metav1.TypeMeta `json:",inline"` metav1.ListMeta `json:"metadata"` Items []Route `json:"items"` }
RouteList is a list of Route resources
func (*RouteList) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RouteList.
func (*RouteList) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RouteList) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type RouteSpec ¶
type RouteSpec struct { // TODO: Generation does not work correctly with CRD. They are scrubbed // by the APIserver (https://github.com/kubernetes/kubernetes/issues/58778) // So, we add Generation here. Once that gets fixed, remove this and use // ObjectMeta.Generation instead. // +optional Generation int64 `json:"generation,omitempty"` // Traffic specifies how to distribute traffic over a collection of Knative Serving Revisions and Configurations. // +optional Traffic []TrafficTarget `json:"traffic,omitempty"` }
RouteSpec holds the desired state of the Route (from the client).
func (*RouteSpec) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RouteSpec.
func (*RouteSpec) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RouteSpec) SetDefaults ¶
func (rs *RouteSpec) SetDefaults()
func (*RouteSpec) Validate ¶
func (rs *RouteSpec) Validate() *apis.FieldError
type RouteStatus ¶
type RouteStatus struct { // Domain holds the top-level domain that will distribute traffic over the provided targets. // It generally has the form {route-name}.{route-namespace}.{cluster-level-suffix} // +optional Domain string `json:"domain,omitempty"` // DomainInternal holds the top-level domain that will distribute traffic over the provided // targets from inside the cluster. It generally has the form // {route-name}.{route-namespace}.svc.cluster.local // DEPRECATED: Use Address instead. // +optional DomainInternal string `json:"domainInternal,omitempty"` // Address holds the information needed for a Route to be the target of an event. // +optional Address *duckv1alpha1.Addressable `json:"address,omitempty"` // Traffic holds the configured traffic distribution. // These entries will always contain RevisionName references. // When ConfigurationName appears in the spec, this will hold the // LatestReadyRevisionName that we last observed. // +optional Traffic []TrafficTarget `json:"traffic,omitempty"` // Conditions communicates information about ongoing/complete // reconciliation processes that bring the "spec" inline with the observed // state of the world. // +optional Conditions duckv1alpha1.Conditions `json:"conditions,omitempty"` // ObservedGeneration is the 'Generation' of the Configuration that // was last processed by the controller. The observed generation is updated // even if the controller failed to process the spec and create the Revision. // +optional ObservedGeneration int64 `json:"observedGeneration,omitempty"` }
RouteStatus communicates the observed state of the Route (from the controller).
func (*RouteStatus) DeepCopy ¶
func (in *RouteStatus) DeepCopy() *RouteStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RouteStatus.
func (*RouteStatus) DeepCopyInto ¶
func (in *RouteStatus) DeepCopyInto(out *RouteStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RouteStatus) GetCondition ¶
func (rs *RouteStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
func (*RouteStatus) GetConditions ¶ added in v0.2.0
func (rs *RouteStatus) GetConditions() duckv1alpha1.Conditions
GetConditions returns the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
func (*RouteStatus) InitializeConditions ¶
func (rs *RouteStatus) InitializeConditions()
func (*RouteStatus) IsReady ¶
func (rs *RouteStatus) IsReady() bool
func (*RouteStatus) MarkConfigurationFailed ¶
func (rs *RouteStatus) MarkConfigurationFailed(name string)
func (*RouteStatus) MarkConfigurationNotReady ¶
func (rs *RouteStatus) MarkConfigurationNotReady(name string)
func (*RouteStatus) MarkMissingTrafficTarget ¶
func (rs *RouteStatus) MarkMissingTrafficTarget(kind, name string)
func (*RouteStatus) MarkRevisionFailed ¶
func (rs *RouteStatus) MarkRevisionFailed(name string)
func (*RouteStatus) MarkRevisionNotReady ¶
func (rs *RouteStatus) MarkRevisionNotReady(name string)
func (*RouteStatus) MarkTrafficAssigned ¶
func (rs *RouteStatus) MarkTrafficAssigned()
func (*RouteStatus) MarkUnknownTrafficError ¶
func (rs *RouteStatus) MarkUnknownTrafficError(msg string)
func (*RouteStatus) PropagateClusterIngressStatus ¶ added in v0.2.0
func (rs *RouteStatus) PropagateClusterIngressStatus(cs v1alpha1.IngressStatus)
PropagateClusterIngressStatus update RouteConditionIngressReady condition in RouteStatus according to IngressStatus.
func (*RouteStatus) SetConditions ¶ added in v0.2.0
func (rs *RouteStatus) SetConditions(conditions duckv1alpha1.Conditions)
SetConditions sets the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
type RunLatestType ¶
type RunLatestType struct { // The configuration for this service. // +optional Configuration ConfigurationSpec `json:"configuration,omitempty"` }
RunLatestType contains the options for always having a route to the latest configuration. See ServiceSpec for more details.
func (*RunLatestType) DeepCopy ¶
func (in *RunLatestType) DeepCopy() *RunLatestType
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new RunLatestType.
func (*RunLatestType) DeepCopyInto ¶
func (in *RunLatestType) DeepCopyInto(out *RunLatestType)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*RunLatestType) Validate ¶
func (rlt *RunLatestType) Validate() *apis.FieldError
Validate validates the fields belonging to RunLatestType
type Service ¶
type Service struct { metav1.TypeMeta `json:",inline"` // +optional metav1.ObjectMeta `json:"metadata,omitempty"` // +optional Spec ServiceSpec `json:"spec,omitempty"` // +optional Status ServiceStatus `json:"status,omitempty"` }
Service acts as a top-level container that manages a set of Routes and Configurations which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which encapsulates software lifecycle decisions such as rollout policy and team resource ownership. Service acts only as an orchestrator of the underlying Routes and Configurations (much as a kubernetes Deployment orchestrates ReplicaSets), and its usage is optional but recommended.
The Service's controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.
See also: https://github.com/knative/serving/blob/master/docs/spec/overview.md#service
func (*Service) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Service.
func (*Service) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*Service) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (*Service) GetGroupVersionKind ¶ added in v0.2.0
func (s *Service) GetGroupVersionKind() schema.GroupVersionKind
func (*Service) SetDefaults ¶
func (s *Service) SetDefaults()
func (*Service) Validate ¶
func (s *Service) Validate() *apis.FieldError
Validate validates the fields belonging to Service
type ServiceList ¶
type ServiceList struct { metav1.TypeMeta `json:",inline"` metav1.ListMeta `json:"metadata"` Items []Service `json:"items"` }
ServiceList is a list of Service resources
func (*ServiceList) DeepCopy ¶
func (in *ServiceList) DeepCopy() *ServiceList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceList.
func (*ServiceList) DeepCopyInto ¶
func (in *ServiceList) DeepCopyInto(out *ServiceList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ServiceList) DeepCopyObject ¶
func (in *ServiceList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type ServiceSpec ¶
type ServiceSpec struct { // TODO: Generation does not work correctly with CRD. They are scrubbed // by the APIserver (https://github.com/kubernetes/kubernetes/issues/58778) // So, we add Generation here. Once that gets fixed, remove this and use // ObjectMeta.Generation instead. // +optional Generation int64 `json:"generation,omitempty"` // RunLatest defines a simple Service. It will automatically // configure a route that keeps the latest ready revision // from the supplied configuration running. // +optional RunLatest *RunLatestType `json:"runLatest,omitempty"` // Pins this service to a specific revision name. The revision must // be owned by the configuration provided. // PinnedType is DEPRECATED in favor of ReleaseType // +optional Pinned *PinnedType `json:"pinned,omitempty"` // Manual mode enables users to start managing the underlying Route and Configuration // resources directly. This advanced usage is intended as a path for users to graduate // from the limited capabilities of Service to the full power of Route. // +optional Manual *ManualType `json:"manual,omitempty"` // Release enables gradual promotion of new revisions by allowing traffic // to be split between two revisions. This type replaces the deprecated Pinned type. // +optional Release *ReleaseType `json:"release,omitempty"` }
ServiceSpec represents the configuration for the Service object. Exactly one of its members (other than Generation) must be specified. Services can either track the latest ready revision of a configuration or be pinned to a specific revision.
func (*ServiceSpec) DeepCopy ¶
func (in *ServiceSpec) DeepCopy() *ServiceSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceSpec.
func (*ServiceSpec) DeepCopyInto ¶
func (in *ServiceSpec) DeepCopyInto(out *ServiceSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ServiceSpec) SetDefaults ¶
func (ss *ServiceSpec) SetDefaults()
func (*ServiceSpec) Validate ¶
func (ss *ServiceSpec) Validate() *apis.FieldError
Validate validates the fields belonging to ServiceSpec recursively
type ServiceStatus ¶
type ServiceStatus struct { // +optional Conditions duckv1alpha1.Conditions `json:"conditions,omitempty"` // From RouteStatus. // Domain holds the top-level domain that will distribute traffic over the provided targets. // It generally has the form {route-name}.{route-namespace}.{cluster-level-suffix} // +optional Domain string `json:"domain,omitempty"` // From RouteStatus. // DomainInternal holds the top-level domain that will distribute traffic over the provided // targets from inside the cluster. It generally has the form // {route-name}.{route-namespace}.svc.cluster.local // DEPRECATED: Use Address instead. // +optional DomainInternal string `json:"domainInternal,omitempty"` // Address holds the information needed for a Route to be the target of an event. // +optional Address *duckv1alpha1.Addressable `json:"address,omitempty"` // From RouteStatus. // Traffic holds the configured traffic distribution. // These entries will always contain RevisionName references. // When ConfigurationName appears in the spec, this will hold the // LatestReadyRevisionName that we last observed. // +optional Traffic []TrafficTarget `json:"traffic,omitempty"` // From ConfigurationStatus. // LatestReadyRevisionName holds the name of the latest Revision stamped out // from this Service's Configuration that has had its "Ready" condition become "True". // +optional LatestReadyRevisionName string `json:"latestReadyRevisionName,omitempty"` // From ConfigurationStatus. // LatestCreatedRevisionName is the last revision that was created from this Service's // Configuration. It might not be ready yet, for that use LatestReadyRevisionName. // +optional LatestCreatedRevisionName string `json:"latestCreatedRevisionName,omitempty"` // ObservedGeneration is the 'Generation' of the Service that // was last processed by the controller. // +optional ObservedGeneration int64 `json:"observedGeneration,omitempty"` }
func (*ServiceStatus) DeepCopy ¶
func (in *ServiceStatus) DeepCopy() *ServiceStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ServiceStatus.
func (*ServiceStatus) DeepCopyInto ¶
func (in *ServiceStatus) DeepCopyInto(out *ServiceStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ServiceStatus) GetCondition ¶
func (ss *ServiceStatus) GetCondition(t duckv1alpha1.ConditionType) *duckv1alpha1.Condition
func (*ServiceStatus) GetConditions ¶ added in v0.2.0
func (ss *ServiceStatus) GetConditions() duckv1alpha1.Conditions
GetConditions returns the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
func (*ServiceStatus) InitializeConditions ¶
func (ss *ServiceStatus) InitializeConditions()
func (*ServiceStatus) IsReady ¶
func (ss *ServiceStatus) IsReady() bool
func (*ServiceStatus) PropagateConfigurationStatus ¶
func (ss *ServiceStatus) PropagateConfigurationStatus(cs ConfigurationStatus)
func (*ServiceStatus) PropagateRouteStatus ¶
func (ss *ServiceStatus) PropagateRouteStatus(rs RouteStatus)
func (*ServiceStatus) SetConditions ¶ added in v0.2.0
func (ss *ServiceStatus) SetConditions(conditions duckv1alpha1.Conditions)
SetConditions sets the Conditions array. This enables generic handling of conditions by implementing the duckv1alpha1.Conditions interface.
func (*ServiceStatus) SetManualStatus ¶ added in v0.2.0
func (ss *ServiceStatus) SetManualStatus()
SetManualStatus updates the service conditions to unknown as the underlying Route can have TrafficTargets to Configurations not owned by the service. We do not want to falsely report Ready.
type TrafficTarget ¶
type TrafficTarget struct { // Name is optionally used to expose a dedicated hostname for referencing this // target exclusively. It has the form: {name}.${route.status.domain} // +optional Name string `json:"name,omitempty"` // RevisionName of a specific revision to which to send this portion of traffic. // This is mutually exclusive with ConfigurationName. // +optional RevisionName string `json:"revisionName,omitempty"` // ConfigurationName of a configuration to whose latest revision we will send // this portion of traffic. When the "status.latestReadyRevisionName" of the // referenced configuration changes, we will automatically migrate traffic // from the prior "latest ready" revision to the new one. // This field is never set in Route's status, only its spec. // This is mutually exclusive with RevisionName. // +optional ConfigurationName string `json:"configurationName,omitempty"` // Percent specifies percent of the traffic to this Revision or Configuration. // This defaults to zero if unspecified. Percent int `json:"percent"` }
TrafficTarget holds a single entry of the routing table for a Route.
func (*TrafficTarget) DeepCopy ¶
func (in *TrafficTarget) DeepCopy() *TrafficTarget
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new TrafficTarget.
func (*TrafficTarget) DeepCopyInto ¶
func (in *TrafficTarget) DeepCopyInto(out *TrafficTarget)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*TrafficTarget) Validate ¶
func (tt *TrafficTarget) Validate() *apis.FieldError
Source Files ¶
- build_compat.go
- configuration_defaults.go
- configuration_types.go
- configuration_validation.go
- doc.go
- metadata_validation.go
- register.go
- revision_defaults.go
- revision_types.go
- revision_validation.go
- route_defaults.go
- route_types.go
- route_validation.go
- service_defaults.go
- service_types.go
- service_validation.go
- zz_generated.deepcopy.go