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.