Documentation
¶
Overview ¶
Package v1alpha1 contains API Schema definitions for the eventing v1alpha1 API group +k8s:openapi-gen=true +k8s:deepcopy-gen=package,register +k8s:conversion-gen=github.com/google/knative-gcp/pkg/apis/messaging +k8s:defaulter-gen=TypeMeta +groupName=messaging.cloud.google.com
Index ¶
- Constants
- Variables
- func Kind(kind string) schema.GroupKind
- func Resource(resource string) schema.GroupResource
- type Channel
- func (current *Channel) CheckImmutableFields(ctx context.Context, og apis.Immutable) *apis.FieldError
- func (in *Channel) DeepCopy() *Channel
- func (in *Channel) DeepCopyInto(out *Channel)
- func (in *Channel) DeepCopyObject() runtime.Object
- func (c *Channel) GetGroupVersionKind() schema.GroupVersionKind
- func (c *Channel) SetDefaults(ctx context.Context)
- func (c *Channel) Validate(ctx context.Context) *apis.FieldError
- type ChannelList
- type ChannelSpec
- type ChannelStatus
- func (in *ChannelStatus) DeepCopy() *ChannelStatus
- func (in *ChannelStatus) DeepCopyInto(out *ChannelStatus)
- func (cs *ChannelStatus) GetCondition(t apis.ConditionType) *apis.Condition
- func (cs *ChannelStatus) InitializeConditions()
- func (cs *ChannelStatus) IsReady() bool
- func (cs *ChannelStatus) MarkNoTopic(reason, messageFormat string, messageA ...interface{})
- func (cs *ChannelStatus) MarkTopicNotOwned(messageFormat string, messageA ...interface{})
- func (cs *ChannelStatus) MarkTopicOperating(reason, messageFormat string, messageA ...interface{})
- func (cs *ChannelStatus) MarkTopicReady()
- func (cs *ChannelStatus) SetAddress(url *apis.URL)
- type Decorator
- func (in *Decorator) DeepCopy() *Decorator
- func (in *Decorator) DeepCopyInto(out *Decorator)
- func (in *Decorator) DeepCopyObject() runtime.Object
- func (d *Decorator) GetGroupVersionKind() schema.GroupVersionKind
- func (c *Decorator) SetDefaults(ctx context.Context)
- func (d *Decorator) Validate(ctx context.Context) *apis.FieldError
- type DecoratorList
- type DecoratorSpec
- type DecoratorStatus
- func (in *DecoratorStatus) DeepCopy() *DecoratorStatus
- func (in *DecoratorStatus) DeepCopyInto(out *DecoratorStatus)
- func (ds *DecoratorStatus) GetCondition(t apis.ConditionType) *apis.Condition
- func (ds *DecoratorStatus) InitializeConditions()
- func (ds *DecoratorStatus) IsReady() bool
- func (ds *DecoratorStatus) MarkNoService(reason, messageFormat string, messageA ...interface{})
- func (ds *DecoratorStatus) MarkNoSink(reason, messageFormat string, messageA ...interface{})
- func (ds *DecoratorStatus) MarkServiceNotOwned(messageFormat string, messageA ...interface{})
- func (ds *DecoratorStatus) MarkServiceOperating(reason, messageFormat string, messageA ...interface{})
- func (ds *DecoratorStatus) MarkServiceReady()
- func (ds *DecoratorStatus) MarkSink(sink string)
- func (ds *DecoratorStatus) PropagateServiceStatus(ready *apis.Condition)
- func (ds *DecoratorStatus) SetAddress(url *apis.URL)
Constants ¶
const ( // ChannelConditionReady has status True when all subconditions below have // been set to True. ChannelConditionReady = apis.ConditionReady // ChannelConditionAddressable has status true when this Channel meets the // Addressable contract and has a non-empty url. ChannelConditionAddressable apis.ConditionType = "Addressable" // ChannelConditionTopicReady has status True when the Channel has had a // Pub/Sub topic created for it. ChannelConditionTopicReady apis.ConditionType = "TopicReady" )
const ( // DecoratorConditionReady has status True when all sub-conditions below have // been set to True. DecoratorConditionReady = apis.ConditionReady // DecoratorConditionAddressable has status true when this Decorator meets the // Addressable contract and has a non-empty url. DecoratorConditionAddressable apis.ConditionType = "Addressable" // DecoratorConditionServiceReady has status True when the Decorator has had a // Pub/Sub topic created for it. DecoratorConditionServiceReady apis.ConditionType = "ServiceReady" // DecoratorConditionSinkProvided has status True when the Decorator // has been configured with a sink target. DecoratorConditionSinkProvided apis.ConditionType = "SinkProvided" )
Variables ¶
var ( SchemeBuilder = runtime.NewSchemeBuilder(addKnownTypes) AddToScheme = SchemeBuilder.AddToScheme )
var SchemeGroupVersion = schema.GroupVersion{Group: messaging.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
Types ¶
type Channel ¶
type Channel struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ObjectMeta `json:"metadata,omitempty"`
// Spec defines the desired state of the Channel.
Spec ChannelSpec `json:"spec,omitempty"`
// Status represents the current state of the Channel. This data may be out of
// date.
// +optional
Status ChannelStatus `json:"status,omitempty"`
}
Channel is a resource representing an channel backed by Google Cloud Pub/Sub.
func (*Channel) CheckImmutableFields ¶
func (*Channel) DeepCopy ¶
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Channel.
func (*Channel) DeepCopyInto ¶
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*Channel) DeepCopyObject ¶
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (*Channel) GetGroupVersionKind ¶
func (c *Channel) GetGroupVersionKind() schema.GroupVersionKind
GetGroupVersionKind returns GroupVersionKind for Pub/Sub backed Channel.
func (*Channel) SetDefaults ¶
type ChannelList ¶
type ChannelList struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ListMeta `json:"metadata,omitempty"`
Items []Channel `json:"items"`
}
ChannelList is a collection of Pub/Sub backed Channels.
func (*ChannelList) DeepCopy ¶
func (in *ChannelList) DeepCopy() *ChannelList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ChannelList.
func (*ChannelList) DeepCopyInto ¶
func (in *ChannelList) DeepCopyInto(out *ChannelList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ChannelList) DeepCopyObject ¶
func (in *ChannelList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type ChannelSpec ¶
type ChannelSpec struct {
// Secret is the credential to use to create, publish, and poll the Pub/Sub
// Topic and Subscriptions. The value of the secret entry must be a
// service account key in the JSON format
// (see https://cloud.google.com/iam/docs/creating-managing-service-account-keys).
// +optional
Secret *corev1.SecretKeySelector `json:"secret,omitempty"`
// Project is the ID of the Google Cloud Project that the Pub/Sub
// Topic and Subscriptions will be created in.
// +optional
Project string `json:"project,omitempty"`
// Channel conforms to Duck type Subscribable.
// +optional
Subscribable *eventingduck.Subscribable `json:"subscribable,omitempty"`
}
ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. arguments for a Channel.
func (*ChannelSpec) DeepCopy ¶
func (in *ChannelSpec) DeepCopy() *ChannelSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ChannelSpec.
func (*ChannelSpec) DeepCopyInto ¶
func (in *ChannelSpec) DeepCopyInto(out *ChannelSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ChannelSpec) SetDefaults ¶
func (cs *ChannelSpec) SetDefaults(ctx context.Context)
func (*ChannelSpec) Validate ¶
func (cs *ChannelSpec) Validate(ctx context.Context) *apis.FieldError
type ChannelStatus ¶
type ChannelStatus struct {
// inherits duck/v1beta1 Status, which currently provides:
// * ObservedGeneration - the 'Generation' of the Service that was last processed by the controller.
// * Conditions - the latest available observations of a resource's current state.
duckv1.Status `json:",inline"`
// Channel is Addressable. It currently exposes the endpoint as a
// fully-qualified DNS name which will distribute traffic over the
// provided targets from inside the cluster.
//
// It generally has the form {channel}.{namespace}.svc.{cluster domain name}
duckv1.AddressStatus `json:",inline"`
// SubscribableTypeStatus is populated with the statuses of each of the Channelable's subscribers.
eventingduck.SubscribableTypeStatus `json:",inline"`
// ProjectID is the resolved project ID in use by the Channel.
// +optional
ProjectID string `json:"projectId,omitempty"`
// TopicID is the created topic ID used by the Channel.
// +optional
TopicID string `json:"topicId,omitempty"`
}
ChannelStatus represents the current state of a Channel.
func (*ChannelStatus) DeepCopy ¶
func (in *ChannelStatus) DeepCopy() *ChannelStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new ChannelStatus.
func (*ChannelStatus) DeepCopyInto ¶
func (in *ChannelStatus) DeepCopyInto(out *ChannelStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*ChannelStatus) GetCondition ¶
func (cs *ChannelStatus) GetCondition(t apis.ConditionType) *apis.Condition
GetCondition returns the condition currently associated with the given type, or nil.
func (*ChannelStatus) InitializeConditions ¶
func (cs *ChannelStatus) InitializeConditions()
InitializeConditions sets relevant unset conditions to Unknown state.
func (*ChannelStatus) IsReady ¶
func (cs *ChannelStatus) IsReady() bool
IsReady returns true if the resource is ready overall.
func (*ChannelStatus) MarkNoTopic ¶
func (cs *ChannelStatus) MarkNoTopic(reason, messageFormat string, messageA ...interface{})
MarkNoTopic sets the condition that signals there is not a topic for this Channel. This could be because of an error or the Channel is being deleted.
func (*ChannelStatus) MarkTopicNotOwned ¶
func (cs *ChannelStatus) MarkTopicNotOwned(messageFormat string, messageA ...interface{})
func (*ChannelStatus) MarkTopicOperating ¶
func (cs *ChannelStatus) MarkTopicOperating(reason, messageFormat string, messageA ...interface{})
MarkTopicOperating sets the condition that the topic is being created.
func (*ChannelStatus) MarkTopicReady ¶
func (cs *ChannelStatus) MarkTopicReady()
MarkTopicReady sets the condition that the topic has been created and ready.
func (*ChannelStatus) SetAddress ¶
func (cs *ChannelStatus) SetAddress(url *apis.URL)
SetAddress updates the Addressable status of the channel and propagates a url status to the Addressable status condition based on url.
type Decorator ¶ added in v0.8.1
type Decorator struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ObjectMeta `json:"metadata,omitempty"`
// Spec defines the desired state of the Decorator.
Spec DecoratorSpec `json:"spec,omitempty"`
// Status represents the current state of the Decorator. This data may be out of
// date.
// +optional
Status DecoratorStatus `json:"status,omitempty"`
}
Decorator represents an addressable resource that augments an event passed through the decorator to the sink.
func (*Decorator) DeepCopy ¶ added in v0.8.1
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new Decorator.
func (*Decorator) DeepCopyInto ¶ added in v0.8.1
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*Decorator) DeepCopyObject ¶ added in v0.8.1
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
func (*Decorator) GetGroupVersionKind ¶ added in v0.8.1
func (d *Decorator) GetGroupVersionKind() schema.GroupVersionKind
GetGroupVersionKind returns GroupVersionKind for Decorators.
func (*Decorator) SetDefaults ¶ added in v0.8.1
type DecoratorList ¶ added in v0.8.1
type DecoratorList struct {
metav1.TypeMeta `json:",inline"`
// +optional
metav1.ListMeta `json:"metadata,omitempty"`
Items []Decorator `json:"items"`
}
DecoratorlList is a collection of Decorators.
func (*DecoratorList) DeepCopy ¶ added in v0.8.1
func (in *DecoratorList) DeepCopy() *DecoratorList
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DecoratorList.
func (*DecoratorList) DeepCopyInto ¶ added in v0.8.1
func (in *DecoratorList) DeepCopyInto(out *DecoratorList)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*DecoratorList) DeepCopyObject ¶ added in v0.8.1
func (in *DecoratorList) DeepCopyObject() runtime.Object
DeepCopyObject is an autogenerated deepcopy function, copying the receiver, creating a new runtime.Object.
type DecoratorSpec ¶ added in v0.8.1
type DecoratorSpec struct {
// This brings in CloudEventOverrides and Sink.
duckv1.SourceSpec `json:",inline"`
}
DecoratorSpec
func (*DecoratorSpec) DeepCopy ¶ added in v0.8.1
func (in *DecoratorSpec) DeepCopy() *DecoratorSpec
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DecoratorSpec.
func (*DecoratorSpec) DeepCopyInto ¶ added in v0.8.1
func (in *DecoratorSpec) DeepCopyInto(out *DecoratorSpec)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*DecoratorSpec) SetDefaults ¶ added in v0.8.1
func (cs *DecoratorSpec) SetDefaults(ctx context.Context)
func (*DecoratorSpec) Validate ¶ added in v0.8.1
func (ds *DecoratorSpec) Validate(ctx context.Context) *apis.FieldError
type DecoratorStatus ¶ added in v0.8.1
type DecoratorStatus struct {
// inherits duck/v1beta1 Status, which currently provides:
// * ObservedGeneration - the 'Generation' of the Service that was last processed by the controller.
// * Conditions - the latest available observations of a resource's current state.
duckv1.Status `json:",inline"`
// Channel is Addressable. It currently exposes the endpoint as a
// fully-qualified DNS name which will distribute traffic over the
// provided targets from inside the cluster.
//
// It generally has the form {channel}.{namespace}.svc.{cluster domain name}
duckv1.AddressStatus `json:",inline"`
// SinkURI is the current active sink URI that has been configured for the
// Decorator.
// +optional
SinkURI string `json:"sinkUri,omitempty"`
}
DecoratorStatus represents the current state of a Decorator.
func (*DecoratorStatus) DeepCopy ¶ added in v0.8.1
func (in *DecoratorStatus) DeepCopy() *DecoratorStatus
DeepCopy is an autogenerated deepcopy function, copying the receiver, creating a new DecoratorStatus.
func (*DecoratorStatus) DeepCopyInto ¶ added in v0.8.1
func (in *DecoratorStatus) DeepCopyInto(out *DecoratorStatus)
DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil.
func (*DecoratorStatus) GetCondition ¶ added in v0.8.1
func (ds *DecoratorStatus) GetCondition(t apis.ConditionType) *apis.Condition
GetCondition returns the condition currently associated with the given type, or nil.
func (*DecoratorStatus) InitializeConditions ¶ added in v0.8.1
func (ds *DecoratorStatus) InitializeConditions()
InitializeConditions sets relevant unset conditions to Unknown state.
func (*DecoratorStatus) IsReady ¶ added in v0.8.1
func (ds *DecoratorStatus) IsReady() bool
IsReady returns true if the resource is ready overall.
func (*DecoratorStatus) MarkNoService ¶ added in v0.8.1
func (ds *DecoratorStatus) MarkNoService(reason, messageFormat string, messageA ...interface{})
MarkNoService sets the condition that signals there is not a service for this Decorator. This could be because of an error or the Decorator is being deleted.
func (*DecoratorStatus) MarkNoSink ¶ added in v0.8.1
func (ds *DecoratorStatus) MarkNoSink(reason, messageFormat string, messageA ...interface{})
MarkNoSink sets the condition that the source does not have a sink configured.
func (*DecoratorStatus) MarkServiceNotOwned ¶ added in v0.8.1
func (ds *DecoratorStatus) MarkServiceNotOwned(messageFormat string, messageA ...interface{})
MarkServiceNotOwned sets the condition that signals there is an existing service that conflicts with the expected service name for this decorator.
func (*DecoratorStatus) MarkServiceOperating ¶ added in v0.8.1
func (ds *DecoratorStatus) MarkServiceOperating(reason, messageFormat string, messageA ...interface{})
MarkServiceOperating sets the condition that the serivce is being created.
func (*DecoratorStatus) MarkServiceReady ¶ added in v0.8.1
func (ds *DecoratorStatus) MarkServiceReady()
MarkServiceReady sets the condition that the service has been created and ready.
func (*DecoratorStatus) MarkSink ¶ added in v0.8.1
func (ds *DecoratorStatus) MarkSink(sink string)
MarkSink sets the condition that the source has a sink configured.
func (*DecoratorStatus) PropagateServiceStatus ¶ added in v0.8.1
func (ds *DecoratorStatus) PropagateServiceStatus(ready *apis.Condition)
func (*DecoratorStatus) SetAddress ¶ added in v0.8.1
func (ds *DecoratorStatus) SetAddress(url *apis.URL)
SetAddress updates the Addressable status of the Decorator and propagates a url status to the Addressable status condition based on url.