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, original *Channel) *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) GetTopLevelCondition() *apis.Condition
- func (cs *ChannelStatus) InitializeConditions()
- func (cs *ChannelStatus) IsReady() bool
- func (cs *ChannelStatus) MarkTopicFailed(reason, messageFormat string, messageA ...interface{})
- func (cs *ChannelStatus) MarkTopicNotConfigured()
- func (cs *ChannelStatus) MarkTopicNotOwned(messageFormat string, messageA ...interface{})
- func (cs *ChannelStatus) MarkTopicReady()
- func (cs *ChannelStatus) MarkTopicUnknown(reason, messageFormat string, messageA ...interface{})
- func (cs *ChannelStatus) PropagateTopicStatus(ts *v1alpha1.TopicStatus)
- func (cs *ChannelStatus) 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" )
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) GetTopLevelCondition ¶ added in v0.12.0
func (cs *ChannelStatus) GetTopLevelCondition() *apis.Condition
GetTopLevelCondition returns the top level condition.
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) MarkTopicFailed ¶ added in v0.12.0
func (cs *ChannelStatus) MarkTopicFailed(reason, messageFormat string, messageA ...interface{})
MarkTopicFailed 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) MarkTopicNotConfigured ¶ added in v0.12.0
func (cs *ChannelStatus) MarkTopicNotConfigured()
func (*ChannelStatus) MarkTopicNotOwned ¶
func (cs *ChannelStatus) MarkTopicNotOwned(messageFormat string, messageA ...interface{})
func (*ChannelStatus) MarkTopicReady ¶
func (cs *ChannelStatus) MarkTopicReady()
MarkTopicReady sets the condition that the topic has been created and ready.
func (*ChannelStatus) MarkTopicUnknown ¶ added in v0.12.0
func (cs *ChannelStatus) MarkTopicUnknown(reason, messageFormat string, messageA ...interface{})
func (*ChannelStatus) PropagateTopicStatus ¶ added in v0.12.0
func (cs *ChannelStatus) PropagateTopicStatus(ts *v1alpha1.TopicStatus)
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.