From 04129357775a99ec45d6b02946d89145f2e7377f Mon Sep 17 00:00:00 2001 From: Ellen Evans Date: Tue, 3 Mar 2020 14:17:41 -0800 Subject: [PATCH 1/3] Updated docs for eventing 0.13.0 --- docs/reference/eventing/eventing-contrib.md | 517 +- docs/reference/eventing/eventing.md | 8387 ++++++++++++++----- 2 files changed, 6475 insertions(+), 2429 deletions(-) diff --git a/docs/reference/eventing/eventing-contrib.md b/docs/reference/eventing/eventing-contrib.md index c38bc838873..a112a8e3b51 100644 --- a/docs/reference/eventing/eventing-contrib.md +++ b/docs/reference/eventing/eventing-contrib.md @@ -1,31 +1,29 @@

Packages:

-

sources.eventing.knative.dev/v1alpha1

+

sources.knative.dev/v1alpha1

Package v1alpha1 contains API Schema definitions for the sources v1alpha1 API group

Resource Types: -

AwsSqsSource +

AwsSqsSource

AwsSqsSource is the Schema for the AWS SQS API

@@ -44,7 +42,7 @@ Resource Types: string -sources.eventing.knative.dev/v1alpha1 +sources.knative.dev/v1alpha1 @@ -73,7 +71,7 @@ Refer to the Kubernetes API documentation for the fields of the spec
- + AwsSqsSourceSpec @@ -140,7 +138,7 @@ run the Receive Adapter Deployment.

status
- + AwsSqsSourceStatus @@ -150,7 +148,7 @@ AwsSqsSourceStatus -

CamelSource +

CamelSource

CamelSource is the Schema for the camelsources API

@@ -169,7 +167,7 @@ AwsSqsSourceStatus string -sources.eventing.knative.dev/v1alpha1 +sources.knative.dev/v1alpha1 @@ -198,7 +196,7 @@ Refer to the Kubernetes API documentation for the fields of the spec
- + CamelSourceSpec @@ -211,7 +209,7 @@ CamelSourceSpec source
- + CamelSourceOriginSpec @@ -252,7 +250,7 @@ modifications of the event sent to the sink.

status
- + CamelSourceStatus @@ -262,7 +260,7 @@ CamelSourceStatus -

CouchDbSource +

CouchDbSource

CouchDbSource is the Schema for the githubsources API

@@ -281,7 +279,7 @@ CamelSourceStatus string -sources.eventing.knative.dev/v1alpha1 +sources.knative.dev/v1alpha1 @@ -310,7 +308,7 @@ Refer to the Kubernetes API documentation for the fields of the spec
- + CouchDbSourceSpec @@ -352,7 +350,7 @@ Must be a secret. Only Name and Namespace are used.

feed
- + FeedType @@ -392,7 +390,7 @@ knative.dev/pkg/apis/duck/v1beta1.Destination status
- + CouchDbSourceStatus @@ -402,7 +400,7 @@ CouchDbSourceStatus -

GitHubSource +

GitHubSource

GitHubSource is the Schema for the githubsources API

@@ -421,7 +419,7 @@ CouchDbSourceStatus string -sources.eventing.knative.dev/v1alpha1 +sources.knative.dev/v1alpha1 @@ -450,7 +448,7 @@ Refer to the Kubernetes API documentation for the fields of the spec
- + GitHubSourceSpec @@ -508,7 +506,7 @@ correspond to the “Webhook event name” values listed at accessToken
- + SecretValueFromSource @@ -522,7 +520,7 @@ access token

secretToken
- + SecretValueFromSource @@ -576,7 +574,7 @@ bool status
- + GitHubSourceStatus @@ -586,163 +584,7 @@ GitHubSourceStatus -

KafkaSource -

-

-

KafkaSource is the Schema for the kafkasources API.

-

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
FieldDescription
-apiVersion
-string		 - -sources.eventing.knative.dev/v1alpha1 - -
-kind
-string -		KafkaSource
-metadata
- - -Kubernetes meta/v1.ObjectMeta - - -		 -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
-spec
- - -KafkaSourceSpec - - -		 -
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-bootstrapServers
- -string - -		 -

Bootstrap servers are the Kafka servers the consumer will connect to.

-
-topics
- -string - -		 -

Topic topics to consume messages from

-
-consumerGroup
- -string - -		 -

ConsumerGroupID is the consumer group ID.

-
-net
- - -KafkaSourceNetSpec - - -		 -
-sink
- -knative.dev/pkg/apis/duck/v1beta1.Destination - -		 -(Optional) -

Sink is a reference to an object that will resolve to a domain name to use as the sink.

-
-serviceAccountName
- -string - -		 -

ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive -Adapter Deployment.

-
-resources
- - -KafkaResourceSpec - - -		 -

Resource limits and Request specifications of the Receive Adapter Deployment

-
-
-status
- - -KafkaSourceStatus - - -		 -
-

PrometheusSource +

PrometheusSource

PrometheusSource is the Schema for the prometheussources API

@@ -761,7 +603,7 @@ KafkaSourceStatus string -sources.eventing.knative.dev/v1alpha1 +sources.knative.dev/v1alpha1 @@ -790,7 +632,7 @@ Refer to the Kubernetes API documentation for the fields of the spec
- + PrometheusSourceSpec @@ -905,7 +747,7 @@ name to use as the sink.

status
- + PrometheusSourceStatus @@ -915,11 +757,11 @@ PrometheusSourceStatus -

AwsSqsSourceSpec +

AwsSqsSourceSpec

(Appears on: -AwsSqsSource) +AwsSqsSource)

AwsSqsSourceSpec defines the desired state of the source.

@@ -985,11 +827,11 @@ run the Receive Adapter Deployment.

-

AwsSqsSourceStatus +

AwsSqsSourceStatus

(Appears on: -AwsSqsSource) +AwsSqsSource)

AwsSqsSourceStatus defines the observed state of the source.

@@ -1004,39 +846,31 @@ run the Receive Adapter Deployment.

-Status
+SourceStatus
-knative.dev/pkg/apis/duck/v1alpha1.Status +knative.dev/pkg/apis/duck/v1.SourceStatus

-(Members of Status are embedded into this type.) +(Members of SourceStatus are embedded into this type.)

-

inherits duck/v1alpha1 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.

- - - - -sinkUri
- -string - - - -(Optional) -

SinkURI is the current active sink URI that has been configured for the source.

+

inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.

-

CamelSourceOriginSpec +

CamelSourceOriginSpec

(Appears on: -CamelSourceSpec) +CamelSourceSpec)

CamelSourceOriginSpec is the integration flow to run

@@ -1053,7 +887,7 @@ string integration
-github.com/apache/camel-k/pkg/apis/camel/v1alpha1.IntegrationSpec +github.com/apache/camel-k/pkg/apis/camel/v1.IntegrationSpec @@ -1064,7 +898,7 @@ github.com/apache/camel-k/pkg/apis/camel/v1alpha1.IntegrationSpec flow
- + Flow @@ -1075,11 +909,11 @@ Flow -

CamelSourceSpec +

CamelSourceSpec

(Appears on: -CamelSource) +CamelSource)

CamelSourceSpec defines the desired state of CamelSource

@@ -1096,7 +930,7 @@ Flow source
- + CamelSourceOriginSpec @@ -1132,11 +966,11 @@ modifications of the event sent to the sink.

-

CamelSourceStatus +

CamelSourceStatus

(Appears on: -CamelSource) +CamelSource)

CamelSourceStatus defines the observed state of CamelSource

@@ -1179,11 +1013,11 @@ string -

CouchDbSourceSpec +

CouchDbSourceSpec

(Appears on: -CouchDbSource) +CouchDbSource)

CouchDbSourceSpec defines the desired state of CouchDbSource

@@ -1229,7 +1063,7 @@ Must be a secret. Only Name and Namespace are used.

feed
- + FeedType @@ -1264,11 +1098,11 @@ knative.dev/pkg/apis/duck/v1beta1.Destination -

CouchDbSourceStatus +

CouchDbSourceStatus

(Appears on: -CouchDbSource) +CouchDbSource)

CouchDbSourceStatus defines the observed state of CouchDbSource

@@ -1312,29 +1146,29 @@ for the CouchDbSource.

-

FeedType +

FeedType (string alias)

(Appears on: -CouchDbSourceSpec) +CouchDbSourceSpec)

FeedType is the type of Feed

-

Flow +

Flow (map[string]interface{} alias)

(Appears on: -CamelSourceOriginSpec) +CamelSourceOriginSpec)

Flow is an unstructured object representing a Camel Flow in YAML/JSON DSL

-

GitHubSourceSpec +

GitHubSourceSpec

(Appears on: -GitHubSource) +GitHubSource)

GitHubSourceSpec defines the desired state of GitHubSource

@@ -1396,7 +1230,7 @@ correspond to the “Webhook event name” values listed at accessToken
- + SecretValueFromSource @@ -1410,7 +1244,7 @@ access token

secretToken
- + SecretValueFromSource @@ -1459,11 +1293,11 @@ bool -

GitHubSourceStatus +

GitHubSourceStatus

(Appears on: -GitHubSource) +GitHubSource)

GitHubSourceStatus defines the observed state of GitHubSource

@@ -1518,11 +1352,11 @@ for the GitHubSource.

-

KafkaLimitsSpec +

KafkaLimitsSpec

(Appears on: -KafkaResourceSpec) +KafkaResourceSpec)

@@ -1556,11 +1390,11 @@ string -

KafkaRequestsSpec +

KafkaRequestsSpec

(Appears on: -KafkaResourceSpec) +KafkaResourceSpec)

@@ -1594,11 +1428,11 @@ string -

KafkaResourceSpec +

KafkaResourceSpec

(Appears on: -KafkaSourceSpec) +KafkaSourceSpec)

@@ -1614,7 +1448,7 @@ string requests
- + KafkaRequestsSpec @@ -1626,7 +1460,7 @@ KafkaRequestsSpec limits
- + KafkaLimitsSpec @@ -1636,11 +1470,150 @@ KafkaLimitsSpec -

KafkaSourceNetSpec +

KafkaSource +

+

+

KafkaSource is the Schema for the kafkasources API.

+

+ + + + + + + + + + + + + + + + + + + + + +
FieldDescription
+metadata
+ + +Kubernetes meta/v1.ObjectMeta + + +		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
+spec
+ + +KafkaSourceSpec + + +		 +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+bootstrapServers
+ +string + +		 +

Bootstrap servers are the Kafka servers the consumer will connect to.

+
+topics
+ +string + +		 +

Topic topics to consume messages from

+
+consumerGroup
+ +string + +		 +

ConsumerGroupID is the consumer group ID.

+
+net
+ + +KafkaSourceNetSpec + + +		 +
+sink
+ +knative.dev/pkg/apis/duck/v1beta1.Destination + +		 +(Optional) +

Sink is a reference to an object that will resolve to a domain name to use as the sink.

+
+serviceAccountName
+ +string + +		 +

ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive +Adapter Deployment.

+
+resources
+ + +KafkaResourceSpec + + +		 +

Resource limits and Request specifications of the Receive Adapter Deployment

+
+
+status
+ + +KafkaSourceStatus + + +		 +
+

KafkaSourceNetSpec

(Appears on: -KafkaSourceSpec) +KafkaSourceSpec)

@@ -1656,7 +1629,7 @@ KafkaLimitsSpec sasl
- + KafkaSourceSASLSpec @@ -1668,7 +1641,7 @@ KafkaSourceSASLSpec tls
- + KafkaSourceTLSSpec @@ -1678,11 +1651,11 @@ KafkaSourceTLSSpec -

KafkaSourceSASLSpec +

KafkaSourceSASLSpec

(Appears on: -KafkaSourceNetSpec) +KafkaSourceNetSpec)

@@ -1708,7 +1681,7 @@ bool user
- + SecretValueFromSource @@ -1722,7 +1695,7 @@ SecretValueFromSource password
- + SecretValueFromSource @@ -1734,11 +1707,11 @@ SecretValueFromSource -

KafkaSourceSpec +

KafkaSourceSpec

(Appears on: -KafkaSource) +KafkaSource)

KafkaSourceSpec defines the desired state of the KafkaSource.

@@ -1788,7 +1761,7 @@ string net
- + KafkaSourceNetSpec @@ -1824,7 +1797,7 @@ Adapter Deployment.

resources
- + KafkaResourceSpec @@ -1835,11 +1808,11 @@ KafkaResourceSpec -

KafkaSourceStatus +

KafkaSourceStatus

(Appears on: -KafkaSource) +KafkaSource)

KafkaSourceStatus defines the observed state of KafkaSource.

@@ -1882,11 +1855,11 @@ string -

KafkaSourceTLSSpec +

KafkaSourceTLSSpec

(Appears on: -KafkaSourceNetSpec) +KafkaSourceNetSpec)

@@ -1912,7 +1885,7 @@ bool cert
- + SecretValueFromSource @@ -1926,7 +1899,7 @@ SecretValueFromSource key
- + SecretValueFromSource @@ -1940,7 +1913,7 @@ SecretValueFromSource caCert
- + SecretValueFromSource @@ -1952,11 +1925,11 @@ SecretValueFromSource -

PrometheusSourceSpec +

PrometheusSourceSpec

(Appears on: -PrometheusSource) +PrometheusSource)

PrometheusSourceSpec defines the desired state of PrometheusSource

@@ -2070,11 +2043,11 @@ name to use as the sink.

-

PrometheusSourceStatus +

PrometheusSourceStatus

(Appears on: -PrometheusSource) +PrometheusSource)

PrometheusSourceStatus defines the observed state of PrometheusSource

@@ -2118,12 +2091,12 @@ for the PrometheusSource.

-

SecretValueFromSource +

SecretValueFromSource

(Appears on: -KafkaSourceSASLSpec, -KafkaSourceTLSSpec) +KafkaSourceSASLSpec, +KafkaSourceTLSSpec)

SecretValueFromSource represents the source of a secret value

@@ -2151,11 +2124,11 @@ Kubernetes core/v1.SecretKeySelector -

SecretValueFromSource +

SecretValueFromSource

(Appears on: -GitHubSourceSpec) +GitHubSourceSpec)

SecretValueFromSource represents the source of a secret value

@@ -2613,5 +2586,5 @@ knative.dev/eventing/pkg/apis/duck/v1alpha1.SubscribableTypeStatus

Generated with gen-crd-api-reference-docs -on git commit 395598e8. +on git commit a49a7c73.

diff --git a/docs/reference/eventing/eventing.md b/docs/reference/eventing/eventing.md index 44b4e3c2a66..4ff0b9a7520 100644 --- a/docs/reference/eventing/eventing.md +++ b/docs/reference/eventing/eventing.md @@ -1,16 +1,16 @@

Packages:

-

sources.knative.dev/v1alpha1

+

messaging.knative.dev/v1beta1

-

Package v1alpha1 contains API Schema definitions for the sources v1alpha1 API group

+

Package v1beta1 is the v1beta1 version of the API.

Resource Types: -

ApiServerSource +

Channel

-

ApiServerSource is the Schema for the apiserversources API

+

Channel represents a generic Channel. It is normally used when we want a Channel, but don’t need a specific Channel implementation.

@@ -48,7 +68,7 @@ Resource Types: string @@ -57,7 +77,7 @@ sources.knative.dev/v1alpha1 kind
string - + @@ -77,64 +98,44 @@ Refer to the Kubernetes API documentation for the fields of the
-sources.knative.dev/v1alpha1 +messaging.knative.dev/v1beta1
ApiServerSourceChannel
@@ -69,6 +89,7 @@ Kubernetes meta/v1.ObjectMeta +(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
- -ApiServerSourceSpec + +ChannelSpec 		+

Spec defines the desired state of the Channel.



- - - - - - - -
-resources
+channelTemplate
- -[]ApiServerResource + +ChannelTemplateSpec 		-

Resources is the list of resources to watch

-
-serviceAccountName
- -string - -		 -(Optional) -

ServiceAccountName is the name of the ServiceAccount to use to run this -source.

-
-sink
- -knative.dev/pkg/apis/duck/v1beta1.Destination - -		 -(Optional) -

Sink is a reference to an object that will resolve to a domain name to use as the sink.

+

ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.
-mode
+ChannelableSpec
-string + +ChannelableSpec + 		-

Mode is the mode the receive adapter controller runs under: Ref or Resource. -Ref sends only the reference to the resource. -Resource send the full resource.

+

+(Members of ChannelableSpec are embedded into this type.) +

+

Channel conforms to ChannelableSpec
@@ -144,25 +145,23 @@ string 		status
- -ApiServerSourceStatus + +ChannelStatus 		+(Optional) +

Status represents the current state of the Channel. This data may be out of +date.
-

SinkBinding +

InMemoryChannel

-

SinkBinding describes a Binding that is also a Source. -The sink (from the Source duck) is resolved to a URL and -then projected into the subject by augmenting the runtime -contract of the referenced containers to have a K_SINK -environment variable holding the endpoint to which to send -cloud events.

+

InMemoryChannel is a resource representing an in memory channel

@@ -178,7 +177,7 @@ cloud events.

string @@ -187,7 +186,7 @@ sources.knative.dev/v1alpha1 kind
string - + @@ -207,39 +207,30 @@ Refer to the Kubernetes API documentation for the fields of the
-sources.knative.dev/v1alpha1 +messaging.knative.dev/v1beta1
SinkBindingInMemoryChannel
@@ -199,6 +198,7 @@ Kubernetes meta/v1.ObjectMeta +(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
- -SinkBindingSpec + +InMemoryChannelSpec 		+

Spec defines the desired state of the Channel.



- - - -
-SourceSpec
- -knative.dev/pkg/apis/duck/v1.SourceSpec - -		 -

-(Members of SourceSpec are embedded into this type.) -

-
-BindingSpec
+ChannelableSpec
-knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +ChannelableSpec +

-(Members of BindingSpec are embedded into this type.) +(Members of ChannelableSpec are embedded into this type.)

+

Channel conforms to Duck type Channelable.
@@ -249,24 +240,24 @@ knative.dev/pkg/apis/duck/v1alpha1.BindingSpec 		status
- -SinkBindingStatus + +InMemoryChannelStatus 		+(Optional) +

Status represents the current state of the Channel. This data may be out of +date.
-

ApiServerResource +

Subscription

-(Appears on: -ApiServerSourceSpec) -

-

-

ApiServerResource defines the resource to watch

+

Subscription routes events received on a Channel to a DNS name and +corresponds to the subscriptions.channels.knative.dev CRD.

@@ -279,145 +270,147 @@ SinkBindingStatus +string - + - +
+
+
apiVersion
- -string - -		 -

API version of the resource to watch.

+ +messaging.knative.dev/v1beta1 +
kind
- string - -		 -

Kind of the resource to watch. -More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

Subscription
-labelSelector
+metadata
- -Kubernetes meta/v1.LabelSelector + +Kubernetes meta/v1.ObjectMeta 		-

LabelSelector restricts this source to objects with the selected labels -More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

+Refer to the Kubernetes API documentation for the fields of the +metadata field.
-controllerSelector
+spec
- -Kubernetes meta/v1.OwnerReference + +SubscriptionSpec 		-

ControllerSelector restricts this source to objects with a controlling owner reference of the specified kind. -Only apiVersion and kind are used. Both are optional.

-
- -
-controller
+channel
-bool + +Kubernetes core/v1.ObjectReference + 		-

If true, send an event referencing the object controlling the resource

+

Reference to a channel that will be used to create the subscription +You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name +The resource pointed by this ObjectReference must meet the +contract to the ChannelableSpec duck type. If the resource does not +meet this contract it will be reflected in the Subscription’s status.

+

This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)
-

ApiServerSourceSpec -

-

-(Appears on: -ApiServerSource) -

-

-

ApiServerSourceSpec defines the desired state of ApiServerSource

-

- - - - - - - - + +
FieldDescription
-resources
+subscriber
- -[]ApiServerResource - +knative.dev/pkg/apis/duck/v1.Destination 		-

Resources is the list of resources to watch

+(Optional) +

Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.
-serviceAccountName
+reply
-string +knative.dev/pkg/apis/duck/v1.Destination 		(Optional) -

ServiceAccountName is the name of the ServiceAccount to use to run this -source.

+

Reply specifies (optionally) how to handle events returned from +the Subscriber target.
-sink
+delivery
-knative.dev/pkg/apis/duck/v1beta1.Destination + +DeliverySpec + 		(Optional) -

Sink is a reference to an object that will resolve to a domain name to use as the sink.

+

Delivery configuration

+
-mode
+status
-string + +SubscriptionStatus + -

Mode is the mode the receive adapter controller runs under: Ref or Resource. -Ref sends only the reference to the resource. -Resource send the full resource.

-

ApiServerSourceStatus +

ChannelDefaulter +

+

+

ChannelDefaulter sets the default Channel CRD and Arguments on Channels that do not +specify any implementation.

+

+

ChannelSpec

(Appears on: -ApiServerSource) +Channel)

-

ApiServerSourceStatus defines the observed state of ApiServerSource

+

ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. +It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.

@@ -429,42 +422,44 @@ string
-Status
+channelTemplate
-knative.dev/pkg/apis/duck/v1.Status + +ChannelTemplateSpec + 		-

-(Members of Status are embedded into this type.) -

-

inherits duck/v1 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.

+

ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.
-sinkUri
+ChannelableSpec
-string + +ChannelableSpec + 		-(Optional) -

SinkURI is the current active sink URI that has been configured for the ApiServerSource.

+

+(Members of ChannelableSpec are embedded into this type.) +

+

Channel conforms to ChannelableSpec
-

SinkBindingSpec +

ChannelStatus

(Appears on: -SinkBinding) +Channel)

-

SinkBindingSpec holds the desired state of the SinkBinding (from the client).

+

ChannelStatus represents the current state of a Channel.

@@ -476,95 +471,43 @@ string - - - - - -
-SourceSpec
- -knative.dev/pkg/apis/duck/v1.SourceSpec - -		 -

-(Members of SourceSpec are embedded into this type.) -

-
-BindingSpec
+ChannelableStatus
-knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +ChannelableStatus +

-(Members of BindingSpec are embedded into this type.) +(Members of ChannelableStatus are embedded into this type.)

+

Channel conforms to ChannelableStatus
-

SinkBindingStatus -

-

-(Appears on: -SinkBinding) -

-

-

SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

-

- - - - - - - -
FieldDescription
-SourceStatus
+channel
-knative.dev/pkg/apis/duck/v1.SourceStatus +knative.dev/pkg/apis/duck/v1.KReference 		-

-(Members of SourceStatus are embedded into this type.) -

+

Channel is an KReference to the Channel CRD backing this Channel.
-
-

duck.knative.dev/v1alpha1

-

-

Package v1alpha1 is the v1alpha1 version of the API.

-

-Resource Types: - -

BackoffPolicyType -(string alias)

-

-(Appears on: -DeliverySpec) -

-

-

BackoffPolicyType is the type for backoff policies

-

-

ChannelDefaulter -

-

-

ChannelDefaulter sets the default Channel CRD and Arguments on Channels that do not -specify any implementation.

-

-

ChannelTemplateSpec +

ChannelTemplateSpec

(Appears on: BrokerSpec, +ChannelSpec, ChannelSpec, ParallelSpec, -ParallelSpec, -SequenceSpec, +ParallelSpec, +SequenceSpec, SequenceSpec)

@@ -596,7 +539,7 @@ in verbatim to the Channel CRD as Spec section.

-

ChannelTemplateSpecInternal +

ChannelTemplateSpecInternal

ChannelTemplateSpecInternal is an internal only version that includes ObjectMeta so that @@ -644,12 +587,16 @@ in verbatim to the Channel CRD as Spec section.

-

Channelable +

InMemoryChannelSpec

-

Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers -defining compatible resources to embed it. We will typically use this type to deserialize -Channelable ObjectReferences and access their subscription and address data. This is not a real resource.

+(Appears on: +InMemoryChannel) +

+

+

InMemoryChannelSpec defines which subscribers have expressed interest in +receiving events from this InMemoryChannel. +arguments for a Channel.

@@ -661,86 +608,163 @@ Channelable ObjectReferences and access their subscription and address data. Th + +
-metadata
+ChannelableSpec
- -Kubernetes meta/v1.ObjectMeta + +ChannelableSpec 		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +

+(Members of ChannelableSpec are embedded into this type.) +

+

Channel conforms to Duck type Channelable.
+

InMemoryChannelStatus +

+

+(Appears on: +InMemoryChannel) +

+

+

ChannelStatus represents the current state of a Channel.

+

+ + + + + + + + + + +
FieldDescription
-spec
+ChannelableStatus
- -ChannelableSpec + +ChannelableStatus 		-

Spec is the part where the Channelable fulfills the Subscribable contract.

-
-
+

+(Members of ChannelableStatus are embedded into this type.) +

+

Channel conforms to Duck type Channelable.

+
+

SubscriptionSpec +

+

+(Appears on: +Subscription) +

+

+

SubscriptionSpec specifies the Channel for incoming events, a Subscriber target +for processing those events and where to put the result of the processing. Only +From (where the events are coming from) is always required. You can optionally +only Process the events (results in no output events) by leaving out the Result. +You can also perform an identity transformation on the incoming events by leaving +out the Subscriber and only specifying Result.

+

The following are all valid specifications: +channel –[subscriber]–> reply +Sink, no outgoing events: +channel – subscriber +no-op function (identity transformation): +channel –> reply

+

+ + + + + + + -
FieldDescription
-SubscribableTypeSpec
+channel
- -SubscribableTypeSpec + +Kubernetes core/v1.ObjectReference 		-

-(Members of SubscribableTypeSpec are embedded into this type.) -

+

Reference to a channel that will be used to create the subscription +You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name +The resource pointed by this ObjectReference must meet the +contract to the ChannelableSpec duck type. If the resource does not +meet this contract it will be reflected in the Subscription’s status.

+

This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)
-delivery
+subscriber
- -DeliverySpec - +knative.dev/pkg/apis/duck/v1.Destination 		(Optional) -

DeliverySpec contains options controlling the event delivery

+

Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.
+ + +reply
+ +knative.dev/pkg/apis/duck/v1.Destination + + + +(Optional) +

Reply specifies (optionally) how to handle events returned from +the Subscriber target.

-status
+delivery
- -ChannelableStatus + +DeliverySpec +(Optional) +

Delivery configuration

-

ChannelableSpec +

SubscriptionStatus

(Appears on: -Channelable) +Subscription)

-

ChannelableSpec contains Spec of the Channelable object

+

SubscriptionStatus (computed) for a subscription

@@ -752,43 +776,44 @@ ChannelableStatus
-SubscribableTypeSpec
+Status
- -SubscribableTypeSpec - +knative.dev/pkg/apis/duck/v1.Status

-(Members of SubscribableTypeSpec are embedded into this type.) +(Members of Status are embedded into this type.)

+

inherits duck/v1 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.
-delivery
+physicalSubscription
- -DeliverySpec + +SubscriptionStatusPhysicalSubscription 		-(Optional) -

DeliverySpec contains options controlling the event delivery

+

PhysicalSubscription is the fully resolved values that this Subscription represents.
-

ChannelableStatus +

SubscriptionStatusPhysicalSubscription

(Appears on: -Channelable) +SubscriptionStatus)

-

ChannelableStatus contains the Status of a Channelable object.

+

SubscriptionStatusPhysicalSubscription represents the fully resolved values for this +Subscription.

@@ -800,77 +825,52 @@ DeliverySpec - - - -
-Status
+subscriberUri
-knative.dev/pkg/apis/duck/v1.Status +knative.dev/pkg/apis.URL 		-

-(Members of Status are embedded into this type.) -

-

inherits duck/v1 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.

+

SubscriberURI is the fully resolved URI for spec.subscriber.
-AddressStatus
+replyUri
-knative.dev/pkg/apis/duck/v1alpha1.AddressStatus +knative.dev/pkg/apis.URL 		-

-(Members of AddressStatus are embedded into this type.) -

-

AddressStatus is the part where the Channelable fulfills the Addressable contract.

+

ReplyURI is the fully resolved URI for the spec.reply.
-SubscribableTypeStatus
+deadLetterSinkUri
- -SubscribableTypeStatus - +knative.dev/pkg/apis.URL 		-

-(Members of SubscribableTypeStatus are embedded into this type.) -

-

Subscribers is populated with the statuses of each of the Channelable’s subscribers.

-
-errorChannel
- - -Kubernetes core/v1.ObjectReference - - -		 -(Optional) -

ErrorChannel is set by the channel when it supports native error handling via a channel

+

ReplyURI is the fully resolved URI for the spec.delivery.deadLetterSink.
-

DeliverySpec -

+
+

configs.internal.knative.dev/v1alpha1

-(Appears on: -BrokerSpec, -ChannelableSpec, -SubscriptionSpec) +

Package v1alpha1 is the v1alpha1 version of the API.

+Resource Types: + +

ConfigMapPropagation +

-

DeliverySpec contains the delivery options for event senders, -such as channelable and source.

+

ConfigMapPropagation is used to propagate configMaps from original namespace to current namespace

@@ -882,96 +882,102 @@ such as channelable and source.

+ + + + + + + +
-deadLetterSink
- -knative.dev/pkg/apis/duck/v1.Destination - +apiVersion
+string		 + +configs.internal.knative.dev/v1alpha1 +
-(Optional) -

DeadLetterSink is the sink receiving event that couldn’t be sent to -a destination.

+kind
+string 		ConfigMapPropagation
-retry
+metadata
-int32 + +Kubernetes meta/v1.ObjectMeta + 		(Optional) -

Retry is the minimum number of retries the sender should attempt when -sending an event before moving it to the dead letter sink.

+Refer to the Kubernetes API documentation for the fields of the +metadata field.
-backoffPolicy
+spec
- -BackoffPolicyType + +ConfigMapPropagationSpec 		-(Optional) -

BackoffPolicy is the retry backoff policy (linear, exponential)

+

Spec defines the desired state of the ConfigMapPropagation

+
+
+ + + + -
+originalNamespace
+ +string + +		 +

OriginalNamespace is the namespace where the original configMaps are in
-backoffDelay
+selector
-string + +Kubernetes meta/v1.LabelSelector + 		(Optional) -

BackoffDelay is the delay before retrying. -More information on Duration format: https://www.ietf.org/rfc/rfc3339.txt

-

For linear policy, backoff delay is the time interval between retries. -For exponential policy , backoff delay is backoffDelay*2^

+

Selector only selects original configMaps with corresponding labels
-

DeliveryStatus -

-

-

DeliveryStatus contains the Status of an object supporting delivery options.

-

- - - - - + - -
FieldDescription
-deadLetterChannel
+status
- -Kubernetes core/v1.ObjectReference + +ConfigMapPropagationStatus 		(Optional) -

DeadLetterChannel is the reference to the native, platform specific channel -where failed events are sent to.

+

Status represents the current state of the EventType. +This data may be out of date.
-

Resource +

ConfigMapPropagationSpec

-

Resource is a skeleton type wrapping all Kubernetes resources. It is typically used to watch -arbitrary other resources (such as any Source or Addressable). This is not a real resource.

+(Appears on: +ConfigMapPropagation) +

+

@@ -983,31 +989,39 @@ arbitrary other resources (such as any Source or Addressable). This is not a rea + + + +
-metadata
+originalNamespace
- -Kubernetes meta/v1.ObjectMeta +string + +		 +

OriginalNamespace is the namespace where the original configMaps are in

+
+selector
+ + +Kubernetes meta/v1.LabelSelector 		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +(Optional) +

Selector only selects original configMaps with corresponding labels
-

Subscribable +

ConfigMapPropagationStatus

(Appears on: -ChannelSpec, -InMemoryChannelSpec, -SubscribableTypeSpec) +ConfigMapPropagation)

-

Subscribable is the schema for the subscribable portion of the spec -section of the resource.

+

ConfigMapPropagationStatus represents the current state of a ConfigMapPropagation.

@@ -1019,28 +1033,44 @@ section of the resource.

+ + + +
-subscribers
+Status
- -[]SubscriberSpec +knative.dev/pkg/apis/duck/v1.Status + +		 +

+(Members of Status are embedded into this type.) +

+

inherits duck/v1 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.

+
+copyConfigmaps
+ + +[]ConfigMapPropagationStatusCopyConfigMap 		-

This is the list of subscriptions for this subscribable.

+(Optional) +

CopyConfigMaps is the status for each copied configmap.
-

SubscribableStatus +

ConfigMapPropagationStatusCopyConfigMap

(Appears on: -SubscribableTypeStatus) +ConfigMapPropagationStatus)

-

SubscribableStatus is the schema for the subscribable’s status portion of the status -section of the resource.

+

ConfigMapPropagationStatusCopyConfigMap represents the status of a copied configmap

@@ -1052,25 +1082,94 @@ section of the resource.

+ + + + + + + + + + + + + + + + + + + +
-subscribers
+name
- -[]SubscriberStatus - +string 		-

This is the list of subscription’s statuses for this channel.

+

Name is copy configmap’s name

+
+source
+ +string + +		 +

Source is “originalNamespace/originalConfigMapName”

+
+operation
+ +string + +		 +

Operation represents the operation CMP takes for this configmap. The operations are copy|delete|stop

+
+ready
+ +string + +		 +

Ready represents the operation is ready or not

+
+reason
+ +string + +		 +

Reason indicates reasons if the operation is not ready

+
+resourceVersionFromSource
+ +string + +		 +

ResourceVersion is the resourceVersion of original configmap
-

SubscribableType +
+

duck.knative.dev/v1beta1

+

+

Package v1beta1 is the v1beta1 version of the API.

+

+Resource Types: +
    +

    BackoffPolicyType +(string alias)

    +

    +(Appears on: +DeliverySpec) +

    +

    +

    BackoffPolicyType is the type for backoff policies

    +

    +

    Channelable

    -

    SubscribableType is a skeleton type wrapping Subscribable in the manner we expect resource writers +

    Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize -SubscribableType ObjectReferences and access the Subscription data. This is not a real resource.

    +Channelable ObjectReferences and access their subscription and address data. This is not a real resource.

    @@ -1098,27 +1197,43 @@ Refer to the Kubernetes API documentation for the fields of the
    spec
    - -SubscribableTypeSpec + +ChannelableSpec     		-

    SubscribableTypeSpec is the part where Subscribable object is -configured as to be compatible with Subscribable contract.

    +

    Spec is the part where the Channelable fulfills the Subscribable contract.



    + + + +
    -subscribable
    +SubscribableSpec
    - -Subscribable + +SubscribableSpec + + +    		 +

    +(Members of SubscribableSpec are embedded into this type.) +

    +
    +delivery
    + + +DeliverySpec     		+(Optional) +

    DeliverySpec contains options controlling the event delivery
    @@ -1128,27 +1243,26 @@ Subscribable     		status
    - -SubscribableTypeStatus + +ChannelableStatus     		-

    SubscribableTypeStatus is the part where SubscribableStatus object is -configured as to be compatible with Subscribable contract.
    -

    SubscribableTypeSpec +

    ChannelableSpec

    (Appears on: -ChannelableSpec, -SubscribableType) +ChannelSpec, +Channelable, +InMemoryChannelSpec)

    -

    SubscribableTypeSpec shows how we expect folks to embed Subscribable in their Spec field.

    +

    ChannelableSpec contains Spec of the Channelable object

    @@ -1160,64 +1274,45 @@ configured as to be compatible with Subscribable contract.

    - -
    -subscribable
    +SubscribableSpec
    - -Subscribable + +SubscribableSpec     		+

    +(Members of SubscribableSpec are embedded into this type.) +
    -

    SubscribableTypeStatus -

    -

    -(Appears on: -ChannelStatus, -ChannelableStatus, -InMemoryChannelStatus, -SubscribableType) -

    -

    -

    SubscribableTypeStatus shows how we expect folks to embed Subscribable in their Status field.

    -

    - - - - - - - -
    FieldDescription
    -subscribableStatus
    +delivery
    - -SubscribableStatus + +DeliverySpec     		+(Optional) +

    DeliverySpec contains options controlling the event delivery
    -

    SubscriberSpec +

    ChannelableStatus

    (Appears on: -Subscribable) +ChannelStatus, +Channelable, +InMemoryChannelStatus)

    -

    SubscriberSpec defines a single subscriber to a Subscribable. -Ref is a reference to the Subscription this SubscriberSpec was created for -SubscriberURI is the endpoint for the subscriber -ReplyURI is the endpoint for the reply -At least one of SubscriberURI and ReplyURI must be present

    +

    ChannelableStatus contains the Status of a Channelable object.

    @@ -1229,71 +1324,86 @@ At least one of SubscriberURI and ReplyURI must be present

    - - - -
    -uid
    - -k8s.io/apimachinery/pkg/types.UID - -    		 -(Optional) -

    UID is used to understand the origin of the subscriber.

    -
    -generation
    +Status
    -int64 +knative.dev/pkg/apis/duck/v1.Status     		-(Optional) -

    Generation of the origin of the subscriber with uid:UID.

    +

    +(Members of Status are embedded into this type.) +

    +

    inherits duck/v1 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.
    -subscriberURI
    +AddressStatus
    -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1.AddressStatus     		-(Optional) +

    +(Members of AddressStatus are embedded into this type.) +

    +

    AddressStatus is the part where the Channelable fulfills the Addressable contract.
    -replyURI
    +SubscribableStatus
    -knative.dev/pkg/apis.URL + +SubscribableStatus +     		-(Optional) +

    +(Members of SubscribableStatus are embedded into this type.) +

    +

    Subscribers is populated with the statuses of each of the Channelable’s subscribers.
    -deadLetterSink
    +deadLetterChannel
    -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1.KReference     		(Optional) +

    DeadLetterChannel is a KReference and is set by the channel when it supports native error handling via a channel +Failed messages are delivered here.
    -

    SubscriberStatus +

    DeliverySpec

    (Appears on: -SubscribableStatus) +BrokerSpec, +BrokerSpec, +ChannelSpec, +ChannelableCombinedSpec, +ChannelableSpec, +ChannelableSpec, +InMemoryChannelSpec, +SequenceStep, +SequenceStep, +SubscriberSpec, +SubscriberSpec, +SubscriptionSpec, +SubscriptionSpec)

    -

    SubscriberStatus defines the status of a single subscriber to a Channel.

    +

    DeliverySpec contains the delivery options for event senders, +such as channelable and source.

    @@ -1305,77 +1415,65 @@ knative.dev/pkg/apis.URL
    -uid
    +deadLetterSink
    -k8s.io/apimachinery/pkg/types.UID +knative.dev/pkg/apis/duck/v1.Destination     		(Optional) -

    UID is used to understand the origin of the subscriber.

    +

    DeadLetterSink is the sink receiving event that couldn’t be sent to +a destination.
    -observedGeneration
    +retry
    -int64 +int32     		(Optional) -

    Generation of the origin of the subscriber with uid:UID.

    +

    Retry is the minimum number of retries the sender should attempt when +sending an event before moving it to the dead letter sink.
    -ready
    +backoffPolicy
    - -Kubernetes core/v1.ConditionStatus + +BackoffPolicyType     		(Optional) -

    Status of the subscriber.

    +

    BackoffPolicy is the retry backoff policy (linear, exponential)
    -message
    +backoffDelay
    string     		(Optional) -

    A human readable message indicating details of Ready status.

    +

    BackoffDelay is the delay before retrying. +More information on Duration format: https://www.ietf.org/rfc/rfc3339.txt

    +

    For linear policy, backoff delay is the time interval between retries. +For exponential policy , backoff delay is backoffDelay*2^
    -
    -

    eventing.knative.dev/v1alpha1

    -

    -

    Package v1alpha1 is the v1alpha1 version of the API.

    -

    -Resource Types: - -

    Broker +

    DeliveryStatus

    -

    Broker collects a pool of events that are consumable using Triggers. Brokers -provide a well-known endpoint for event delivery that senders can use with -minimal knowledge of the event routing strategy. Receivers use Triggers to -request delivery of events from a Broker’s pool to a specific URL or -Addressable endpoint.

    +

    DeliveryStatus contains the Status of an object supporting delivery options.

    @@ -1387,21 +1485,34 @@ Addressable endpoint.

    +deadLetterChannel
    + +knative.dev/pkg/apis/duck/v1.KReference + + + +
    -apiVersion
    -string    		 - -eventing.knative.dev/v1alpha1 - +(Optional) +

    DeadLetterChannel is a KReference that is the reference to the native, platform specific channel +where failed events are sent to.
    +

    Subscribable +

    +

    +

    Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers +defining compatible resources to embed it. We will typically use this type to deserialize +SubscribableType ObjectReferences and access the Subscription data. This is not a real resource.

    +

    + + - - + + + + @@ -1421,45 +1531,28 @@ Refer to the Kubernetes API documentation for the fields of the
    -kind
    -string -    		BrokerFieldDescription
    metadata
    @@ -1412,7 +1523,6 @@ Kubernetes meta/v1.ObjectMeta     		-(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
    - -BrokerSpec + +SubscribableSpec     		-

    Spec defines the desired state of the Broker.

    +

    SubscribableSpec is the part where Subscribable object is +configured as to be compatible with Subscribable contract.



    - - - -
    -channelTemplateSpec
    - - -ChannelTemplateSpec - - -    		 -(Optional) -

    ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the -Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there -are no defaults for the namespace).

    -
    -delivery
    +subscribers
    - -DeliverySpec + +[]SubscriberSpec     		-(Optional) -

    Delivery is the delivery specification to be used internally by the broker to -create subscriptions.

    +

    This is the list of subscriptions for this subscribable.
    @@ -1469,22 +1562,28 @@ create subscriptions.

    		 status
    - -BrokerStatus + +SubscribableStatus     		-(Optional) -

    Status represents the current state of the Broker. This data may be out of -date.

    +

    SubscribableStatus is the part where SubscribableStatus object is +configured as to be compatible with Subscribable contract.
    -

    EventType +

    SubscribableSpec

    +(Appears on: +ChannelableCombinedSpec, +ChannelableSpec, +Subscribable) +

    +

    +

    SubscribableSpec shows how we expect folks to embed Subscribable in their Spec field.

    @@ -1496,133 +1595,216 @@ date.

    +subscribers
    + + +[]SubscriberSpec + + + + +
    -apiVersion
    -string    		 - -eventing.knative.dev/v1alpha1 - +

    This is the list of subscriptions for this subscribable.
    +

    SubscribableStatus +

    +

    +(Appears on: +ChannelableCombinedStatus, +ChannelableStatus, +Subscribable) +

    +

    +

    SubscribableStatus is the schema for the subscribable’s status portion of the status +section of the resource.

    +

    + + - - + + + + + +
    -kind
    -string -    		EventTypeFieldDescription
    -metadata
    +subscribers
    - -Kubernetes meta/v1.ObjectMeta + +[]SubscriberStatus     		-(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

    This is the list of subscription’s statuses for this channel.
    +

    SubscriberSpec +

    +

    +(Appears on: +SubscribableSpec) +

    +

    +

    SubscriberSpec defines a single subscriber to a Subscribable.

    +

    At least one of SubscriberURI and ReplyURI must be present

    +

    + + + + + + + + + + + + + +
    FieldDescription
    -spec
    +uid
    - -EventTypeSpec - +k8s.io/apimachinery/pkg/types.UID     		-

    Spec defines the desired state of the EventType.

    -
    -
    - +(Optional) +

    UID is used to understand the origin of the subscriber.

    + + + +
    -type
    +generation
    -string +int64     		-

    Type represents the CloudEvents type. It is authoritative.

    +(Optional) +

    Generation of the origin of the subscriber with uid:UID.
    -source
    +subscriberUri
    -string +knative.dev/pkg/apis.URL     		-

    Source is a URI, it represents the CloudEvents source.

    +(Optional) +

    SubscriberURI is the endpoint for the subscriber
    -schema
    +replyUri
    -string +knative.dev/pkg/apis.URL     		(Optional) -

    Schema is a URI, it represents the CloudEvents schemaurl extension attribute. -It may be a JSON schema, a protobuf schema, etc. It is optional.

    +

    ReplyURI is the endpoint for the reply
    -broker
    +delivery
    -string + +DeliverySpec +     		-

    Broker refers to the Broker that can provide the EventType.

    +(Optional) +

    DeliverySpec contains options controlling the event delivery
    +

    SubscriberStatus +

    +

    +(Appears on: +SubscribableStatus) +

    +

    +

    SubscriberStatus defines the status of a single subscriber to a Channel.

    +

    + + + + + + + + -
    FieldDescription
    -description
    +uid
    -string +k8s.io/apimachinery/pkg/types.UID     		(Optional) -

    Description is an optional field used to describe the EventType, in any meaningful way.

    +

    UID is used to understand the origin of the subscriber.
    +
    +observedGeneration
    + +int64 + +    		 +(Optional) +

    Generation of the origin of the subscriber with uid:UID.
    -status
    +ready
    - -EventTypeStatus + +Kubernetes core/v1.ConditionStatus     		+

    Status of the subscriber.

    +
    +message
    + +string + +    		 (Optional) -

    Status represents the current state of the EventType. -This data may be out of date.

    +

    A human readable message indicating details of Ready status.
    -

    Trigger +
    +

    flows.knative.dev/v1beta1

    +

    +

    Package v1beta1 is the v1beta1 version of the API.

    +

    +Resource Types: +
      +

      Parallel

      -

      Trigger represents a request to have events delivered to a consumer from a -Broker’s event pool.

      +

      Parallel defines conditional branches that will be wired in +series through Channels and Subscriptions.

      @@ -1634,23 +1816,6 @@ Broker’s event pool.

      - - - - - - - -
      -apiVersion
      -string      		 - -eventing.knative.dev/v1alpha1 - -
      -kind
      -string -      		Trigger
      metadata
      @@ -1668,53 +1833,55 @@ Refer to the Kubernetes API documentation for the fields of the       		spec
      - -TriggerSpec + +ParallelSpec       		-

      Spec defines the desired state of the Trigger.

      +

      Spec defines the desired state of the Parallel.



      -broker
      +branches
      -string + +[]ParallelBranch +       		-

      Broker is the broker that this trigger receives events from. If not specified, will default -to ‘default’.

      +

      Branches is the list of Filter/Subscribers pairs.
      -filter
      +channelTemplate
      - -TriggerFilter + +ChannelTemplateSpec       		(Optional) -

      Filter is the filter to apply against all events from the Broker. Only events that pass this -filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -subscriber
      +reply
      knative.dev/pkg/apis/duck/v1.Destination       		-

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It -is required.

      +(Optional) +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply
      @@ -1724,24 +1891,24 @@ is required.

      		 status
      - -TriggerStatus + +ParallelStatus       		(Optional) -

      Status represents the current state of the Trigger. This data may be out of +

      Status represents the current state of the Parallel. This data may be out of date.
      -

      BrokerSpec +

      ParallelBranch

      (Appears on: -Broker) +ParallelSpec)

      @@ -1755,45 +1922,50 @@ date.
      -channelTemplateSpec
      +filter
      - -ChannelTemplateSpec - +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the -Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there -are no defaults for the namespace).

      +

      Filter is the expression guarding the branch
      -delivery
      +subscriber
      - -DeliverySpec - +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber receiving the event when the filter passes

      +
      +reply
      + +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Delivery is the delivery specification to be used internally by the broker to -create subscriptions.

      +

      Reply is a Reference to where the result of Subscriber of this case gets sent to. +If not specified, sent the result to the Parallel Reply
      -

      BrokerStatus +

      ParallelBranchStatus

      (Appears on: -Broker) +ParallelStatus)

      -

      BrokerStatus represents the current state of a Broker.

      +

      ParallelBranchStatus represents the current state of a Parallel branch

      @@ -1805,54 +1977,51 @@ create subscriptions.

      -Status
      +filterSubscriptionStatus
      -knative.dev/pkg/apis/duck/v1.Status + +ParallelSubscriptionStatus +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      FilterSubscriptionStatus corresponds to the filter subscription status.
      -address
      +filterChannelStatus
      -knative.dev/pkg/apis/duck/v1alpha1.Addressable + +ParallelChannelStatus +       		-

      Broker 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 {broker}-router.{namespace}.svc.{cluster domain name}

      +

      FilterChannelStatus corresponds to the filter channel status.
      -triggerChannel
      +subscriberSubscriptionStatus
      - -Kubernetes core/v1.ObjectReference + +ParallelSubscriptionStatus       		-

      TriggerChannel is an objectref to the object for the TriggerChannel

      +

      SubscriptionStatus corresponds to the subscriber subscription status.
      -

      EventTypeSpec +

      ParallelChannelStatus

      (Appears on: -EventType) +ParallelBranchStatus, +ParallelStatus)

      @@ -1866,72 +2035,97 @@ Kubernetes core/v1.ObjectReference -type
      +channel
      -string + +Kubernetes core/v1.ObjectReference + -

      Type represents the CloudEvents type. It is authoritative.

      +

      Channel is the reference to the underlying channel.

      -source
      +ready
      -string +knative.dev/pkg/apis.Condition -

      Source is a URI, it represents the CloudEvents source.

      +

      ReadyCondition indicates whether the Channel is ready or not.

      + + +

      ParallelSpec +

      +

      +(Appears on: +Parallel) +

      +

      +

      + + + + + + + +
      FieldDescription
      -schema
      +branches
      -string + +[]ParallelBranch +       		-(Optional) -

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. -It may be a JSON schema, a protobuf schema, etc. It is optional.

      +

      Branches is the list of Filter/Subscribers pairs.
      -broker
      +channelTemplate
      -string + +ChannelTemplateSpec +       		-

      Broker refers to the Broker that can provide the EventType.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -description
      +reply
      -string +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Description is an optional field used to describe the EventType, in any meaningful way.

      +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply
      -

      EventTypeStatus +

      ParallelStatus

      (Appears on: -EventType) +Parallel)

      -

      EventTypeStatus represents the current state of a EventType.

      +

      ParallelStatus represents the current state of a Parallel.

      @@ -1957,177 +2151,58 @@ knative.dev/pkg/apis/duck/v1.Status * Conditions - the latest available observations of a resource’s current state.

      - -
      -

      TriggerFilter -

      -

      -(Appears on: -TriggerSpec) -

      -

      -

      - - - - - - - - - - -
      FieldDescription
      -sourceAndType
      +ingressChannelStatus
      - -TriggerFilterSourceAndType + +ParallelChannelStatus       		-(Optional) -

      DeprecatedSourceAndType filters events based on exact matches on the -CloudEvents type and source attributes. This field has been replaced by the -Attributes field.

      +

      IngressChannelStatus corresponds to the ingress channel status.
      -attributes
      +branchStatuses
      - -TriggerFilterAttributes + +[]ParallelBranchStatus       		-(Optional) -

      Attributes filters events by exact match on event context attributes. -Each key in the map is compared with the equivalent key in the event -context. An event passes the filter if all values are equal to the -specified values.

      -

      Nested context attributes are not supported as keys. Only string values are supported.

      -
      -

      TriggerFilterAttributes -(map[string]string alias)

      -

      -(Appears on: -TriggerFilter) -

      -

      -

      TriggerFilterAttributes is a map of context attribute names to values for -filtering by equality. Only exact matches will pass the filter. You can use the value “ -to indicate all strings match.

      -

      -

      TriggerFilterSourceAndType -

      -

      -(Appears on: -TriggerFilter) -

      -

      -

      TriggerFilterSourceAndType filters events based on exact matches on the cloud event’s type and -source attributes. Only exact matches will pass the filter. Either or both type and source can -use the value “ to indicate all strings match.

      -

      - - - - - - - - - - - - - -
      FieldDescription
      -type
      - -string - -      		 +

      BranchStatuses is an array of corresponding to branch statuses. +Matches the Spec.Branches array in the order.
      -source
      +AddressStatus
      -string +knative.dev/pkg/apis/duck/v1.AddressStatus       		-
      -

      TriggerSpec -

      -

      -(Appears on: -Trigger) -

      +(Members of AddressStatus are embedded into this type.)

      - - - - - - - - - - - - - - - - - - -
      FieldDescription
      -broker
      - -string - -      		 -

      Broker is the broker that this trigger receives events from. If not specified, will default -to ‘default’.

      -
      -filter
      - - -TriggerFilter - - -      		 -(Optional) -

      Filter is the filter to apply against all events from the Broker. Only events that pass this -filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      -
      -subscriber
      - -knative.dev/pkg/apis/duck/v1.Destination - -      		 -

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It -is required.

      +

      AddressStatus is the starting point to this Parallel. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}
      -

      TriggerStatus +

      ParallelSubscriptionStatus

      (Appears on: -Trigger) +ParallelBranchStatus)

      -

      TriggerStatus represents the current state of a Trigger.

      @@ -2139,44 +2214,34 @@ is required.

      -Status
      +subscription
      -knative.dev/pkg/apis/duck/v1.Status + +Kubernetes core/v1.ObjectReference +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Subscription is the reference to the underlying Subscription.
      -subscriberURI
      +ready
      -knative.dev/pkg/apis.URL +knative.dev/pkg/apis.Condition       		-

      SubscriberURI is the resolved URI of the receiver for this Trigger.

      +

      ReadyCondition indicates whether the Subscription is ready or not.
      -
      -

      flows.knative.dev/v1alpha1

      -

      -

      Package v1alpha1 is the v1alpha1 version of the API.

      -

      -Resource Types: - -

      Parallel +

      Sequence

      -

      Parallel defines conditional branches that will be wired in +

      Sequence defines a sequence of Subscribers that will be wired in series through Channels and Subscriptions.

      @@ -2206,34 +2271,35 @@ Refer to the Kubernetes API documentation for the fields of the
      spec
      - -ParallelSpec + +SequenceSpec       		-

      Spec defines the desired state of the Parallel.

      +

      Spec defines the desired state of the Sequence.



      -branches
      +steps
      - -[]ParallelBranch + +[]SequenceStep       		-

      Branches is the list of Filter/Subscribers pairs.

      +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided. Each step has its own delivery options
      channelTemplate
      - + ChannelTemplateSpec @@ -2253,8 +2319,7 @@ knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      +

      Reply is a Reference to where the result of the last Subscriber gets sent to.
      @@ -2264,24 +2329,24 @@ when the case does not have a Reply

      		 status
      - -ParallelStatus + +SequenceStatus       		(Optional) -

      Status represents the current state of the Parallel. This data may be out of +

      Status represents the current state of the Sequence. This data may be out of date.
      -

      ParallelBranch +

      SequenceChannelStatus

      (Appears on: -ParallelSpec) +SequenceStatus)

      @@ -2295,49 +2360,37 @@ date.

      -filter
      - -knative.dev/pkg/apis/duck/v1.Destination - - - -

      Filter is the expression guarding the branch

      - - - - -subscriber
      +channel
      -knative.dev/pkg/apis/duck/v1.Destination + +Kubernetes core/v1.ObjectReference + -

      Subscriber receiving the event when the filter passes

      +

      Channel is the reference to the underlying channel.

      -reply
      +ready
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis.Condition -(Optional) -

      Reply is a Reference to where the result of Subscriber of this case gets sent to. -If not specified, sent the result to the Parallel Reply

      +

      ReadyCondition indicates whether the Channel is ready or not.

      -

      ParallelBranchStatus +

      SequenceSpec

      (Appears on: -ParallelStatus) +Sequence)

      -

      ParallelBranchStatus represents the current state of a Parallel branch

      @@ -2349,53 +2402,55 @@ If not specified, sent the result to the Parallel Reply

      -filterSubscriptionStatus
      +steps
      - -ParallelSubscriptionStatus + +[]SequenceStep       		-

      FilterSubscriptionStatus corresponds to the filter subscription status.

      +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided. Each step has its own delivery options
      -filterChannelStatus
      +channelTemplate
      - -ParallelChannelStatus + +ChannelTemplateSpec       		-

      FilterChannelStatus corresponds to the filter channel status.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -subscriberSubscriptionStatus
      +reply
      - -ParallelSubscriptionStatus - +knative.dev/pkg/apis/duck/v1.Destination       		-

      SubscriptionStatus corresponds to the subscriber subscription status.

      +(Optional) +

      Reply is a Reference to where the result of the last Subscriber gets sent to.
      -

      ParallelChannelStatus +

      SequenceStatus

      (Appears on: -ParallelBranchStatus, -ParallelStatus) +Sequence)

      +

      SequenceStatus represents the current state of a Sequence.

      @@ -2407,97 +2462,73 @@ ParallelSubscriptionStatus - - - - - - -
      -channel
      - - -Kubernetes core/v1.ObjectReference - - -      		 -

      Channel is the reference to the underlying channel.

      -
      -ready
      +Status
      -knative.dev/pkg/apis.Condition +knative.dev/pkg/apis/duck/v1.Status       		-

      ReadyCondition indicates whether the Channel is ready or not.

      -
      -

      ParallelSpec -

      -

      -(Appears on: -Parallel) -

      +(Members of Status are embedded into this type.)

      - - - - - +

      inherits duck/v1 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.

      + - -
      FieldDescription
      -branches
      +subscriptionStatuses
      - -[]ParallelBranch + +[]SequenceSubscriptionStatus       		-

      Branches is the list of Filter/Subscribers pairs.

      +

      SubscriptionStatuses is an array of corresponding Subscription statuses. +Matches the Spec.Steps array in the order.
      -channelTemplate
      +channelStatuses
      - -ChannelTemplateSpec + +[]SequenceChannelStatus       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      ChannelStatuses is an array of corresponding Channel statuses. +Matches the Spec.Steps array in the order.
      -reply
      +AddressStatus
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1.AddressStatus       		-(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the starting point to this Sequence. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}
      -

      ParallelStatus +

      SequenceStep

      (Appears on: -Parallel) +SequenceSpec)

      -

      ParallelStatus represents the current state of a Parallel.

      @@ -2509,70 +2540,40 @@ when the case does not have a Reply

      - - - - - - - -
      -Status
      +Destination
      -knative.dev/pkg/apis/duck/v1.Status +knative.dev/pkg/apis/duck/v1.Destination

      -(Members of Status are embedded into this type.) +(Members of Destination are embedded into this type.)

      -

      inherits duck/v1 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.

      -
      -ingressChannelStatus
      - - -ParallelChannelStatus - - -      		 -

      IngressChannelStatus corresponds to the ingress channel status.

      +

      Subscriber receiving the step event
      -branchStatuses
      +delivery
      - -[]ParallelBranchStatus + +DeliverySpec       		-

      BranchStatuses is an array of corresponding to branch statuses. -Matches the Spec.Branches array in the order.

      -
      -AddressStatus
      - -knative.dev/pkg/apis/duck/v1.AddressStatus - -      		 -

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Parallel. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      +(Optional) +

      Delivery is the delivery specification for events to the subscriber +This includes things like retries, DLQ, etc.
      -

      ParallelSubscriptionStatus +

      SequenceSubscriptionStatus

      (Appears on: -ParallelBranchStatus) +SequenceStatus)

      @@ -2610,11 +2611,25 @@ knative.dev/pkg/apis.Condition -

      Sequence +
      +

      sources.eventing.knative.dev/v1alpha1

      +

      +

      Package v1alpha1 contains API Schema definitions for the sources v1alpha1 API group

      +

      +Resource Types: + +

      ApiServerSource

      -

      Sequence defines a sequence of Subscribers that will be wired in -series through Channels and Subscriptions.

      +

      ApiServerSource is the Schema for the apiserversources API

      @@ -2626,6 +2641,36 @@ series through Channels and Subscriptions.

      + + + + + + + + + + + + @@ -2643,53 +2687,64 @@ Refer to the Kubernetes API documentation for the fields of the
      +apiVersion
      +string      		 + +sources.eventing.knative.dev/v1alpha1 + +
      +kind
      +string +      		ApiServerSource
      +Deprecated
      + + +Deprecated + + +      		 +

      Deprecated allows ApiServerSource to have a deprecated message.

      +
      metadata
      @@ -2634,7 +2679,6 @@ Kubernetes meta/v1.ObjectMeta       		-(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -SequenceSpec + +ApiServerSourceSpec       		-

      Spec defines the desired state of the Sequence.



      + + + +
      -steps
      +resources
      -[]knative.dev/pkg/apis/duck/v1.Destination + +[]ApiServerResource +       		-

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided.

      +

      Resources is the list of resources to watch
      -channelTemplate
      +serviceAccountName
      - -ChannelTemplateSpec - +string       		(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source.
      -reply
      +sink
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1beta1.Destination       		(Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +
      +mode
      + +string + +      		 +

      Mode is the mode the receive adapter controller runs under: Ref or Resource. +Ref sends only the reference to the resource. +Resource send the full resource.
      @@ -2699,26 +2754,20 @@ knative.dev/pkg/apis/duck/v1.Destination       		status
      - -SequenceStatus + +ApiServerSourceStatus       		-(Optional) -

      Status represents the current state of the Sequence. This data may be out of -date.
      -

      SequenceChannelStatus +

      ContainerSource

      -(Appears on: -SequenceStatus) -

      -

      +

      ContainerSource is the Schema for the containersources API

      @@ -2730,227 +2779,165 @@ date.

      + + + + - -
      -channel
      - - -Kubernetes core/v1.ObjectReference - - +apiVersion
      +string      		 + +sources.eventing.knative.dev/v1alpha1 +
      -

      Channel is the reference to the underlying channel.

      +kind
      +string       		ContainerSource
      -ready
      +Deprecated
      -knative.dev/pkg/apis.Condition + +Deprecated +       		-

      ReadyCondition indicates whether the Channel is ready or not.

      +

      Deprecated allows ContainerSource to have a deprecated message.
      -

      SequenceSpec -

      -

      -(Appears on: -Sequence) -

      -

      -

      - - - - - - - - - +
      +
      +
      FieldDescription
      -steps
      +metadata
      -[]knative.dev/pkg/apis/duck/v1.Destination + +Kubernetes meta/v1.ObjectMeta +       		-

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided.

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -channelTemplate
      +spec
      - -ChannelTemplateSpec + +ContainerSourceSpec       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      -
      - -
      -reply
      +template
      -knative.dev/pkg/apis/duck/v1.Destination + +Kubernetes core/v1.PodTemplateSpec +       		(Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +

      Template describes the pods that will be created
      -

      SequenceStatus -

      -

      -(Appears on: -Sequence) -

      -

      -

      SequenceStatus represents the current state of a Sequence.

      -

      - - - - - - - - - -
      FieldDescription
      -Status
      +image
      -knative.dev/pkg/apis/duck/v1.Status +string       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      DeprecatedImage is the image to run inside of the container. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -subscriptionStatuses
      +args
      - -[]SequenceSubscriptionStatus - +[]string       		-

      SubscriptionStatuses is an array of corresponding Subscription statuses. -Matches the Spec.Steps array in the order.

      +

      DeprecatedArgs are passed to the ContainerSpec as they are. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -channelStatuses
      +env
      - -[]SequenceChannelStatus + +[]Kubernetes core/v1.EnvVar       		-

      ChannelStatuses is an array of corresponding Channel statuses. -Matches the Spec.Steps array in the order.

      +(Optional) +

      DeprecatedEnv is the list of environment variables to set in the container. +Cannot be updated. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -AddressStatus
      +serviceAccountName
      -knative.dev/pkg/apis/duck/v1.AddressStatus +string       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Sequence. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      +(Optional) +

      DeprecatedServiceAccountName is the name of the ServiceAccount to use to run this +source. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -

      SequenceSubscriptionStatus -

      -

      -(Appears on: -SequenceStatus) -

      -

      -

      - - - - - - - - + +
      FieldDescription
      -subscription
      +sink
      - -Kubernetes core/v1.ObjectReference - +knative.dev/pkg/apis/duck/v1beta1.Destination       		-

      Subscription is the reference to the underlying Subscription.

      +

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +
      -ready
      +status
      -knative.dev/pkg/apis.Condition + +ContainerSourceStatus + -

      ReadyCondition indicates whether the Subscription is ready or not.

      -
      -

      sources.eventing.knative.dev/v1alpha1

      -

      -

      Package v1alpha1 contains API Schema definitions for the sources v1alpha1 API group

      -

      -Resource Types: - -

      ApiServerSource +

      CronJobSource

      -

      ApiServerSource is the Schema for the apiserversources API

      +

      CronJobSource is the Schema for the cronjobsources API.

      @@ -2975,7 +2962,7 @@ sources.eventing.knative.dev/v1alpha1 kind
      string - + @@ -3008,8 +2995,8 @@ Refer to the Kubernetes API documentation for the fields of the @@ -3019,28 +3006,24 @@ ApiServerSourceSpec
      ApiServerSourceCronJobSource
      @@ -2987,7 +2974,7 @@ Deprecated -

      Deprecated allows ApiServerSource to have a deprecated message.

      +

      Deprecated allows CronJobSource to have a deprecated message.
      spec
      - -ApiServerSourceSpec + +CronJobSourceSpec
      @@ -3051,21 +3034,32 @@ knative.dev/pkg/apis/duck/v1beta1.Destination + + + +
      -resources
      +schedule
      - -[]ApiServerResource - +string       		-

      Resources is the list of resources to watch

      +

      Schedule is the cronjob schedule.
      -serviceAccountName
      +data
      string       		-(Optional) -

      ServiceAccountName is the name of the ServiceAccount to use to run this -source.

      +

      Data is the data posted to the target function.
      -(Optional)

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -mode
      +serviceAccountName
      string       		-

      Mode is the mode the receive adapter controller runs under: Ref or Resource. -Ref sends only the reference to the resource. -Resource send the full resource.

      +

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive +Adapter Deployment.

      +
      +resources
      + + +CronJobResourceSpec + + +      		 +

      Resource limits and Request specifications of the Receive Adapter Deployment
      @@ -3075,8 +3069,8 @@ string status
      - -ApiServerSourceStatus + +CronJobSourceStatus @@ -3085,10 +3079,15 @@ ApiServerSourceStatus -

      ContainerSource +

      SinkBinding

      -

      ContainerSource is the Schema for the containersources API

      +

      SinkBinding describes a Binding that is also a Source. +The sink (from the Source duck) is resolved to a URL and +then projected into the subject by augmenting the runtime +contract of the referenced containers to have a K_SINK +environment variable holding the endpoint to which to send +cloud events.

      @@ -3113,7 +3112,7 @@ sources.eventing.knative.dev/v1alpha1 kind
      string - + @@ -3146,8 +3145,8 @@ Refer to the Kubernetes API documentation for the fields of the @@ -3157,85 +3156,28 @@ ContainerSourceSpec
      ContainerSourceSinkBinding
      @@ -3125,7 +3124,7 @@ Deprecated -

      Deprecated allows ContainerSource to have a deprecated message.

      +

      Deprecated allows ApiServerSource to have a deprecated message.
      spec
      - -ContainerSourceSpec + +SinkBindingSpec
      - - - - - - - - - - - - - - - -
      -template
      - - -Kubernetes core/v1.PodTemplateSpec - - -      		 -(Optional) -

      Template describes the pods that will be created

      -
      -image
      - -string - -      		 -

      DeprecatedImage is the image to run inside of the container. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      -
      -args
      - -[]string - -      		 -

      DeprecatedArgs are passed to the ContainerSpec as they are. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      -
      -env
      - - -[]Kubernetes core/v1.EnvVar - - -      		 -(Optional) -

      DeprecatedEnv is the list of environment variables to set in the container. -Cannot be updated. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      -
      -serviceAccountName
      +SourceSpec
      -string +knative.dev/pkg/apis/duck/v1.SourceSpec       		-(Optional) -

      DeprecatedServiceAccountName is the name of the ServiceAccount to use to run this -source. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +

      +(Members of SourceSpec are embedded into this type.) +
      -sink
      +BindingSpec
      -knative.dev/pkg/apis/duck/v1beta1.Destination +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec       		-

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +

      +(Members of BindingSpec are embedded into this type.) +
      @@ -3245,8 +3187,8 @@ knative.dev/pkg/apis/duck/v1beta1.Destination status
      - -ContainerSourceStatus + +SinkBindingStatus @@ -3255,10 +3197,14 @@ ContainerSourceStatus -

      CronJobSource +

      ApiServerResource

      -

      CronJobSource is the Schema for the cronjobsources API.

      +(Appears on: +ApiServerSourceSpec) +

      +

      +

      ApiServerResource defines the resource to watch

      @@ -3271,80 +3217,108 @@ ContainerSourceStatus + +string + + + - + + +
      apiVersion
      -string      		 - -sources.eventing.knative.dev/v1alpha1 - +

      API version of the resource to watch.
      kind
      + string + +      		 +

      Kind of the resource to watch. +More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

      		CronJobSource
      -Deprecated
      +labelSelector
      - -Deprecated + +Kubernetes meta/v1.LabelSelector       		-

      Deprecated allows CronJobSource to have a deprecated message.

      +

      LabelSelector restricts this source to objects with the selected labels +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
      -metadata
      +controllerSelector
      - -Kubernetes meta/v1.ObjectMeta + +Kubernetes meta/v1.OwnerReference       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      ControllerSelector restricts this source to objects with a controlling owner reference of the specified kind. +Only apiVersion and kind are used. Both are optional.
      -spec
      +controller
      - -CronJobSourceSpec - +bool       		-
      -
      +

      If true, send an event referencing the object controlling the resource

      +
      +

      ApiServerSourceSpec +

      +

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceSpec defines the desired state of ApiServerSource

      +

      + + + + + + + @@ -3355,60 +3329,80 @@ knative.dev/pkg/apis/duck/v1beta1.Destination + +
      FieldDescription
      -schedule
      +resources
      -string + +[]ApiServerResource +       		-

      Schedule is the cronjob schedule.

      +

      Resources is the list of resources to watch
      -data
      +serviceAccountName
      string       		-

      Data is the data posted to the target function.

      +(Optional) +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source.
      +(Optional)

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -serviceAccountName
      +mode
      string       		-

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive -Adapter Deployment.

      +

      Mode is the mode the receive adapter controller runs under: Ref or Resource. +Ref sends only the reference to the resource. +Resource send the full resource.
      +

      ApiServerSourceStatus +

      +

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceStatus defines the observed state of ApiServerSource

      +

      + + + + + + + + - -
      FieldDescription
      -resources
      +Status
      - -CronJobResourceSpec - +knative.dev/pkg/apis/duck/v1.Status       		-

      Resource limits and Request specifications of the Receive Adapter Deployment

      -
      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      -status
      +sinkUri
      - -CronJobSourceStatus - +string +(Optional) +

      SinkURI is the current active sink URI that has been configured for the ApiServerSource.

      -

      SinkBinding +

      ContainerSourceSpec

      -

      SinkBinding describes a Binding that is also a Source. -The sink (from the Source duck) is resolved to a URL and -then projected into the subject by augmenting the runtime -contract of the referenced containers to have a K_SINK -environment variable holding the endpoint to which to send -cloud events.

      +(Appears on: +ContainerSource) +

      +

      +

      ContainerSourceSpec defines the desired state of ContainerSource

      @@ -3420,112 +3414,143 @@ cloud events.

      +template
      + + +Kubernetes core/v1.PodTemplateSpec + + + + - +

      +

      ContainerSourceStatus defines the observed state of ContainerSource

      +

      +
      -apiVersion
      -string      		 - -sources.eventing.knative.dev/v1alpha1 - +(Optional) +

      Template describes the pods that will be created
      -kind
      +image
      + string + +      		 +

      DeprecatedImage is the image to run inside of the container. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.

      		SinkBinding
      -Deprecated
      +args
      - -Deprecated - +[]string       		-

      Deprecated allows ApiServerSource to have a deprecated message.

      +

      DeprecatedArgs are passed to the ContainerSpec as they are. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -metadata
      +env
      - -Kubernetes meta/v1.ObjectMeta + +[]Kubernetes core/v1.EnvVar       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +(Optional) +

      DeprecatedEnv is the list of environment variables to set in the container. +Cannot be updated. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -spec
      +serviceAccountName
      - -SinkBindingSpec - +string       		-
      -
      - +(Optional) +

      DeprecatedServiceAccountName is the name of the ServiceAccount to use to run this +source. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.

      + + + + +
      -SourceSpec
      +sink
      -knative.dev/pkg/apis/duck/v1.SourceSpec +knative.dev/pkg/apis/duck/v1beta1.Destination       		+

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +
      +

      ContainerSourceStatus +

      -(Members of SourceSpec are embedded into this type.) +(Appears on: +ContainerSource)

      -
      + + + + + + - -
      FieldDescription
      -BindingSpec
      +Status
      -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec +knative.dev/pkg/apis/duck/v1.Status

      -(Members of BindingSpec are embedded into this type.) +(Members of Status are embedded into this type.)

      -
      +

      inherits duck/v1 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.

      -status
      +sinkUri
      - -SinkBindingStatus - +string +(Optional) +

      SinkURI is the current active sink URI that has been configured for the ContainerSource.

      -

      ApiServerResource +

      CronJobLimitsSpec

      (Appears on: -ApiServerSourceSpec) +CronJobResourceSpec)

      -

      ApiServerResource defines the resource to watch

      @@ -3537,76 +3562,114 @@ SinkBindingStatus + +
      -apiVersion
      +cpu
      string       		-

      API version of the resource to watch.
      -kind
      +memory
      string       		-

      Kind of the resource to watch. -More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
      +

      CronJobRequestsSpec +

      +

      +(Appears on: +CronJobResourceSpec) +

      +

      +

      + + + + + + + + + + + +
      FieldDescription
      -labelSelector
      +cpu
      - -Kubernetes meta/v1.LabelSelector - +string       		-

      LabelSelector restricts this source to objects with the selected labels -More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
      -controllerSelector
      +memory
      - -Kubernetes meta/v1.OwnerReference +string + +      		 +
      +

      CronJobResourceSpec +

      +

      +(Appears on: +CronJobSourceSpec) +

      +

      +

      + + + + + + + + + +
      FieldDescription
      +requests
      + + +CronJobRequestsSpec       		-

      ControllerSelector restricts this source to objects with a controlling owner reference of the specified kind. -Only apiVersion and kind are used. Both are optional.
      -controller
      +limits
      -bool + +CronJobLimitsSpec +       		-

      If true, send an event referencing the object controlling the resource
      -

      ApiServerSourceSpec +

      CronJobSourceSpec

      (Appears on: -ApiServerSource) +CronJobSource)

      -

      ApiServerSourceSpec defines the desired state of ApiServerSource

      +

      CronJobSourceSpec defines the desired state of the CronJobSource.

      @@ -3618,28 +3681,24 @@ bool @@ -3650,33 +3709,44 @@ knative.dev/pkg/apis/duck/v1beta1.Destination + + + +
      -resources
      +schedule
      - -[]ApiServerResource - +string       		-

      Resources is the list of resources to watch

      +

      Schedule is the cronjob schedule.
      -serviceAccountName
      +data
      string       		-(Optional) -

      ServiceAccountName is the name of the ServiceAccount to use to run this -source.

      +

      Data is the data posted to the target function.
      -(Optional)

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -mode
      +serviceAccountName
      string       		-

      Mode is the mode the receive adapter controller runs under: Ref or Resource. -Ref sends only the reference to the resource. -Resource send the full resource.

      +

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive +Adapter Deployment.

      +
      +resources
      + + +CronJobResourceSpec + + +      		 +

      Resource limits and Request specifications of the Receive Adapter Deployment
      -

      ApiServerSourceStatus +

      CronJobSourceStatus

      (Appears on: -ApiServerSource) +CronJobSource)

      -

      ApiServerSourceStatus defines the observed state of ApiServerSource

      +

      CronJobSourceStatus defines the observed state of CronJobSource.

      @@ -3711,19 +3781,30 @@ string
      (Optional) -

      SinkURI is the current active sink URI that has been configured for the ApiServerSource.

      +

      SinkURI is the current active sink URI that has been configured for the CronJobSource.
      -

      ContainerSourceSpec +

      Deprecated

      (Appears on: -ContainerSource) +ApiServerSource, +ContainerSource, +CronJobSource, +SinkBinding)

      -

      ContainerSourceSpec defines the desired state of ContainerSource

      +

      +

      SinkBindingSpec +

      +

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      @@ -3735,97 +3816,3932 @@ string - +

      +(Members of BindingSpec are embedded into this type.) +

      + + + +
      -template
      +SourceSpec
      - -Kubernetes core/v1.PodTemplateSpec - +knative.dev/pkg/apis/duck/v1.SourceSpec       		-(Optional) -

      Template describes the pods that will be created

      +

      +(Members of SourceSpec are embedded into this type.) +
      -image
      +BindingSpec
      -string +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec       		-

      DeprecatedImage is the image to run inside of the container. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      -
      +

      SinkBindingStatus +

      +

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +SourceStatus
      + +knative.dev/pkg/apis/duck/v1.SourceStatus + +      		 +

      +(Members of SourceStatus are embedded into this type.) +

      +
      +
      +

      messaging.knative.dev/v1alpha1

      +

      +

      Package v1alpha1 is the v1alpha1 version of the API.

      +

      +Resource Types: + +

      Channel +

      +

      +

      Channel represents a generic Channel. It is normally used when we want a Channel, but don’t need a specific Channel implementation.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +messaging.knative.dev/v1alpha1 + +
      +kind
      +string +      		Channel
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +ChannelSpec + + +      		 +

      Spec defines the desired state of the Channel.

      +
      +
      + + + + + + + + + + + + + +
      +channelTemplate
      + + +ChannelTemplateSpec + + +      		 +

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      +
      +subscribable
      + + +Subscribable + + +      		 +

      Channel conforms to Duck type Subscribable.

      +
      +delivery
      + + +DeliverySpec + + +      		 +

      Delivery options.

      +
      +
      +status
      + + +ChannelStatus + + +      		 +(Optional) +

      Status represents the current state of the Channel. This data may be out of +date.

      +
      +

      InMemoryChannel +

      +

      +

      InMemoryChannel is a resource representing an in memory channel

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +messaging.knative.dev/v1alpha1 + +
      +kind
      +string +      		InMemoryChannel
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +InMemoryChannelSpec + + +      		 +

      Spec defines the desired state of the Channel.

      +
      +
      + + + + + + + + + +
      +subscribable
      + + +Subscribable + + +      		 +

      Channel conforms to Duck type Subscribable.

      +
      +delivery
      + + +DeliverySpec + + +      		 +

      For round tripping (v1beta1 <-> v1alpha1>

      +
      +
      +status
      + + +InMemoryChannelStatus + + +      		 +(Optional) +

      Status represents the current state of the Channel. This data may be out of +date.

      +
      +

      Subscription +

      +

      +

      Subscription routes events received on a Channel to a DNS name and +corresponds to the subscriptions.channels.knative.dev CRD.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +messaging.knative.dev/v1alpha1 + +
      +kind
      +string +      		Subscription
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +SubscriptionSpec + + +      		 +
      +
      + + + + + + + + + + + + + + + + + + + + + +
      +generation
      + +int64 + +      		 +(Optional) +

      TODO By enabling the status subresource metadata.generation should increment +thus making this property obsolete.

      +

      We should be able to drop this property with a CRD conversion webhook +in the future

      +
      +channel
      + + +Kubernetes core/v1.ObjectReference + + +      		 +

      This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)

      +
      +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +(Optional) +

      Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.

      +
      +reply
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +(Optional) +

      Reply specifies (optionally) how to handle events returned from +the Subscriber target.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      Delivery configuration

      +
      +
      +status
      + + +SubscriptionStatus + + +      		 +
      +

      ChannelSpec +

      +

      +(Appears on: +Channel) +

      +

      +

      ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. +It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +channelTemplate
      + + +ChannelTemplateSpec + + +      		 +

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      +
      +subscribable
      + + +Subscribable + + +      		 +

      Channel conforms to Duck type Subscribable.

      +
      +delivery
      + + +DeliverySpec + + +      		 +

      Delivery options.

      +
      +

      ChannelStatus +

      +

      +(Appears on: +Channel) +

      +

      +

      ChannelStatus represents the current state of a Channel.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +AddressStatus
      + +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus + +      		 +

      +(Members of AddressStatus are embedded into this type.) +

      +

      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}

      +
      +SubscribableTypeStatus
      + + +SubscribableTypeStatus + + +      		 +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      +
      +channel
      + + +Kubernetes core/v1.ObjectReference + + +      		 +

      Channel is an ObjectReference to the Channel CRD backing this Channel.

      +
      +

      InMemoryChannelSpec +

      +

      +(Appears on: +InMemoryChannel) +

      +

      +

      InMemoryChannelSpec defines which subscribers have expressed interest in +receiving events from this InMemoryChannel. +arguments for a Channel.

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +subscribable
      + + +Subscribable + + +      		 +

      Channel conforms to Duck type Subscribable.

      +
      +delivery
      + + +DeliverySpec + + +      		 +

      For round tripping (v1beta1 <-> v1alpha1>

      +
      +

      InMemoryChannelStatus +

      +

      +(Appears on: +InMemoryChannel) +

      +

      +

      ChannelStatus represents the current state of a Channel.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +AddressStatus
      + +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus + +      		 +

      +(Members of AddressStatus are embedded into this type.) +

      +

      InMemoryChannel 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}

      +
      +SubscribableTypeStatus
      + + +SubscribableTypeStatus + + +      		 +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      +
      +

      SubscriptionSpec +

      +

      +(Appears on: +Subscription) +

      +

      +

      SubscriptionSpec specifies the Channel for incoming events, a Subscriber target +for processing those events and where to put the result of the processing. Only +From (where the events are coming from) is always required. You can optionally +only Process the events (results in no output events) by leaving out the Result. +You can also perform an identity transformation on the incoming events by leaving +out the Subscriber and only specifying Result.

      +

      The following are all valid specifications: +channel –[subscriber]–> reply +Sink, no outgoing events: +channel – subscriber +no-op function (identity transformation): +channel –> reply

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +generation
      + +int64 + +      		 +(Optional) +

      TODO By enabling the status subresource metadata.generation should increment +thus making this property obsolete.

      +

      We should be able to drop this property with a CRD conversion webhook +in the future

      +
      +channel
      + + +Kubernetes core/v1.ObjectReference + + +      		 +

      This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)

      +
      +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +(Optional) +

      Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.

      +
      +reply
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +(Optional) +

      Reply specifies (optionally) how to handle events returned from +the Subscriber target.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      Delivery configuration

      +
      +

      SubscriptionStatus +

      +

      +(Appears on: +Subscription) +

      +

      +

      SubscriptionStatus (computed) for a subscription

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +physicalSubscription
      + + +SubscriptionStatusPhysicalSubscription + + +      		 +

      PhysicalSubscription is the fully resolved values that this Subscription represents.

      +
      +

      SubscriptionStatusPhysicalSubscription +

      +

      +(Appears on: +SubscriptionStatus) +

      +

      +

      SubscriptionStatusPhysicalSubscription represents the fully resolved values for this +Subscription.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +subscriberURI
      + +knative.dev/pkg/apis.URL + +      		 +

      SubscriberURI is the fully resolved URI for spec.subscriber.

      +
      +replyURI
      + +knative.dev/pkg/apis.URL + +      		 +

      ReplyURI is the fully resolved URI for the spec.reply.

      +
      +deadLetterSinkURI
      + +knative.dev/pkg/apis.URL + +      		 +

      ReplyURI is the fully resolved URI for the spec.delivery.deadLetterSink.

      +
      +
      +

      sources.knative.dev/v1alpha2

      +

      +

      Package v1alpha2 contains API Schema definitions for the sources v1beta1 API group

      +

      +Resource Types: + +

      ApiServerSource +

      +

      +

      ApiServerSource is the Schema for the apiserversources API

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha2 + +
      +kind
      +string +      		ApiServerSource
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +ApiServerSourceSpec + + +      		 +
      +
      + + + + + + + + + + + + + + + + + + + + + + + + + +
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +resources
      + + +[]APIVersionKind + + +      		 +

      Resource is the resource this source will track and send related +lifecycle events from the Kubernetes ApiServer.

      +
      +selector
      + + +Kubernetes meta/v1.LabelSelector + + +      		 +(Optional) +

      LabelSelector filters this source to objects to those resources pass the +label selector. +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

      +
      +owner
      + + +APIVersionKind + + +      		 +(Optional) +

      ResourceOwner is an additional filter to only track resources that are +owned by a specific resource type. If ResourceOwner matches Resources[n] +then Resources[n] is allowed to pass the ResourceOwner filter.

      +
      +mode
      + +string + +      		 +(Optional) +

      EventMode controls the format of the event. +Reference sends a dataref event type for the resource under watch. +Resource send the full resource lifecycle event. +Defaults to Reference

      +
      +serviceAccountName
      + +string + +      		 +(Optional) +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source. Defaults to default if not set.

      +
      +
      +status
      + + +ApiServerSourceStatus + + +      		 +
      +

      PingSource +

      +

      +

      PingSource is the Schema for the PingSources API.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha2 + +
      +kind
      +string +      		PingSource
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +PingSourceSpec + + +      		 +
      +
      + + + + + + + + + + + + + +
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +schedule
      + +string + +      		 +(Optional) +

      Schedule is the cronjob schedule. Defaults to * * * * *.

      +
      +jsonData
      + +string + +      		 +(Optional) +

      JsonData is json encoded data used as the body of the event posted to +the sink. Default is empty. If set, datacontenttype will also be set +to “application/json”.

      +
      +
      +status
      + + +PingSourceStatus + + +      		 +
      +

      SinkBinding +

      +

      +

      SinkBinding describes a Binding that is also a Source. +The sink (from the Source duck) is resolved to a URL and +then projected into the subject by augmenting the runtime +contract of the referenced containers to have a K_SINK +environment variable holding the endpoint to which to send +cloud events.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha2 + +
      +kind
      +string +      		SinkBinding
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +SinkBindingSpec + + +      		 +
      +
      + + + + + + + + + +
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +BindingSpec
      + +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +      		 +

      +(Members of BindingSpec are embedded into this type.) +

      +

      inherits duck/v1alpha1 BindingSpec, which currently provides: +* Subject - Subject references the resource(s) whose “runtime contract” +should be augmented by Binding implementations.

      +
      +
      +status
      + + +SinkBindingStatus + + +      		 +
      +

      APIVersionKind +

      +

      +(Appears on: +ApiServerSourceSpec, +ApiServerSourceSpec) +

      +

      +

      APIVersionKind is an APIVersion and Kind tuple.

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      + +string + +      		 +(Optional) +

      APIVersion - the API version of the resource to watch.

      +
      +kind
      + +string + +      		 +(Optional) +

      Kind of the resource to watch. +More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

      +
      +

      ApiServerSourceSpec +

      +

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceSpec defines the desired state of ApiServerSource

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +resources
      + + +[]APIVersionKind + + +      		 +

      Resource is the resource this source will track and send related +lifecycle events from the Kubernetes ApiServer.

      +
      +selector
      + + +Kubernetes meta/v1.LabelSelector + + +      		 +(Optional) +

      LabelSelector filters this source to objects to those resources pass the +label selector. +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

      +
      +owner
      + + +APIVersionKind + + +      		 +(Optional) +

      ResourceOwner is an additional filter to only track resources that are +owned by a specific resource type. If ResourceOwner matches Resources[n] +then Resources[n] is allowed to pass the ResourceOwner filter.

      +
      +mode
      + +string + +      		 +(Optional) +

      EventMode controls the format of the event. +Reference sends a dataref event type for the resource under watch. +Resource send the full resource lifecycle event. +Defaults to Reference

      +
      +serviceAccountName
      + +string + +      		 +(Optional) +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source. Defaults to default if not set.

      +
      +

      ApiServerSourceStatus +

      +

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceStatus defines the observed state of ApiServerSource

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +SourceStatus
      + +knative.dev/pkg/apis/duck/v1.SourceStatus + +      		 +

      +(Members of SourceStatus are embedded into this type.) +

      +

      inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.

      +
      +

      PingSourceSpec +

      +

      +(Appears on: +PingSource) +

      +

      +

      PingSourceSpec defines the desired state of the PingSource.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +schedule
      + +string + +      		 +(Optional) +

      Schedule is the cronjob schedule. Defaults to * * * * *.

      +
      +jsonData
      + +string + +      		 +(Optional) +

      JsonData is json encoded data used as the body of the event posted to +the sink. Default is empty. If set, datacontenttype will also be set +to “application/json”.

      +
      +

      PingSourceStatus +

      +

      +(Appears on: +PingSource) +

      +

      +

      PingSourceStatus defines the observed state of PingSource.

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +SourceStatus
      + +knative.dev/pkg/apis/duck/v1.SourceStatus + +      		 +

      +(Members of SourceStatus are embedded into this type.) +

      +

      inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.

      +
      +

      SinkBindingSpec +

      +

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +BindingSpec
      + +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +      		 +

      +(Members of BindingSpec are embedded into this type.) +

      +

      inherits duck/v1alpha1 BindingSpec, which currently provides: +* Subject - Subject references the resource(s) whose “runtime contract” +should be augmented by Binding implementations.

      +
      +

      SinkBindingStatus +

      +

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +SourceStatus
      + +knative.dev/pkg/apis/duck/v1.SourceStatus + +      		 +

      +(Members of SourceStatus are embedded into this type.) +

      +

      inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.

      +
      +
      +

      duck.knative.dev/v1alpha1

      +

      +

      Package v1alpha1 is the v1alpha1 version of the API.

      +

      +Resource Types: + +

      Channelable +

      +

      +

      Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers +defining compatible resources to embed it. We will typically use this type to deserialize +Channelable ObjectReferences and access their subscription and address data. This is not a real resource.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +ChannelableSpec + + +      		 +

      Spec is the part where the Channelable fulfills the Subscribable contract.

      +
      +
      + + + + + + + + + +
      +SubscribableTypeSpec
      + + +SubscribableTypeSpec + + +      		 +

      +(Members of SubscribableTypeSpec are embedded into this type.) +

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      DeliverySpec contains options controlling the event delivery

      +
      +
      +status
      + + +ChannelableStatus + + +      		 +
      +

      ChannelableCombined +

      +

      +

      ChannelableCombined is a skeleton type wrapping Subscribable and Addressable of both +v1alpha1 and v1beta1 duck types. This is not to be used by resource writers and is +only used by Subscription Controller to synthesize patches and read the Status +of the Channelable Resources. +This is not a real resource.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +ChannelableCombinedSpec + + +      		 +

      Spec is the part where the Channelable fulfills the Subscribable contract.

      +
      +
      + + + + + + + + + + + + + +
      +SubscribableTypeSpec
      + + +SubscribableTypeSpec + + +      		 +

      +(Members of SubscribableTypeSpec are embedded into this type.) +

      +

      SubscribableTypeSpec is for the v1alpha1 spec compatibility.

      +
      +SubscribableSpec
      + + +SubscribableSpec + + +      		 +

      +(Members of SubscribableSpec are embedded into this type.) +

      +

      SubscribableSpec is for the v1beta1 spec compatibility.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      DeliverySpec contains options controlling the event delivery

      +
      +
      +status
      + + +ChannelableCombinedStatus + + +      		 +
      +

      ChannelableCombinedSpec +

      +

      +(Appears on: +ChannelableCombined) +

      +

      +

      ChannelableSpec contains Spec of the Channelable object

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +SubscribableTypeSpec
      + + +SubscribableTypeSpec + + +      		 +

      +(Members of SubscribableTypeSpec are embedded into this type.) +

      +

      SubscribableTypeSpec is for the v1alpha1 spec compatibility.

      +
      +SubscribableSpec
      + + +SubscribableSpec + + +      		 +

      +(Members of SubscribableSpec are embedded into this type.) +

      +

      SubscribableSpec is for the v1beta1 spec compatibility.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      DeliverySpec contains options controlling the event delivery

      +
      +

      ChannelableCombinedStatus +

      +

      +(Appears on: +ChannelableCombined) +

      +

      +

      ChannelableStatus contains the Status of a Channelable object.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +AddressStatus
      + +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus + +      		 +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the part where the Channelable fulfills the Addressable contract.

      +
      +SubscribableTypeStatus
      + + +SubscribableTypeStatus + + +      		 +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      SubscribableTypeStatus is the v1alpha1 part of the Subscribers status

      +
      +SubscribableStatus
      + + +SubscribableStatus + + +      		 +

      +(Members of SubscribableStatus are embedded into this type.) +

      +

      SubscribableStatus is the v1beta1 part of the Subscribers status.

      +
      +errorChannel
      + + +Kubernetes core/v1.ObjectReference + + +      		 +(Optional) +

      ErrorChannel is set by the channel when it supports native error handling via a channel

      +
      +

      ChannelableSpec +

      +

      +(Appears on: +Channelable) +

      +

      +

      ChannelableSpec contains Spec of the Channelable object

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +SubscribableTypeSpec
      + + +SubscribableTypeSpec + + +      		 +

      +(Members of SubscribableTypeSpec are embedded into this type.) +

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      DeliverySpec contains options controlling the event delivery

      +
      +

      ChannelableStatus +

      +

      +(Appears on: +Channelable) +

      +

      +

      ChannelableStatus contains the Status of a Channelable object.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +AddressStatus
      + +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus + +      		 +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the part where the Channelable fulfills the Addressable contract.

      +
      +SubscribableTypeStatus
      + + +SubscribableTypeStatus + + +      		 +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      +
      +errorChannel
      + + +Kubernetes core/v1.ObjectReference + + +      		 +(Optional) +

      ErrorChannel is set by the channel when it supports native error handling via a channel

      +
      +

      Resource +

      +

      +

      Resource is a skeleton type wrapping all Kubernetes resources. It is typically used to watch +arbitrary other resources (such as any Source or Addressable). This is not a real resource.

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +

      Subscribable +

      +

      +(Appears on: +ChannelSpec, +InMemoryChannelSpec, +SubscribableTypeSpec) +

      +

      +

      Subscribable is the schema for the subscribable portion of the spec +section of the resource.

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +subscribers
      + + +[]SubscriberSpec + + +      		 +

      This is the list of subscriptions for this subscribable.

      +
      +

      SubscribableStatus +

      +

      +(Appears on: +SubscribableTypeStatus) +

      +

      +

      SubscribableStatus is the schema for the subscribable’s status portion of the status +section of the resource.

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +subscribers
      + + +[]SubscriberStatus + + +      		 +

      This is the list of subscription’s statuses for this channel.

      +
      +

      SubscribableType +

      +

      +

      SubscribableType is a skeleton type wrapping Subscribable in the manner we expect resource writers +defining compatible resources to embed it. We will typically use this type to deserialize +SubscribableType ObjectReferences and access the Subscription data. This is not a real resource.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +SubscribableTypeSpec + + +      		 +

      SubscribableTypeSpec is the part where Subscribable object is +configured as to be compatible with Subscribable contract.

      +
      +
      + + + + + +
      +subscribable
      + + +Subscribable + + +      		 +
      +
      +status
      + + +SubscribableTypeStatus + + +      		 +

      SubscribableTypeStatus is the part where SubscribableStatus object is +configured as to be compatible with Subscribable contract.

      +
      +

      SubscribableTypeSpec +

      +

      +(Appears on: +ChannelableCombinedSpec, +ChannelableSpec, +SubscribableType) +

      +

      +

      SubscribableTypeSpec shows how we expect folks to embed Subscribable in their Spec field.

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +subscribable
      + + +Subscribable + + +      		 +
      +

      SubscribableTypeStatus +

      +

      +(Appears on: +ChannelStatus, +ChannelableCombinedStatus, +ChannelableStatus, +InMemoryChannelStatus, +SubscribableType) +

      +

      +

      SubscribableTypeStatus shows how we expect folks to embed Subscribable in their Status field.

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +subscribableStatus
      + + +SubscribableStatus + + +      		 +
      +

      SubscriberSpec +

      +

      +(Appears on: +Subscribable) +

      +

      +

      SubscriberSpec defines a single subscriber to a Subscribable. +Ref is a reference to the Subscription this SubscriberSpec was created for +SubscriberURI is the endpoint for the subscriber +ReplyURI is the endpoint for the reply +At least one of SubscriberURI and ReplyURI must be present

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +uid
      + +k8s.io/apimachinery/pkg/types.UID + +      		 +(Optional) +

      UID is used to understand the origin of the subscriber.

      +
      +generation
      + +int64 + +      		 +(Optional) +

      Generation of the origin of the subscriber with uid:UID.

      +
      +subscriberURI
      + +knative.dev/pkg/apis.URL + +      		 +(Optional) +
      +replyURI
      + +knative.dev/pkg/apis.URL + +      		 +(Optional) +
      +deadLetterSink
      + +knative.dev/pkg/apis.URL + +      		 +(Optional) +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +
      +

      SubscriberStatus +

      +

      +(Appears on: +SubscribableStatus) +

      +

      +

      SubscriberStatus defines the status of a single subscriber to a Channel.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +uid
      + +k8s.io/apimachinery/pkg/types.UID + +      		 +(Optional) +

      UID is used to understand the origin of the subscriber.

      +
      +observedGeneration
      + +int64 + +      		 +(Optional) +

      Generation of the origin of the subscriber with uid:UID.

      +
      +ready
      + + +Kubernetes core/v1.ConditionStatus + + +      		 +(Optional) +

      Status of the subscriber.

      +
      +message
      + +string + +      		 +(Optional) +

      A human readable message indicating details of Ready status.

      +
      +
      +

      eventing.knative.dev/v1alpha1

      +

      +

      Package v1alpha1 is the v1alpha1 version of the API.

      +

      +Resource Types: + +

      Broker +

      +

      +

      Broker collects a pool of events that are consumable using Triggers. Brokers +provide a well-known endpoint for event delivery that senders can use with +minimal knowledge of the event routing strategy. Receivers use Triggers to +request delivery of events from a Broker’s pool to a specific URL or +Addressable endpoint.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +eventing.knative.dev/v1alpha1 + +
      +kind
      +string +      		Broker
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +BrokerSpec + + +      		 +

      Spec defines the desired state of the Broker.

      +
      +
      + + + + + + + + + + + + + +
      +channelTemplateSpec
      + + +ChannelTemplateSpec + + +      		 +(Optional) +

      ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the +Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there +are no defaults for the namespace). +Deprecated: See spec.config to configure aditional broker options. +Unless class is for channel based broker implementation.

      +
      +config
      + +knative.dev/pkg/apis/duck/v1.KReference + +      		 +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap. +NOTE: this is for backwards compatibility with v1alpha1 <-> v1beta1 conversions.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      Delivery is the delivery specification to be used internally by the broker to +create subscriptions.

      +
      +
      +status
      + + +BrokerStatus + + +      		 +(Optional) +

      Status represents the current state of the Broker. This data may be out of +date.

      +
      +

      EventType +

      +

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +eventing.knative.dev/v1alpha1 + +
      +kind
      +string +      		EventType
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +EventTypeSpec + + +      		 +

      Spec defines the desired state of the EventType.

      +
      +
      + + + + + + + + + + + + + + + + + + + + + +
      +type
      + +string + +      		 +

      Type represents the CloudEvents type. It is authoritative.

      +
      +source
      + +string + +      		 +

      Source is a URI, it represents the CloudEvents source.

      +
      +schema
      + +string + +      		 +(Optional) +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.

      +
      +broker
      + +string + +      		 +

      Broker refers to the Broker that can provide the EventType.

      +
      +description
      + +string + +      		 +(Optional) +

      Description is an optional field used to describe the EventType, in any meaningful way.

      +
      +
      +status
      + + +EventTypeStatus + + +      		 +(Optional) +

      Status represents the current state of the EventType. +This data may be out of date.

      +
      +

      Trigger +

      +

      +

      Trigger represents a request to have events delivered to a consumer from a +Broker’s event pool.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +eventing.knative.dev/v1alpha1 + +
      +kind
      +string +      		Trigger
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +TriggerSpec + + +      		 +

      Spec defines the desired state of the Trigger.

      +
      +
      + + + + + + + + + + + + + +
      +broker
      + +string + +      		 +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.

      +
      +filter
      + + +TriggerFilter + + +      		 +(Optional) +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +
      +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.

      +
      +
      +status
      + + +TriggerStatus + + +      		 +(Optional) +

      Status represents the current state of the Trigger. This data may be out of +date.

      +
      +

      BrokerSpec +

      +

      +(Appears on: +Broker) +

      +

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +channelTemplateSpec
      + + +ChannelTemplateSpec + + +      		 +(Optional) +

      ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the +Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there +are no defaults for the namespace). +Deprecated: See spec.config to configure aditional broker options. +Unless class is for channel based broker implementation.

      +
      +config
      + +knative.dev/pkg/apis/duck/v1.KReference + +      		 +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap. +NOTE: this is for backwards compatibility with v1alpha1 <-> v1beta1 conversions.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      Delivery is the delivery specification to be used internally by the broker to +create subscriptions.

      +
      +

      BrokerStatus +

      +

      +(Appears on: +Broker) +

      +

      +

      BrokerStatus represents the current state of a Broker.

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +address
      + +knative.dev/pkg/apis/duck/v1alpha1.Addressable + +      		 +

      Broker 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 {broker}-router.{namespace}.svc.{cluster domain name}

      +
      +triggerChannel
      + + +Kubernetes core/v1.ObjectReference + + +      		 +

      TriggerChannel is an objectref to the object for the TriggerChannel

      +
      +

      EventTypeSpec +

      +

      +(Appears on: +EventType) +

      +

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +type
      + +string + +      		 +

      Type represents the CloudEvents type. It is authoritative.

      +
      +source
      + +string + +      		 +

      Source is a URI, it represents the CloudEvents source.

      +
      +schema
      + +string + +      		 +(Optional) +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.

      +
      +broker
      + +string + +      		 +

      Broker refers to the Broker that can provide the EventType.

      +
      +description
      + +string + +      		 +(Optional) +

      Description is an optional field used to describe the EventType, in any meaningful way.

      +
      +

      EventTypeStatus +

      +

      +(Appears on: +EventType) +

      +

      +

      EventTypeStatus represents the current state of a EventType.

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +

      TriggerFilter +

      +

      +(Appears on: +TriggerSpec) +

      +

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +sourceAndType
      + + +TriggerFilterSourceAndType + + +      		 +(Optional) +

      DeprecatedSourceAndType filters events based on exact matches on the +CloudEvents type and source attributes. This field has been replaced by the +Attributes field.

      +
      +attributes
      + + +TriggerFilterAttributes + + +      		 +(Optional) +

      Attributes filters events by exact match on event context attributes. +Each key in the map is compared with the equivalent key in the event +context. An event passes the filter if all values are equal to the +specified values.

      +

      Nested context attributes are not supported as keys. Only string values are supported.

      +
      +

      TriggerFilterAttributes +(map[string]string alias)

      +

      +(Appears on: +TriggerFilter) +

      +

      +

      TriggerFilterAttributes is a map of context attribute names to values for +filtering by equality. Only exact matches will pass the filter. You can use the value “ +to indicate all strings match.

      +

      +

      TriggerFilterSourceAndType +

      +

      +(Appears on: +TriggerFilter) +

      +

      +

      TriggerFilterSourceAndType filters events based on exact matches on the cloud event’s type and +source attributes. Only exact matches will pass the filter. Either or both type and source can +use the value “ to indicate all strings match.

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +type
      + +string + +      		 +
      +source
      + +string + +      		 +
      +

      TriggerSpec +

      +

      +(Appears on: +Trigger) +

      +

      +

      + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +broker
      + +string + +      		 +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.

      +
      +filter
      + + +TriggerFilter + + +      		 +(Optional) +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +
      +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.

      +
      +

      TriggerStatus +

      +

      +(Appears on: +Trigger) +

      +

      +

      TriggerStatus represents the current state of a Trigger.

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +subscriberURI
      + +knative.dev/pkg/apis.URL + +      		 +

      SubscriberURI is the resolved URI of the receiver for this Trigger.

      +
      +
      +

      eventing.knative.dev/v1beta1

      +

      +

      Package v1beta1 is the v1beta1 version of the API.

      +

      +Resource Types: + +

      Broker +

      +

      +

      Broker collects a pool of events that are consumable using Triggers. Brokers +provide a well-known endpoint for event delivery that senders can use with +minimal knowledge of the event routing strategy. Receivers use Triggers to +request delivery of events from a Broker’s pool to a specific URL or +Addressable endpoint.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +eventing.knative.dev/v1beta1 + +
      +kind
      +string +      		Broker
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +BrokerSpec + + +      		 +

      Spec defines the desired state of the Broker.

      +
      +
      + + + + + + + + + +
      +config
      + +knative.dev/pkg/apis/duck/v1.KReference + +      		 +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      Delivery is the delivery specification for Events within the Broker mesh. +This includes things like retries, DLQ, etc.

      +
      +
      +status
      + + +BrokerStatus + + +      		 +(Optional) +

      Status represents the current state of the Broker. This data may be out of +date.

      +
      +

      EventType +

      +

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +eventing.knative.dev/v1beta1 + +
      +kind
      +string +      		EventType
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +EventTypeSpec + + +      		 +

      Spec defines the desired state of the EventType.

      +
      +
      + + + + + + + + + + + + + + + + + + + + + +
      +type
      + +string + +      		 +

      Type represents the CloudEvents type. It is authoritative.

      +
      +source
      + +knative.dev/pkg/apis.URL + +      		 +

      Source is a URI, it represents the CloudEvents source.

      +
      +schema
      + +knative.dev/pkg/apis.URL + +      		 +(Optional) +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.

      +
      +broker
      + +string + +      		 +

      Broker refers to the Broker that can provide the EventType.

      +
      +description
      + +string + +      		 +(Optional) +

      Description is an optional field used to describe the EventType, in any meaningful way.

      +
      +
      +status
      + + +EventTypeStatus + + +      		 +(Optional) +

      Status represents the current state of the EventType. +This data may be out of date.

      +
      +

      Trigger +

      +

      +

      Trigger represents a request to have events delivered to a consumer from a +Broker’s event pool.

      +

      + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +apiVersion
      +string      		 + +eventing.knative.dev/v1beta1 + +
      +kind
      +string +      		Trigger
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +TriggerSpec + + +      		 +

      Spec defines the desired state of the Trigger.

      +
      +
      + + + + + + + + + + + + + +
      +broker
      + +string + +      		 +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.

      +
      +filter
      + + +TriggerFilter + + +      		 +(Optional) +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +
      +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.

      +
      +
      +status
      + + +TriggerStatus + + +      		 +(Optional) +

      Status represents the current state of the Trigger. This data may be out of +date.

      +
      +

      BrokerSpec +

      +

      +(Appears on: +Broker) +

      +

      +

      + + + + + + + + + +
      FieldDescription
      -args
      +config
      -[]string +knative.dev/pkg/apis/duck/v1.KReference       		-

      DeprecatedArgs are passed to the ContainerSpec as they are. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap.
      -env
      +delivery
      - -[]Kubernetes core/v1.EnvVar + +DeliverySpec       		(Optional) -

      DeprecatedEnv is the list of environment variables to set in the container. -Cannot be updated. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +

      Delivery is the delivery specification for Events within the Broker mesh. +This includes things like retries, DLQ, etc.
      +

      BrokerStatus +

      +

      +(Appears on: +Broker) +

      +

      +

      BrokerStatus represents the current state of a Broker.

      +

      + + + + + + + +
      FieldDescription
      -serviceAccountName
      +Status
      -string +knative.dev/pkg/apis/duck/v1.Status       		-(Optional) -

      DeprecatedServiceAccountName is the name of the ServiceAccount to use to run this -source. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -sink
      +address
      -knative.dev/pkg/apis/duck/v1beta1.Destination +knative.dev/pkg/apis/duck/v1.Addressable       		-

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +

      Broker is Addressable. It exposes the endpoint as an URI to get events +delivered into the Broker mesh.
      -

      ContainerSourceStatus +

      EventTypeSpec

      (Appears on: -ContainerSource) +EventType)

      -

      ContainerSourceStatus defines the observed state of ContainerSource

      @@ -3837,41 +7753,72 @@ knative.dev/pkg/apis/duck/v1beta1.Destination + + + + + + + + + + + +
      -Status
      +type
      -knative.dev/pkg/apis/duck/v1.Status +string       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Type represents the CloudEvents type. It is authoritative.
      -sinkUri
      +source
      + +knative.dev/pkg/apis.URL + +      		 +

      Source is a URI, it represents the CloudEvents source.

      +
      +schema
      + +knative.dev/pkg/apis.URL + +      		 +(Optional) +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.

      +
      +broker
      + +string + +      		 +

      Broker refers to the Broker that can provide the EventType.

      +
      +description
      string       		(Optional) -

      SinkURI is the current active sink URI that has been configured for the ContainerSource.

      +

      Description is an optional field used to describe the EventType, in any meaningful way.
      -

      CronJobLimitsSpec +

      EventTypeStatus

      (Appears on: -CronJobResourceSpec) +EventType)

      +

      EventTypeStatus represents the current state of a EventType.

      @@ -3883,31 +7830,74 @@ string + +
      -cpu
      +Status
      -string +knative.dev/pkg/apis/duck/v1.Status       		+

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      +

      TriggerFilter +

      +

      +(Appears on: +TriggerSpec) +

      +

      +

      + + + + + + + +
      FieldDescription
      -memory
      +attributes
      -string + +TriggerFilterAttributes +       		+(Optional) +

      Attributes filters events by exact match on event context attributes. +Each key in the map is compared with the equivalent key in the event +context. An event passes the filter if all values are equal to the +specified values.

      +

      Nested context attributes are not supported as keys. Only string values are supported.
      -

      CronJobRequestsSpec +

      TriggerFilterAttributes +(map[string]string alias)

      +

      +(Appears on: +TriggerFilter) +

      +

      +

      TriggerFilterAttributes is a map of context attribute names to values for +filtering by equality. Only exact matches will pass the filter. You can use the value “ +to indicate all strings match.

      +

      +

      TriggerSpec

      (Appears on: -CronJobResourceSpec) +Trigger)

      @@ -3921,33 +7911,53 @@ string -cpu
      +broker
      string +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.

      -memory
      +filter
      -string + +TriggerFilter + + + + +(Optional) +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      + + + + +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.

      -

      CronJobResourceSpec +

      TriggerStatus

      (Appears on: -CronJobSourceSpec) +Trigger)

      +

      TriggerStatus represents the current state of a Trigger.

      @@ -3959,38 +7969,45 @@ string
      -requests
      +Status
      - -CronJobRequestsSpec - +knative.dev/pkg/apis/duck/v1.Status       		+

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -limits
      +subscriberUri
      - -CronJobLimitsSpec - +knative.dev/pkg/apis.URL       		+

      SubscriberURI is the resolved URI of the receiver for this Trigger.
      -

      CronJobSourceSpec -

      +
      +

      flows.knative.dev/v1alpha1

      -(Appears on: -CronJobSource) +

      Package v1alpha1 is the v1alpha1 version of the API.

      +Resource Types: + +

      Parallel +

      -

      CronJobSourceSpec defines the desired state of the CronJobSource.

      +

      Parallel defines conditional branches that will be wired in +series through Channels and Subscriptions.

      @@ -4002,72 +8019,101 @@ CronJobLimitsSpec
      -schedule
      +metadata
      -string + +Kubernetes meta/v1.ObjectMeta +       		-

      Schedule is the cronjob schedule.

      +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -data
      +spec
      -string + +ParallelSpec +       		-

      Data is the data posted to the target function.

      +

      Spec defines the desired state of the Parallel.

      +
      +
      + + + + + +
      +branches
      + + +[]ParallelBranch + + +      		 +

      Branches is the list of Filter/Subscribers pairs.
      -sink
      +channelTemplate
      -knative.dev/pkg/apis/duck/v1beta1.Destination + +ChannelTemplateSpec +       		-

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -serviceAccountName
      +reply
      -string +knative.dev/pkg/apis/duck/v1.Destination       		-

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive -Adapter Deployment.

      +(Optional) +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply

      +
      -resources
      +status
      - -CronJobResourceSpec + +ParallelStatus       		-

      Resource limits and Request specifications of the Receive Adapter Deployment

      +(Optional) +

      Status represents the current state of the Parallel. This data may be out of +date.
      -

      CronJobSourceStatus +

      ParallelBranch

      (Appears on: -CronJobSource) +ParallelSpec)

      -

      CronJobSourceStatus defines the observed state of CronJobSource.

      @@ -4079,53 +8125,49 @@ CronJobResourceSpec + + + +
      -Status
      +filter
      -knative.dev/pkg/apis/duck/v1.Status +knative.dev/pkg/apis/duck/v1.Destination       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Filter is the expression guarding the branch
      -sinkUri
      +subscriber
      -string +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber receiving the event when the filter passes

      +
      +reply
      + +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      SinkURI is the current active sink URI that has been configured for the CronJobSource.

      +

      Reply is a Reference to where the result of Subscriber of this case gets sent to. +If not specified, sent the result to the Parallel Reply
      -

      Deprecated -

      -

      -(Appears on: -ApiServerSource, -ContainerSource, -CronJobSource, -SinkBinding) -

      -

      -

      -

      SinkBindingSpec +

      ParallelBranchStatus

      (Appears on: -SinkBinding) +ParallelStatus)

      -

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      +

      ParallelBranchStatus represents the current state of a Parallel branch

      @@ -4137,40 +8179,53 @@ string + + + +
      -SourceSpec
      +filterSubscriptionStatus
      -knative.dev/pkg/apis/duck/v1.SourceSpec + +ParallelSubscriptionStatus +       		-

      -(Members of SourceSpec are embedded into this type.) -

      +

      FilterSubscriptionStatus corresponds to the filter subscription status.
      -BindingSpec
      +filterChannelStatus
      -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +ParallelChannelStatus +       		-

      -(Members of BindingSpec are embedded into this type.) -

      +

      FilterChannelStatus corresponds to the filter channel status.

      +
      +subscriberSubscriptionStatus
      + + +ParallelSubscriptionStatus + + +      		 +

      SubscriptionStatus corresponds to the subscriber subscription status.
      -

      SinkBindingStatus +

      ParallelChannelStatus

      (Appears on: -SinkBinding) +ParallelBranchStatus, +ParallelStatus)

      -

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      @@ -4182,36 +8237,37 @@ knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + + + +
      -SourceStatus
      +channel
      -knative.dev/pkg/apis/duck/v1.SourceStatus + +Kubernetes core/v1.ObjectReference +       		-

      -(Members of SourceStatus are embedded into this type.) -

      +

      Channel is the reference to the underlying channel.

      +
      +ready
      + +knative.dev/pkg/apis.Condition + +      		 +

      ReadyCondition indicates whether the Channel is ready or not.
      -
      -

      messaging.knative.dev/v1alpha1

      +

      ParallelSpec +

      -

      Package v1alpha1 is the v1alpha1 version of the API.

      +(Appears on: +Parallel)

      -Resource Types: - -

      Channel -

      -

      Channel represents a generic Channel. It is normally used when we want a Channel, but don’t need a specific Channel implementation.

      @@ -4223,194 +8279,132 @@ Resource Types: - - - - - - - - -
      -apiVersion
      -string      		 - -messaging.knative.dev/v1alpha1 - -
      -kind
      -string -      		Channel
      -metadata
      +branches
      - -Kubernetes meta/v1.ObjectMeta + +[]ParallelBranch       		-(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Branches is the list of Filter/Subscribers pairs.
      -spec
      - - -ChannelSpec - - -      		 -

      Spec defines the desired state of the Channel.

      -
      -
      - - - - - - - - -
      channelTemplate
      - + ChannelTemplateSpec       		-

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. -This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      -
      -subscribable
      - - -Subscribable - - -      		 -

      Channel conforms to Duck type Subscribable.

      -
      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -status
      +reply
      - -ChannelStatus - +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Status represents the current state of the Channel. This data may be out of -date.

      +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply
      -

      InMemoryChannel +

      ParallelStatus

      -

      InMemoryChannel is a resource representing an in memory channel

      +(Appears on: +Parallel)

      - - - - - - - - - - - - - - - +

      +

      ParallelStatus represents the current state of a Parallel.

      +

      +
      FieldDescription
      -apiVersion
      -string      		 - -messaging.knative.dev/v1alpha1 - -
      -kind
      -string -      		InMemoryChannel
      + + + + + +
      FieldDescription
      -metadata
      +Status
      - -Kubernetes meta/v1.ObjectMeta - +knative.dev/pkg/apis/duck/v1.Status       		-(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -spec
      +ingressChannelStatus
      - -InMemoryChannelSpec + +ParallelChannelStatus       		-

      Spec defines the desired state of the Channel.

      -
      -
      - +

      IngressChannelStatus corresponds to the ingress channel status.

      + + - -
      -subscribable
      +branchStatuses
      - -Subscribable + +[]ParallelBranchStatus       		-

      Channel conforms to Duck type Subscribable.

      -
      +

      BranchStatuses is an array of corresponding to branch statuses. +Matches the Spec.Branches array in the order.
      -status
      +AddressStatus
      - -InMemoryChannelStatus - +knative.dev/pkg/apis/duck/v1.AddressStatus       		-(Optional) -

      Status represents the current state of the Channel. This data may be out of -date.

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the starting point to this Parallel. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}
      -

      Subscription +

      ParallelSubscriptionStatus

      -

      Subscription routes events received on a Channel to a DNS name and -corresponds to the subscriptions.channels.knative.dev CRD.

      +(Appears on: +ParallelBranchStatus) +

      +

      @@ -4422,21 +8416,44 @@ corresponds to the subscriptions.channels.knative.dev CRD.

      +subscription
      + + +Kubernetes core/v1.ObjectReference + + + - + + + +
      -apiVersion
      -string      		 - -messaging.knative.dev/v1alpha1 - +

      Subscription is the reference to the underlying Subscription.
      -kind
      -string +ready
      + +knative.dev/pkg/apis.Condition +       		Subscription +

      ReadyCondition indicates whether the Subscription is ready or not.

      +
      +

      Sequence +

      +

      +

      Sequence defines a sequence of Subscribers that will be wired in +series through Channels and Subscriptions.

      +

      + + + + + + + @@ -4455,116 +8473,126 @@ Refer to the Kubernetes API documentation for the fields of the + +
      FieldDescription
      metadata
      @@ -4447,6 +8464,7 @@ Kubernetes meta/v1.ObjectMeta       		+(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -SubscriptionSpec + +SequenceSpec       		+

      Spec defines the desired state of the Sequence.



      + +
      -generation
      +steps
      -int64 + +[]SequenceStep +       		-(Optional) -

      TODO By enabling the status subresource metadata.generation should increment -thus making this property obsolete.

      -

      We should be able to drop this property with a CRD conversion webhook -in the future

      +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided.
      -channel
      +channelTemplate
      - -Kubernetes core/v1.ObjectReference + +ChannelTemplateSpec       		-

      This field is immutable. We have no good answer on what happens to -the events that are currently in the channel being consumed from -and what the semantics there should be. For now, you can always -delete the Subscription and recreate it to point to a different -channel, giving the user more control over what semantics should -be used (drain the channel first, possibly have events dropped, -etc.)

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -subscriber
      +reply
      knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Subscriber is reference to (optional) function for processing events. -Events from the Channel will be delivered here and replies are -sent to a Destination as specified by the Reply.

      +

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +
      -reply
      +status
      -knative.dev/pkg/apis/duck/v1.Destination + +SequenceStatus +       		(Optional) -

      Reply specifies (optionally) how to handle events returned from -the Subscriber target.

      +

      Status represents the current state of the Sequence. This data may be out of +date.
      +

      SequenceChannelStatus +

      +

      +(Appears on: +SequenceStatus) +

      +

      +

      + + + + + + + + - -
      FieldDescription
      -delivery
      +channel
      - -DeliverySpec + +Kubernetes core/v1.ObjectReference       		-(Optional) -

      Delivery configuration

      -
      +

      Channel is the reference to the underlying channel.

      -status
      +ready
      - -SubscriptionStatus - +knative.dev/pkg/apis.Condition +

      ReadyCondition indicates whether the Channel is ready or not.

      -

      ChannelSpec +

      SequenceSpec

      (Appears on: -Channel) +Sequence)

      -

      ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. -It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.

      @@ -4576,41 +8604,55 @@ It also defines the ChannelTemplate to use in order to create the CRD Channel ba + + + +
      +steps
      + + +[]SequenceStep + + +      		 +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided.

      +
      channelTemplate
      - + ChannelTemplateSpec       		-

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. -This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -subscribable
      +reply
      - -Subscribable - +knative.dev/pkg/apis/duck/v1.Destination       		-

      Channel conforms to Duck type Subscribable.

      +(Optional) +

      Reply is a Reference to where the result of the last Subscriber gets sent to.
      -

      ChannelStatus +

      SequenceStatus

      (Appears on: -Channel) +Sequence)

      -

      ChannelStatus represents the current state of a Channel.

      +

      SequenceStatus represents the current state of a Sequence.

      @@ -4638,62 +8680,57 @@ knative.dev/pkg/apis/duck/v1.Status
      -AddressStatus
      +subscriptionStatuses
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus + +[]SequenceSubscriptionStatus +       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      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}

      +

      SubscriptionStatuses is an array of corresponding Subscription statuses. +Matches the Spec.Steps array in the order.
      -SubscribableTypeStatus
      +channelStatuses
      - -SubscribableTypeStatus + +[]SequenceChannelStatus       		-

      -(Members of SubscribableTypeStatus are embedded into this type.) -

      -

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      +

      ChannelStatuses is an array of corresponding Channel statuses. +Matches the Spec.Steps array in the order.
      -channel
      +AddressStatus
      - -Kubernetes core/v1.ObjectReference - +knative.dev/pkg/apis/duck/v1.AddressStatus       		-

      Channel is an ObjectReference to the Channel CRD backing this Channel.

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the starting point to this Sequence. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}
      -

      InMemoryChannelSpec +

      SequenceStep

      (Appears on: -InMemoryChannel) +SequenceSpec)

      -

      InMemoryChannelSpec defines which subscribers have expressed interest in -receiving events from this InMemoryChannel. -arguments for a Channel.

      @@ -4705,27 +8742,43 @@ arguments for a Channel.

      + + + +
      -subscribable
      +Destination
      - -Subscribable +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      +(Members of Destination are embedded into this type.) +

      +

      Subscriber receiving the step event

      +
      +delivery
      + + +DeliverySpec       		-

      Channel conforms to Duck type Subscribable.

      +(Optional) +

      Delivery is the delivery specification for events to the subscriber +This includes things like retries, DLQ, etc. +Needed for Roundtripping v1alpha1 <-> v1beta1.
      -

      InMemoryChannelStatus +

      SequenceSubscriptionStatus

      (Appears on: -InMemoryChannel) +SequenceStatus)

      -

      ChannelStatus represents the current state of a Channel.

      @@ -4737,60 +8790,47 @@ Subscribable - - - -
      -Status
      - -knative.dev/pkg/apis/duck/v1.Status - -      		 -

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      -
      -AddressStatus
      +subscription
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus + +Kubernetes core/v1.ObjectReference +       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      InMemoryChannel 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}

      +

      Subscription is the reference to the underlying Subscription.
      -SubscribableTypeStatus
      +ready
      - -SubscribableTypeStatus - +knative.dev/pkg/apis.Condition       		-

      -(Members of SubscribableTypeStatus are embedded into this type.) -

      -

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      +

      ReadyCondition indicates whether the Subscription is ready or not.
      -

      Parallel +
      +

      sources.knative.dev/v1alpha1

      +

      +

      Package v1alpha1 contains API Schema definitions for the sources v1alpha1 API group

      +

      +Resource Types: + +

      ApiServerSource

      -

      Parallel defines conditional branches that will be wired in -series through Channels and Subscriptions.

      +

      ApiServerSource is the Schema for the apiserversources API

      @@ -4802,6 +8842,23 @@ series through Channels and Subscriptions.

      + + + + + + + + @@ -4819,55 +8875,109 @@ Refer to the Kubernetes API documentation for the fields of the
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha1 + +
      +kind
      +string +      		ApiServerSource
      metadata
      @@ -4810,7 +8867,6 @@ Kubernetes meta/v1.ObjectMeta       		-(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -ParallelSpec + +ApiServerSourceSpec       		-

      Spec defines the desired state of the Parallel.



      + + + + + + + + + + + + + + + +
      -branches
      +resources
      - -[]ParallelBranch + +[]ApiServerResource       		-

      Branches is the list of Filter/Subscribers pairs.

      +

      Resources is the list of resources to watch
      -channelTemplate
      +serviceAccountName
      - -ChannelTemplateSpec +string + +      		 +(Optional) +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source.

      +
      +sink
      + +knative.dev/pkg/apis/duck/v1beta1.Destination + +      		 +(Optional) +

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +
      +ceOverrides
      + +knative.dev/pkg/apis/duck/v1.CloudEventOverrides + +      		 +(Optional) +

      CloudEventOverrides defines overrides to control the output format and +modifications of the event sent to the sink.

      +
      +selector
      + + +Kubernetes meta/v1.LabelSelector       		(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      LabelSelector filters this source to objects to those resources pass the +label selector. +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
      -reply
      +owner
      -knative.dev/pkg/apis/duck/v1.Destination + +APIVersionKind +       		(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      +

      ResourceOwner is an additional filter to only track resources that are +owned by a specific resource type. If ResourceOwner matches Resources[n] +then Resources[n] is allowed to pass the ResourceOwner filter.

      +
      +mode
      + +string + +      		 +

      Mode is the mode the receive adapter controller runs under: Ref or Resource. +Ref sends only the reference to the resource. +Resource send the full resource.
      @@ -4877,26 +8987,20 @@ when the case does not have a Reply

      		 status
      - -ParallelStatus + +ApiServerSourceStatus       		-(Optional) -

      Status represents the current state of the Parallel. This data may be out of -date.
      -

      ParallelBranch +

      PingSource

      -(Appears on: -ParallelSpec) -

      -

      +

      PingSource is the Schema for the PingSources API.

      @@ -4904,111 +9008,151 @@ date.

      - - + + + + + + + + + + + + + + + + +
      Field Description
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha1 + +
      +kind
      +string +      		PingSource
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +PingSourceSpec + + +      		 +
      +
      + + + + + - -
      +schedule
      + +string + +      		 +

      Schedule is the cronjob schedule.

      +
      -filter
      +data
      -knative.dev/pkg/apis/duck/v1.Destination +string       		-

      Filter is the expression guarding the branch

      +

      Data is the data posted to the target function.
      -subscriber
      +sink
      knative.dev/pkg/apis/duck/v1.Destination       		-

      Subscriber receiving the event when the filter passes

      +

      Sink is a reference to an object that will resolve to a uri to use as the sink.
      -reply
      +ceOverrides
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1.CloudEventOverrides       		(Optional) -

      Reply is a Reference to where the result of Subscriber of this case gets sent to. -If not specified, sent the result to the Parallel Reply

      +

      CloudEventOverrides defines overrides to control the output format and +modifications of the event sent to the sink.
      -

      ParallelBranchStatus -

      -

      -(Appears on: -ParallelStatus) -

      -

      -

      ParallelBranchStatus represents the current state of a Parallel branch

      -

      - - - - - - - - + +
      FieldDescription
      -filterSubscriptionStatus
      +serviceAccountName
      - -ParallelSubscriptionStatus - +string       		-

      FilterSubscriptionStatus corresponds to the filter subscription status.

      +

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive +Adapter Deployment. +Deprecated: v1beta1 drops this field.
      -filterChannelStatus
      +resources
      - -ParallelChannelStatus + +PingResourceSpec       		-

      FilterChannelStatus corresponds to the filter channel status.

      +

      Resource limits and Request specifications of the Receive Adapter Deployment +Deprecated: v1beta1 drops this field.

      +
      -subscriberSubscriptionStatus
      +status
      - -ParallelSubscriptionStatus + +PingSourceStatus       		-

      SubscriptionStatus corresponds to the subscriber subscription status.
      -

      ParallelChannelStatus +

      SinkBinding

      -(Appears on: -ParallelBranchStatus, -ParallelStatus) -

      -

      +

      SinkBinding describes a Binding that is also a Source. +The sink (from the Source duck) is resolved to a URL and +then projected into the subject by augmenting the runtime +contract of the referenced containers to have a K_SINK +environment variable holding the endpoint to which to send +cloud events.

      @@ -5020,97 +9164,99 @@ ParallelSubscriptionStatus + + + + + + + + - - -
      -channel
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha1 + +
      +kind
      +string +      		SinkBinding
      +metadata
      - -Kubernetes core/v1.ObjectReference + +Kubernetes meta/v1.ObjectMeta       		-

      Channel is the reference to the underlying channel.

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -ready
      +spec
      -knative.dev/pkg/apis.Condition + +SinkBindingSpec +       		-

      ReadyCondition indicates whether the Channel is ready or not.

      -
      -

      ParallelSpec -

      -

      -(Appears on: -Parallel) -

      -

      -

      +
      +
      - - - - - - - + +
      FieldDescription
      -branches
      +SourceSpec
      - -[]ParallelBranch - +knative.dev/pkg/apis/duck/v1.SourceSpec       		-

      Branches is the list of Filter/Subscribers pairs.

      +

      +(Members of SourceSpec are embedded into this type.) +
      -channelTemplate
      +BindingSpec
      - -ChannelTemplateSpec - +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      +(Members of BindingSpec are embedded into this type.) +

      +
      -reply
      +status
      -knative.dev/pkg/apis/duck/v1.Destination + +SinkBindingStatus + -(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      -

      ParallelStatus +

      ApiServerResource

      (Appears on: -Parallel) +ApiServerSourceSpec)

      -

      ParallelStatus represents the current state of a Parallel.

      +

      ApiServerResource defines the resource to watch

      @@ -5122,72 +9268,82 @@ when the case does not have a Reply

      + + + +
      -Status
      +apiVersion
      -knative.dev/pkg/apis/duck/v1.Status +string       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      API version of the resource to watch.
      -ingressChannelStatus
      +kind
      - -ParallelChannelStatus +string + +      		 +

      Kind of the resource to watch. +More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

      +
      +labelSelector
      + + +Kubernetes meta/v1.LabelSelector       		-

      IngressChannelStatus corresponds to the ingress channel status.

      +

      LabelSelector restricts this source to objects with the selected labels +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors +Deprecated: Per-resource label selectors will no longer be supported in +v1alpha2, please use Spec.LabelSelector.
      -branchStatuses
      +controllerSelector
      - -[]ParallelBranchStatus + +Kubernetes meta/v1.OwnerReference       		-

      BranchStatuses is an array of corresponding to branch statuses. -Matches the Spec.Branches array in the order.

      +

      ControllerSelector restricts this source to objects with a controlling owner reference of the specified kind. +Only apiVersion and kind are used. Both are optional. +Deprecated: Per-resource owner refs will no longer be supported in +v1alpha2, please use Spec.Owner as a GKV.
      -AddressStatus
      +controller
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus +bool       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Parallel. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      +

      If true, send an event referencing the object controlling the resource +Deprecated: Per-resource controller flag will no longer be supported in +v1alpha2, please use Spec.Owner as a GKV.
      -

      ParallelSubscriptionStatus +

      ApiServerSourceSpec

      (Appears on: -ParallelBranchStatus) +ApiServerSource)

      +

      ApiServerSourceSpec defines the desired state of ApiServerSource

      @@ -5199,139 +9355,110 @@ It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      - -
      -subscription
      +resources
      - -Kubernetes core/v1.ObjectReference + +[]ApiServerResource       		-

      Subscription is the reference to the underlying Subscription.

      +

      Resources is the list of resources to watch
      -ready
      +serviceAccountName
      -knative.dev/pkg/apis.Condition +string       		-

      ReadyCondition indicates whether the Subscription is ready or not.

      +(Optional) +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source.
      -

      Sequence -

      -

      -

      Sequence defines a sequence of Subscribers that will be wired in -series through Channels and Subscriptions.

      -

      - - - - - - - - -
      FieldDescription
      -metadata
      +sink
      - -Kubernetes meta/v1.ObjectMeta - +knative.dev/pkg/apis/duck/v1beta1.Destination       		(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -spec
      - - -SequenceSpec - - -      		 -

      Spec defines the desired state of the Sequence.

      -
      -
      - - - - -
      -steps
      +ceOverrides
      -[]knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1.CloudEventOverrides       		-

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided.

      +(Optional) +

      CloudEventOverrides defines overrides to control the output format and +modifications of the event sent to the sink.
      -channelTemplate
      +selector
      - -ChannelTemplateSpec + +Kubernetes meta/v1.LabelSelector       		(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      LabelSelector filters this source to objects to those resources pass the +label selector. +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
      -reply
      +owner
      -knative.dev/pkg/apis/duck/v1.Destination + +APIVersionKind +       		(Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      -
      +

      ResourceOwner is an additional filter to only track resources that are +owned by a specific resource type. If ResourceOwner matches Resources[n] +then Resources[n] is allowed to pass the ResourceOwner filter.
      -status
      +mode
      - -SequenceStatus - +string       		-(Optional) -

      Status represents the current state of the Sequence. This data may be out of -date.

      +

      Mode is the mode the receive adapter controller runs under: Ref or Resource. +Ref sends only the reference to the resource. +Resource send the full resource.
      -

      SequenceChannelStatus +

      ApiServerSourceStatus

      (Appears on: -SequenceStatus) +ApiServerSource)

      +

      ApiServerSourceStatus defines the observed state of ApiServerSource

      @@ -5343,35 +9470,31 @@ date.

      - - - -
      -channel
      - - -Kubernetes core/v1.ObjectReference - - -      		 -

      Channel is the reference to the underlying channel.

      -
      -ready
      +SourceStatus
      -knative.dev/pkg/apis.Condition +knative.dev/pkg/apis/duck/v1.SourceStatus       		-

      ReadyCondition indicates whether the Channel is ready or not.

      +

      +(Members of SourceStatus are embedded into this type.) +

      +

      inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.
      -

      SequenceSpec +

      PingLimitsSpec

      (Appears on: -Sequence) +PingResourceSpec)

      @@ -5385,53 +9508,33 @@ knative.dev/pkg/apis.Condition -steps
      - -[]knative.dev/pkg/apis/duck/v1.Destination - - - -

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided.

      - - - - -channelTemplate
      +cpu
      - -ChannelTemplateSpec - +string -(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      -reply
      +memory
      -knative.dev/pkg/apis/duck/v1.Destination +string -(Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      -

      SequenceStatus +

      PingRequestsSpec

      (Appears on: -Sequence) +PingResourceSpec)

      -

      SequenceStatus represents the current state of a Sequence.

      @@ -5443,71 +9546,31 @@ knative.dev/pkg/apis/duck/v1.Destination - - - - - - - -
      -Status
      - -knative.dev/pkg/apis/duck/v1.Status - -      		 -

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      -
      -subscriptionStatuses
      - - -[]SequenceSubscriptionStatus - - -      		 -

      SubscriptionStatuses is an array of corresponding Subscription statuses. -Matches the Spec.Steps array in the order.

      -
      -channelStatuses
      +cpu
      - -[]SequenceChannelStatus - +string       		-

      ChannelStatuses is an array of corresponding Channel statuses. -Matches the Spec.Steps array in the order.
      -AddressStatus
      +memory
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus +string       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Sequence. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}
      -

      SequenceSubscriptionStatus +

      PingResourceSpec

      (Appears on: -SequenceStatus) +PingSourceSpec)

      @@ -5521,49 +9584,38 @@ It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      -subscription
      +requests
      - -Kubernetes core/v1.ObjectReference + +PingRequestsSpec -

      Subscription is the reference to the underlying Subscription.

      -ready
      +limits
      -knative.dev/pkg/apis.Condition + +PingLimitsSpec + -

      ReadyCondition indicates whether the Subscription is ready or not.

      -

      SubscriptionSpec +

      PingSourceSpec

      (Appears on: -Subscription) +PingSource)

      -

      SubscriptionSpec specifies the Channel for incoming events, a Subscriber target -for processing those events and where to put the result of the processing. Only -From (where the events are coming from) is always required. You can optionally -only Process the events (results in no output events) by leaving out the Result. -You can also perform an identity transformation on the incoming events by leaving -out the Subscriber and only specifying Result.

      -

      The following are all valid specifications: -channel –[subscriber]–> reply -Sink, no outgoing events: -channel – subscriber -no-op function (identity transformation): -channel –> reply

      +

      PingSourceSpec defines the desired state of the PingSource.

      @@ -5575,89 +9627,87 @@ channel –> reply

      + + + +
      -generation
      +schedule
      -int64 +string       		-(Optional) -

      TODO By enabling the status subresource metadata.generation should increment -thus making this property obsolete.

      -

      We should be able to drop this property with a CRD conversion webhook -in the future

      +

      Schedule is the cronjob schedule.
      -channel
      +data
      - -Kubernetes core/v1.ObjectReference - +string       		-

      This field is immutable. We have no good answer on what happens to -the events that are currently in the channel being consumed from -and what the semantics there should be. For now, you can always -delete the Subscription and recreate it to point to a different -channel, giving the user more control over what semantics should -be used (drain the channel first, possibly have events dropped, -etc.)

      +

      Data is the data posted to the target function.
      -subscriber
      +sink
      knative.dev/pkg/apis/duck/v1.Destination       		-(Optional) -

      Subscriber is reference to (optional) function for processing events. -Events from the Channel will be delivered here and replies are -sent to a Destination as specified by the Reply.

      +

      Sink is a reference to an object that will resolve to a uri to use as the sink.
      -reply
      +ceOverrides
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1.CloudEventOverrides       		(Optional) -

      Reply specifies (optionally) how to handle events returned from -the Subscriber target.

      +

      CloudEventOverrides defines overrides to control the output format and +modifications of the event sent to the sink.
      -delivery
      +serviceAccountName
      - -DeliverySpec +string + +      		 +

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive +Adapter Deployment. +Deprecated: v1beta1 drops this field.

      +
      +resources
      + + +PingResourceSpec       		-(Optional) -

      Delivery configuration

      +

      Resource limits and Request specifications of the Receive Adapter Deployment +Deprecated: v1beta1 drops this field.
      -

      SubscriptionStatus +

      PingSourceStatus

      (Appears on: -Subscription) +PingSource)

      -

      SubscriptionStatus (computed) for a subscription

      +

      PingSourceStatus defines the observed state of PingSource.

      @@ -5685,28 +9735,26 @@ knative.dev/pkg/apis/duck/v1.Status
      -physicalSubscription
      +sinkUri
      - -SubscriptionStatusPhysicalSubscription - +knative.dev/pkg/apis.URL       		-

      PhysicalSubscription is the fully resolved values that this Subscription represents.

      +(Optional) +

      SinkURI is the current active sink URI that has been configured for the PingSource.
      -

      SubscriptionStatusPhysicalSubscription +

      SinkBindingSpec

      (Appears on: -SubscriptionStatus) +SinkBinding)

      -

      SubscriptionStatusPhysicalSubscription represents the fully resolved values for this -Subscription.

      +

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      @@ -5718,35 +9766,60 @@ Subscription.

      + +
      -subscriberURI
      +SourceSpec
      -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1.SourceSpec       		-

      SubscriberURI is the fully resolved URI for spec.subscriber.

      +

      +(Members of SourceSpec are embedded into this type.) +
      -replyURI
      +BindingSpec
      -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec       		-

      ReplyURI is the fully resolved URI for the spec.reply.

      +

      +(Members of BindingSpec are embedded into this type.) +
      +

      SinkBindingStatus +

      +

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      +

      + + + + + + + + @@ -5754,5 +9827,5 @@ knative.dev/pkg/apis.URL

      Generated with gen-crd-api-reference-docs -on git commit 8a92a8c9. +on git commit 200ea1ae.

      From 0f37e7f8ed82498fb0e76ea5303d6f42ab994366 Mon Sep 17 00:00:00 2001 From: Ellen Evans Date: Tue, 3 Mar 2020 15:57:36 -0800 Subject: [PATCH 2/3] Adding updated eventing.md file for v0.13.0 --- docs/reference/eventing/eventing.md | 7718 +++++++++++++-------------- 1 file changed, 3859 insertions(+), 3859 deletions(-) diff --git a/docs/reference/eventing/eventing.md b/docs/reference/eventing/eventing.md index 4ff0b9a7520..e3163febf66 100644 --- a/docs/reference/eventing/eventing.md +++ b/docs/reference/eventing/eventing.md @@ -1,22 +1,19 @@

      Packages:

      -

      messaging.knative.dev/v1beta1

      +

      configs.internal.knative.dev/v1alpha1

      -

      Package v1beta1 is the v1beta1 version of the API.

      +

      Package v1alpha1 is the v1alpha1 version of the API.

      Resource Types: -

      Channel +

      ConfigMapPropagation

      -

      Channel represents a generic Channel. It is normally used when we want a Channel, but don’t need a specific Channel implementation.

      +

      ConfigMapPropagation is used to propagate configMaps from original namespace to current namespace

      FieldDescription
      -deadLetterSinkURI
      +SourceStatus
      -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1.SourceStatus       		-

      ReplyURI is the fully resolved URI for the spec.delivery.deadLetterSink.

      +

      +(Members of SourceStatus are embedded into this type.) +
      @@ -68,7 +64,7 @@ Resource Types: string @@ -77,7 +73,7 @@ messaging.knative.dev/v1beta1 kind
      string - +
      -messaging.knative.dev/v1beta1 +configs.internal.knative.dev/v1alpha1
      ChannelConfigMapPropagation
      @@ -98,44 +94,39 @@ Refer to the Kubernetes API documentation for the fields of the spec
      - -ChannelSpec + +ConfigMapPropagationSpec       		-

      Spec defines the desired state of the Channel.

      +

      Spec defines the desired state of the ConfigMapPropagation



      -channelTemplate
      +originalNamespace
      - -ChannelTemplateSpec - +string       		-

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. -This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      +

      OriginalNamespace is the namespace where the original configMaps are in
      -ChannelableSpec
      +selector
      - -ChannelableSpec + +Kubernetes meta/v1.LabelSelector       		-

      -(Members of ChannelableSpec are embedded into this type.) -

      -

      Channel conforms to ChannelableSpec

      +(Optional) +

      Selector only selects original configMaps with corresponding labels
      @@ -145,23 +136,26 @@ ChannelableSpec       		status
      - -ChannelStatus + +ConfigMapPropagationStatus       		(Optional) -

      Status represents the current state of the Channel. This data may be out of -date.

      +

      Status represents the current state of the EventType. +This data may be out of date.
      -

      InMemoryChannel +

      ConfigMapPropagationSpec

      -

      InMemoryChannel is a resource representing an in memory channel

      +(Appears on: +ConfigMapPropagation) +

      +

      @@ -173,91 +167,88 @@ date.

      - - - - - - - +
      -apiVersion
      -string      		 - -messaging.knative.dev/v1beta1 - +originalNamespace
      + +string +
      -kind
      -string +

      OriginalNamespace is the namespace where the original configMaps are in

      		InMemoryChannel
      -metadata
      +selector
      - -Kubernetes meta/v1.ObjectMeta + +Kubernetes meta/v1.LabelSelector       		(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Selector only selects original configMaps with corresponding labels
      -spec
      - - -InMemoryChannelSpec - - -      		 -

      Spec defines the desired state of the Channel.

      -
      -
      +
      +

      ConfigMapPropagationStatus +

      +

      +(Appears on: +ConfigMapPropagation) +

      +

      +

      ConfigMapPropagationStatus represents the current state of a ConfigMapPropagation.

      +

      + + + + + + + - -
      FieldDescription
      -ChannelableSpec
      +Status
      - -ChannelableSpec - +knative.dev/pkg/apis/duck/v1.Status

      -(Members of ChannelableSpec are embedded into this type.) +(Members of Status are embedded into this type.)

      -

      Channel conforms to Duck type Channelable.

      -
      +

      inherits duck/v1 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.

      -status
      +copyConfigmaps
      - -InMemoryChannelStatus + +[]ConfigMapPropagationStatusCopyConfigMap (Optional) -

      Status represents the current state of the Channel. This data may be out of -date.

      +

      CopyConfigMaps is the status for each copied configmap.

      -

      Subscription +

      ConfigMapPropagationStatusCopyConfigMap

      -

      Subscription routes events received on a Channel to a DNS name and -corresponds to the subscriptions.channels.knative.dev CRD.

      +(Appears on: +ConfigMapPropagationStatus) +

      +

      +

      ConfigMapPropagationStatusCopyConfigMap represents the status of a copied configmap

      @@ -269,808 +260,93 @@ corresponds to the subscriptions.channels.knative.dev CRD.

      - - - - - - - - - - - - - - -
      -apiVersion
      -string      		 - -messaging.knative.dev/v1beta1 - -
      -kind
      -string -      		Subscription
      -metadata
      +name
      - -Kubernetes meta/v1.ObjectMeta - +string       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Name is copy configmap’s name
      -spec
      +source
      - -SubscriptionSpec - +string       		-
      -
      - +

      Source is “originalNamespace/originalConfigMapName”

      + + +
      -channel
      +operation
      - -Kubernetes core/v1.ObjectReference - +string       		-

      Reference to a channel that will be used to create the subscription -You can specify only the following fields of the ObjectReference: -- Kind -- APIVersion -- Name -The resource pointed by this ObjectReference must meet the -contract to the ChannelableSpec duck type. If the resource does not -meet this contract it will be reflected in the Subscription’s status.

      -

      This field is immutable. We have no good answer on what happens to -the events that are currently in the channel being consumed from -and what the semantics there should be. For now, you can always -delete the Subscription and recreate it to point to a different -channel, giving the user more control over what semantics should -be used (drain the channel first, possibly have events dropped, -etc.)

      +

      Operation represents the operation CMP takes for this configmap. The operations are copy|delete|stop
      -subscriber
      +ready
      -knative.dev/pkg/apis/duck/v1.Destination +string       		-(Optional) -

      Subscriber is reference to (optional) function for processing events. -Events from the Channel will be delivered here and replies are -sent to a Destination as specified by the Reply.

      +

      Ready represents the operation is ready or not
      -reply
      +reason
      -knative.dev/pkg/apis/duck/v1.Destination +string       		-(Optional) -

      Reply specifies (optionally) how to handle events returned from -the Subscriber target.

      +

      Reason indicates reasons if the operation is not ready
      -delivery
      +resourceVersionFromSource
      - -DeliverySpec - +string       		-(Optional) -

      Delivery configuration

      +

      ResourceVersion is the resourceVersion of original configmap
      -
      -status
      - - -SubscriptionStatus - - -      		 -
      -

      ChannelDefaulter -

      -

      -

      ChannelDefaulter sets the default Channel CRD and Arguments on Channels that do not -specify any implementation.

      -

      -

      ChannelSpec -

      -

      -(Appears on: -Channel) -

      -

      -

      ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. -It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.

      -

      - - - - - - - - - - - - - - - - - -
      FieldDescription
      -channelTemplate
      - - -ChannelTemplateSpec - - -      		 -

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. -This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      -
      -ChannelableSpec
      - - -ChannelableSpec - - -      		 -

      -(Members of ChannelableSpec are embedded into this type.) -

      -

      Channel conforms to ChannelableSpec

      -
      -

      ChannelStatus -

      -

      -(Appears on: -Channel) -

      -

      -

      ChannelStatus represents the current state of a Channel.

      -

      - - - - - - - - - - - - - - - - - -
      FieldDescription
      -ChannelableStatus
      - - -ChannelableStatus - - -      		 -

      -(Members of ChannelableStatus are embedded into this type.) -

      -

      Channel conforms to ChannelableStatus

      -
      -channel
      - -knative.dev/pkg/apis/duck/v1.KReference - -      		 -

      Channel is an KReference to the Channel CRD backing this Channel.

      -
      -

      ChannelTemplateSpec -

      -

      -(Appears on: -BrokerSpec, -ChannelSpec, -ChannelSpec, -ParallelSpec, -ParallelSpec, -SequenceSpec, -SequenceSpec) -

      -

      -

      - - - - - - - - - - - - - -
      FieldDescription
      -spec
      - -k8s.io/apimachinery/pkg/runtime.RawExtension - -      		 -(Optional) -

      Spec defines the Spec to use for each channel created. Passed -in verbatim to the Channel CRD as Spec section.

      -
      -
      - -
      -
      -

      ChannelTemplateSpecInternal -

      -

      -

      ChannelTemplateSpecInternal is an internal only version that includes ObjectMeta so that -we can easily create new Channels off of it.

      -

      - - - - - - - - - - - - - - - - - -
      FieldDescription
      -metadata
      - - -Kubernetes meta/v1.ObjectMeta - - -      		 -(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
      -spec
      - -k8s.io/apimachinery/pkg/runtime.RawExtension - -      		 -(Optional) -

      Spec defines the Spec to use for each channel created. Passed -in verbatim to the Channel CRD as Spec section.

      -
      -
      - -
      -
      -

      InMemoryChannelSpec -

      -

      -(Appears on: -InMemoryChannel) -

      -

      -

      InMemoryChannelSpec defines which subscribers have expressed interest in -receiving events from this InMemoryChannel. -arguments for a Channel.

      -

      - - - - - - - - - - - - - -
      FieldDescription
      -ChannelableSpec
      - - -ChannelableSpec - - -      		 -

      -(Members of ChannelableSpec are embedded into this type.) -

      -

      Channel conforms to Duck type Channelable.

      -
      -

      InMemoryChannelStatus -

      -

      -(Appears on: -InMemoryChannel) -

      -

      -

      ChannelStatus represents the current state of a Channel.

      -

      - - - - - - - - - - - - - -
      FieldDescription
      -ChannelableStatus
      - - -ChannelableStatus - - -      		 -

      -(Members of ChannelableStatus are embedded into this type.) -

      -

      Channel conforms to Duck type Channelable.

      -
      -

      SubscriptionSpec -

      -

      -(Appears on: -Subscription) -

      -

      -

      SubscriptionSpec specifies the Channel for incoming events, a Subscriber target -for processing those events and where to put the result of the processing. Only -From (where the events are coming from) is always required. You can optionally -only Process the events (results in no output events) by leaving out the Result. -You can also perform an identity transformation on the incoming events by leaving -out the Subscriber and only specifying Result.

      -

      The following are all valid specifications: -channel –[subscriber]–> reply -Sink, no outgoing events: -channel – subscriber -no-op function (identity transformation): -channel –> reply

      -

      - - - - - - - - - - - - - - - - - - - - - - - - - -
      FieldDescription
      -channel
      - - -Kubernetes core/v1.ObjectReference - - -      		 -

      Reference to a channel that will be used to create the subscription -You can specify only the following fields of the ObjectReference: -- Kind -- APIVersion -- Name -The resource pointed by this ObjectReference must meet the -contract to the ChannelableSpec duck type. If the resource does not -meet this contract it will be reflected in the Subscription’s status.

      -

      This field is immutable. We have no good answer on what happens to -the events that are currently in the channel being consumed from -and what the semantics there should be. For now, you can always -delete the Subscription and recreate it to point to a different -channel, giving the user more control over what semantics should -be used (drain the channel first, possibly have events dropped, -etc.)

      -
      -subscriber
      - -knative.dev/pkg/apis/duck/v1.Destination - -      		 -(Optional) -

      Subscriber is reference to (optional) function for processing events. -Events from the Channel will be delivered here and replies are -sent to a Destination as specified by the Reply.

      -
      -reply
      - -knative.dev/pkg/apis/duck/v1.Destination - -      		 -(Optional) -

      Reply specifies (optionally) how to handle events returned from -the Subscriber target.

      -
      -delivery
      - - -DeliverySpec - - -      		 -(Optional) -

      Delivery configuration

      -
      -

      SubscriptionStatus -

      -

      -(Appears on: -Subscription) -

      -

      -

      SubscriptionStatus (computed) for a subscription

      -

      - - - - - - - - - - - - - - - - - -
      FieldDescription
      -Status
      - -knative.dev/pkg/apis/duck/v1.Status - -      		 -

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      -
      -physicalSubscription
      - - -SubscriptionStatusPhysicalSubscription - - -      		 -

      PhysicalSubscription is the fully resolved values that this Subscription represents.

      -
      -

      SubscriptionStatusPhysicalSubscription -

      -

      -(Appears on: -SubscriptionStatus) -

      -

      -

      SubscriptionStatusPhysicalSubscription represents the fully resolved values for this -Subscription.

      -

      - - - - - - - - - - - - - - - - - - - - - -
      FieldDescription
      -subscriberUri
      - -knative.dev/pkg/apis.URL - -      		 -

      SubscriberURI is the fully resolved URI for spec.subscriber.

      -
      -replyUri
      - -knative.dev/pkg/apis.URL - -      		 -

      ReplyURI is the fully resolved URI for the spec.reply.

      -
      -deadLetterSinkUri
      - -knative.dev/pkg/apis.URL - -      		 -

      ReplyURI is the fully resolved URI for the spec.delivery.deadLetterSink.

      -
      -
      -

      configs.internal.knative.dev/v1alpha1

      -

      -

      Package v1alpha1 is the v1alpha1 version of the API.

      -

      -Resource Types: - -

      ConfigMapPropagation -

      -

      -

      ConfigMapPropagation is used to propagate configMaps from original namespace to current namespace

      -

      - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
      FieldDescription
      -apiVersion
      -string      		 - -configs.internal.knative.dev/v1alpha1 - -
      -kind
      -string -      		ConfigMapPropagation
      -metadata
      - - -Kubernetes meta/v1.ObjectMeta - - -      		 -(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
      -spec
      - - -ConfigMapPropagationSpec - - -      		 -

      Spec defines the desired state of the ConfigMapPropagation

      -
      -
      - - - - - - - - - -
      -originalNamespace
      - -string - -      		 -

      OriginalNamespace is the namespace where the original configMaps are in

      -
      -selector
      - - -Kubernetes meta/v1.LabelSelector - - -      		 -(Optional) -

      Selector only selects original configMaps with corresponding labels

      -
      -
      -status
      - - -ConfigMapPropagationStatus - - -      		 -(Optional) -

      Status represents the current state of the EventType. -This data may be out of date.

      -
      -

      ConfigMapPropagationSpec -

      -

      -(Appears on: -ConfigMapPropagation) -

      -

      -

      - - - - - - - - - - - - - - - - - -
      FieldDescription
      -originalNamespace
      - -string - -      		 -

      OriginalNamespace is the namespace where the original configMaps are in

      -
      -selector
      - - -Kubernetes meta/v1.LabelSelector - - -      		 -(Optional) -

      Selector only selects original configMaps with corresponding labels

      -
      -

      ConfigMapPropagationStatus -

      -

      -(Appears on: -ConfigMapPropagation) -

      -

      -

      ConfigMapPropagationStatus represents the current state of a ConfigMapPropagation.

      -

      - - - - - - - - - - - - - - - - - -
      FieldDescription
      -Status
      - -knative.dev/pkg/apis/duck/v1.Status - -      		 +
      +

      eventing.knative.dev/v1alpha1

      -(Members of Status are embedded into this type.) +

      Package v1alpha1 is the v1alpha1 version of the API.

      -

      inherits duck/v1 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.

      -
      -copyConfigmaps
      - - -[]ConfigMapPropagationStatusCopyConfigMap - - -      		 -(Optional) -

      CopyConfigMaps is the status for each copied configmap.

      -
      -

      ConfigMapPropagationStatusCopyConfigMap +Resource Types: + +

      Broker

      -(Appears on: -ConfigMapPropagationStatus) -

      -

      -

      ConfigMapPropagationStatusCopyConfigMap represents the status of a copied configmap

      +

      Broker collects a pool of events that are consumable using Triggers. Brokers +provide a well-known endpoint for event delivery that senders can use with +minimal knowledge of the event routing strategy. Receivers use Triggers to +request delivery of events from a Broker’s pool to a specific URL or +Addressable endpoint.

      @@ -1082,103 +358,21 @@ knative.dev/pkg/apis/duck/v1.Status - - - - - - - - - - - - - - - - +apiVersion
      +string - + - -
      -name
      - -string - -      		 -

      Name is copy configmap’s name

      -
      -source
      - -string - -      		 -

      Source is “originalNamespace/originalConfigMapName”

      -
      -operation
      - -string - -      		 -

      Operation represents the operation CMP takes for this configmap. The operations are copy|delete|stop

      -
      -ready
      - -string - -      		 -

      Ready represents the operation is ready or not

      -
      -reason
      - -string - -      		 -

      Reason indicates reasons if the operation is not ready

      + +eventing.knative.dev/v1alpha1 +
      -resourceVersionFromSource
      - +kind
      string -       -      		 -

      ResourceVersion is the resourceVersion of original configmap

      		Broker
      -
      -

      duck.knative.dev/v1beta1

      -

      -

      Package v1beta1 is the v1beta1 version of the API.

      -

      -Resource Types: - -

      BackoffPolicyType -(string alias)

      -

      -(Appears on: -DeliverySpec) -

      -

      -

      BackoffPolicyType is the type for backoff policies

      -

      -

      Channelable -

      -

      -

      Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers -defining compatible resources to embed it. We will typically use this type to deserialize -Channelable ObjectReferences and access their subscription and address data. This is not a real resource.

      -

      - - - - - - - - @@ -1197,29 +392,47 @@ Refer to the Kubernetes API documentation for the fields of the
      FieldDescription
      metadata
      @@ -1189,6 +383,7 @@ Kubernetes meta/v1.ObjectMeta       		+(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -ChannelableSpec + +BrokerSpec       		-

      Spec is the part where the Channelable fulfills the Subscribable contract.

      +

      Spec defines the desired state of the Broker.



      + + + + @@ -1233,7 +446,8 @@ DeliverySpec
      -SubscribableSpec
      +channelTemplateSpec
      - -SubscribableSpec + +ChannelTemplateSpec       		-

      -(Members of SubscribableSpec are embedded into this type.) -

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the +Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there +are no defaults for the namespace). +Deprecated: See spec.config to configure aditional broker options. +Unless class is for channel based broker implementation.

      +
      +config
      + +knative.dev/pkg/apis/duck/v1.KReference + +      		 +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap. +NOTE: this is for backwards compatibility with v1alpha1 <-> v1beta1 conversions.
      (Optional) -

      DeliverySpec contains options controlling the event delivery

      +

      Delivery is the delivery specification to be used internally by the broker to +create subscriptions.
      @@ -1243,26 +457,22 @@ DeliverySpec       		status
      - -ChannelableStatus + +BrokerStatus       		+(Optional) +

      Status represents the current state of the Broker. This data may be out of +date.
      -

      ChannelableSpec +

      EventType

      -(Appears on: -ChannelSpec, -Channelable, -InMemoryChannelSpec) -

      -

      -

      ChannelableSpec contains Spec of the Channelable object

      @@ -1274,206 +484,133 @@ ChannelableStatus + + + + - -
      -SubscribableSpec
      - - -SubscribableSpec - - +apiVersion
      +string      		 + +eventing.knative.dev/v1alpha1 +
      -

      -(Members of SubscribableSpec are embedded into this type.) -

      +kind
      +string       		EventType
      -delivery
      +metadata
      - -DeliverySpec + +Kubernetes meta/v1.ObjectMeta       		(Optional) -

      DeliverySpec contains options controlling the event delivery

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -

      ChannelableStatus -

      -

      -(Appears on: -ChannelStatus, -Channelable, -InMemoryChannelStatus) -

      -

      -

      ChannelableStatus contains the Status of a Channelable object.

      -

      - - - - - - - - - +

      Spec defines the desired state of the EventType.

      +
      +
      +
      FieldDescription
      -Status
      +spec
      -knative.dev/pkg/apis/duck/v1.Status + +EventTypeSpec +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      -
      - -
      -AddressStatus
      +type
      -knative.dev/pkg/apis/duck/v1.AddressStatus +string       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the part where the Channelable fulfills the Addressable contract.

      +

      Type represents the CloudEvents type. It is authoritative.
      -SubscribableStatus
      +source
      - -SubscribableStatus - +string       		-

      -(Members of SubscribableStatus are embedded into this type.) -

      -

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      +

      Source is a URI, it represents the CloudEvents source.
      -deadLetterChannel
      +schema
      -knative.dev/pkg/apis/duck/v1.KReference +string       		(Optional) -

      DeadLetterChannel is a KReference and is set by the channel when it supports native error handling via a channel -Failed messages are delivered here.

      +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.
      -

      DeliverySpec -

      -

      -(Appears on: -BrokerSpec, -BrokerSpec, -ChannelSpec, -ChannelableCombinedSpec, -ChannelableSpec, -ChannelableSpec, -InMemoryChannelSpec, -SequenceStep, -SequenceStep, -SubscriberSpec, -SubscriberSpec, -SubscriptionSpec, -SubscriptionSpec) -

      -

      -

      DeliverySpec contains the delivery options for event senders, -such as channelable and source.

      -

      - - - - - - - - - - -
      FieldDescription
      -deadLetterSink
      +broker
      -knative.dev/pkg/apis/duck/v1.Destination +string       		-(Optional) -

      DeadLetterSink is the sink receiving event that couldn’t be sent to -a destination.

      +

      Broker refers to the Broker that can provide the EventType.
      -retry
      +description
      -int32 +string       		(Optional) -

      Retry is the minimum number of retries the sender should attempt when -sending an event before moving it to the dead letter sink.

      +

      Description is an optional field used to describe the EventType, in any meaningful way.
      -backoffPolicy
      - - -BackoffPolicyType - - -      		 -(Optional) -

      BackoffPolicy is the retry backoff policy (linear, exponential)

      +
      -backoffDelay
      +status
      -string + +EventTypeStatus + (Optional) -

      BackoffDelay is the delay before retrying. -More information on Duration format: https://www.ietf.org/rfc/rfc3339.txt

      -

      For linear policy, backoff delay is the time interval between retries. -For exponential policy , backoff delay is backoffDelay*2^

      +

      Status represents the current state of the EventType. +This data may be out of date.

      -

      DeliveryStatus +

      Trigger

      -

      DeliveryStatus contains the Status of an object supporting delivery options.

      +

      Trigger represents a request to have events delivered to a consumer from a +Broker’s event pool.

      @@ -1485,34 +622,21 @@ For exponential policy , backoff delay is backoffDelay*2^

       +apiVersion
      +string - -
      -deadLetterChannel
      - -knative.dev/pkg/apis/duck/v1.KReference - -      		 -(Optional) -

      DeadLetterChannel is a KReference that is the reference to the native, platform specific channel -where failed events are sent to.

      + +eventing.knative.dev/v1alpha1 +
      -

      Subscribable -

      -

      -

      Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers -defining compatible resources to embed it. We will typically use this type to deserialize -SubscribableType ObjectReferences and access the Subscription data. This is not a real resource.

      -

      - - - - + + - - @@ -1531,28 +656,53 @@ Refer to the Kubernetes API documentation for the fields of the
      FieldDescription +kind
      +string +      		Trigger
      metadata
      @@ -1523,6 +647,7 @@ Kubernetes meta/v1.ObjectMeta       		+(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -SubscribableSpec + +TriggerSpec       		-

      SubscribableSpec is the part where Subscribable object is -configured as to be compatible with Subscribable contract.

      +

      Spec defines the desired state of the Trigger.



      + + + + + + + +
      -subscribers
      +broker
      - -[]SubscriberSpec +string + +      		 +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.

      +
      +filter
      + + +TriggerFilter       		-

      This is the list of subscriptions for this subscribable.

      +(Optional) +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +
      +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.
      @@ -1562,28 +712,26 @@ configured as to be compatible with Subscribable contract.

      		 status
      - -SubscribableStatus + +TriggerStatus       		-

      SubscribableStatus is the part where SubscribableStatus object is -configured as to be compatible with Subscribable contract.

      +(Optional) +

      Status represents the current state of the Trigger. This data may be out of +date.
      -

      SubscribableSpec +

      BrokerSpec

      (Appears on: -ChannelableCombinedSpec, -ChannelableSpec, -Subscribable) +Broker)

      -

      SubscribableSpec shows how we expect folks to embed Subscribable in their Spec field.

      @@ -1595,30 +743,62 @@ configured as to be compatible with Subscribable contract.

      + + + + + + + +
      -subscribers
      +channelTemplateSpec
      - -[]SubscriberSpec + +ChannelTemplateSpec       		-

      This is the list of subscriptions for this subscribable.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the +Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there +are no defaults for the namespace). +Deprecated: See spec.config to configure aditional broker options. +Unless class is for channel based broker implementation.

      +
      +config
      + +knative.dev/pkg/apis/duck/v1.KReference + +      		 +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap. +NOTE: this is for backwards compatibility with v1alpha1 <-> v1beta1 conversions.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      Delivery is the delivery specification to be used internally by the broker to +create subscriptions.
      -

      SubscribableStatus +

      BrokerStatus

      (Appears on: -ChannelableCombinedStatus, -ChannelableStatus, -Subscribable) +Broker)

      -

      SubscribableStatus is the schema for the subscribable’s status portion of the status -section of the resource.

      +

      BrokerStatus represents the current state of a Broker.

      @@ -1630,28 +810,56 @@ section of the resource.

      + + + + + + + +
      -subscribers
      +Status
      - -[]SubscriberStatus +knative.dev/pkg/apis/duck/v1.Status + +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      +
      +address
      + +knative.dev/pkg/apis/duck/v1alpha1.Addressable + +      		 +

      Broker 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 {broker}-router.{namespace}.svc.{cluster domain name}

      +
      +triggerChannel
      + + +Kubernetes core/v1.ObjectReference       		-

      This is the list of subscription’s statuses for this channel.

      +

      TriggerChannel is an objectref to the object for the TriggerChannel
      -

      SubscriberSpec +

      EventTypeSpec

      (Appears on: -SubscribableSpec) +EventType)

      -

      SubscriberSpec defines a single subscriber to a Subscribable.

      -

      At least one of SubscriberURI and ReplyURI must be present

      @@ -1663,76 +871,72 @@ section of the resource.

      -uid
      +type
      -k8s.io/apimachinery/pkg/types.UID +string       		-(Optional) -

      UID is used to understand the origin of the subscriber.

      +

      Type represents the CloudEvents type. It is authoritative.
      -generation
      +source
      -int64 +string       		-(Optional) -

      Generation of the origin of the subscriber with uid:UID.

      +

      Source is a URI, it represents the CloudEvents source.
      -subscriberUri
      +schema
      -knative.dev/pkg/apis.URL +string       		(Optional) -

      SubscriberURI is the endpoint for the subscriber

      +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.
      -replyUri
      +broker
      -knative.dev/pkg/apis.URL +string       		-(Optional) -

      ReplyURI is the endpoint for the reply

      +

      Broker refers to the Broker that can provide the EventType.
      -delivery
      +description
      - -DeliverySpec - +string       		(Optional) -

      DeliverySpec contains options controlling the event delivery

      +

      Description is an optional field used to describe the EventType, in any meaningful way.
      -

      SubscriberStatus +

      EventTypeStatus

      (Appears on: -SubscribableStatus) +EventType)

      -

      SubscriberStatus defines the status of a single subscriber to a Channel.

      +

      EventTypeStatus represents the current state of a EventType.

      @@ -1744,67 +948,95 @@ DeliverySpec + +
      -uid
      +Status
      -k8s.io/apimachinery/pkg/types.UID +knative.dev/pkg/apis/duck/v1.Status       		-(Optional) -

      UID is used to understand the origin of the subscriber.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      +

      TriggerFilter +

      +

      +(Appears on: +TriggerSpec) +

      +

      +

      + + - - + + + +
      -observedGeneration
      - -int64 - -      		 -(Optional) -

      Generation of the origin of the subscriber with uid:UID.

      -      		FieldDescription
      -ready
      +sourceAndType
      - -Kubernetes core/v1.ConditionStatus + +TriggerFilterSourceAndType       		-

      Status of the subscriber.

      +(Optional) +

      DeprecatedSourceAndType filters events based on exact matches on the +CloudEvents type and source attributes. This field has been replaced by the +Attributes field.
      -message
      +attributes
      -string + +TriggerFilterAttributes +       		(Optional) -

      A human readable message indicating details of Ready status.

      +

      Attributes filters events by exact match on event context attributes. +Each key in the map is compared with the equivalent key in the event +context. An event passes the filter if all values are equal to the +specified values.

      +

      Nested context attributes are not supported as keys. Only string values are supported.
      -
      -

      flows.knative.dev/v1beta1

      +

      TriggerFilterAttributes +(map[string]string alias)

      -

      Package v1beta1 is the v1beta1 version of the API.

      +(Appears on: +TriggerFilter)

      -Resource Types: - -

      Parallel +

      +

      TriggerFilterAttributes is a map of context attribute names to values for +filtering by equality. Only exact matches will pass the filter. You can use the value “ +to indicate all strings match.

      +

      +

      TriggerFilterSourceAndType

      -

      Parallel defines conditional branches that will be wired in -series through Channels and Subscriptions.

      +(Appears on: +TriggerFilter) +

      +

      +

      TriggerFilterSourceAndType filters events based on exact matches on the cloud event’s type and +source attributes. Only exact matches will pass the filter. Either or both type and source can +use the value “ to indicate all strings match.

      @@ -1816,101 +1048,91 @@ series through Channels and Subscriptions.

      + + +
      -metadata
      +type
      - -Kubernetes meta/v1.ObjectMeta - +string       		-(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field.
      -spec
      +source
      - -ParallelSpec - +string       		-

      Spec defines the desired state of the Parallel.

      -
      -
      +
      +

      TriggerSpec +

      +

      +(Appears on: +Trigger) +

      +

      +

      + - - + + + + - -
      -branches
      - - -[]ParallelBranch - - -      		 -

      Branches is the list of Filter/Subscribers pairs.

      -      		FieldDescription
      -channelTemplate
      +broker
      - -ChannelTemplateSpec - +string       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.
      -reply
      +filter
      -knative.dev/pkg/apis/duck/v1.Destination + +TriggerFilter +       		(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      -
      +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      -status
      +subscriber
      - -ParallelStatus - +knative.dev/pkg/apis/duck/v1.Destination -(Optional) -

      Status represents the current state of the Parallel. This data may be out of -date.

      +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.

      -

      ParallelBranch +

      TriggerStatus

      (Appears on: -ParallelSpec) +Trigger)

      +

      TriggerStatus represents the current state of a Trigger.

      @@ -1922,50 +1144,54 @@ date.

      - - - -
      -filter
      - -knative.dev/pkg/apis/duck/v1.Destination - -      		 -(Optional) -

      Filter is the expression guarding the branch

      -
      -subscriber
      +Status
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1.Status       		-

      Subscriber receiving the event when the filter passes

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -reply
      +subscriberURI
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis.URL       		-(Optional) -

      Reply is a Reference to where the result of Subscriber of this case gets sent to. -If not specified, sent the result to the Parallel Reply

      +

      SubscriberURI is the resolved URI of the receiver for this Trigger.
      -

      ParallelBranchStatus -

      +
      +

      eventing.knative.dev/v1beta1

      -(Appears on: -ParallelStatus) +

      Package v1beta1 is the v1beta1 version of the API.

      +Resource Types: + +

      Broker +

      -

      ParallelBranchStatus represents the current state of a Parallel branch

      +

      Broker collects a pool of events that are consumable using Triggers. Brokers +provide a well-known endpoint for event delivery that senders can use with +minimal knowledge of the event routing strategy. Receivers use Triggers to +request delivery of events from a Broker’s pool to a specific URL or +Addressable endpoint.

      @@ -1977,95 +1203,102 @@ If not specified, sent the result to the Parallel Reply

      + + + + - - -
      -filterSubscriptionStatus
      - - -ParallelSubscriptionStatus - - +apiVersion
      +string      		 + +eventing.knative.dev/v1beta1 +
      -

      FilterSubscriptionStatus corresponds to the filter subscription status.

      +kind
      +string       		Broker
      -filterChannelStatus
      +metadata
      - -ParallelChannelStatus + +Kubernetes meta/v1.ObjectMeta       		-

      FilterChannelStatus corresponds to the filter channel status.

      +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -subscriberSubscriptionStatus
      +spec
      - -ParallelSubscriptionStatus + +BrokerSpec       		-

      SubscriptionStatus corresponds to the subscriber subscription status.

      -
      -

      ParallelChannelStatus -

      -

      -(Appears on: -ParallelBranchStatus, -ParallelStatus) -

      -

      -

      +

      Spec defines the desired state of the Broker.

      +
      +
      - - - + + - - + +
      FieldDescription +config
      + +knative.dev/pkg/apis/duck/v1.KReference + +      		 +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap.

      +
      -channel
      +delivery
      - -Kubernetes core/v1.ObjectReference + +DeliverySpec       		-

      Channel is the reference to the underlying channel.

      +(Optional) +

      Delivery is the delivery specification for Events within the Broker mesh. +This includes things like retries, DLQ, etc.

      +
      -ready
      +status
      -knative.dev/pkg/apis.Condition + +BrokerStatus + -

      ReadyCondition indicates whether the Channel is ready or not.

      +(Optional) +

      Status represents the current state of the Broker. This data may be out of +date.

      -

      ParallelSpec +

      EventType

      -(Appears on: -Parallel) -

      -

      @@ -2077,172 +1310,133 @@ knative.dev/pkg/apis.Condition + + + + - - -
      -branches
      - - -[]ParallelBranch - - +apiVersion
      +string      		 + +eventing.knative.dev/v1beta1 +
      -

      Branches is the list of Filter/Subscribers pairs.

      +kind
      +string       		EventType
      -channelTemplate
      +metadata
      - -ChannelTemplateSpec + +Kubernetes meta/v1.ObjectMeta       		(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -reply
      +spec
      -knative.dev/pkg/apis/duck/v1.Destination + +EventTypeSpec +       		-(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      -
      -

      ParallelStatus -

      -

      -(Appears on: -Parallel) -

      -

      -

      ParallelStatus represents the current state of a Parallel.

      -

      +

      Spec defines the desired state of the EventType.

      +
      +
      - - - - - - - - -
      FieldDescription
      -Status
      +type
      -knative.dev/pkg/apis/duck/v1.Status +string       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Type represents the CloudEvents type. It is authoritative.
      -ingressChannelStatus
      +source
      - -ParallelChannelStatus - +knative.dev/pkg/apis.URL       		-

      IngressChannelStatus corresponds to the ingress channel status.

      +

      Source is a URI, it represents the CloudEvents source.
      -branchStatuses
      +schema
      - -[]ParallelBranchStatus - +knative.dev/pkg/apis.URL       		-

      BranchStatuses is an array of corresponding to branch statuses. -Matches the Spec.Branches array in the order.

      +(Optional) +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.
      -AddressStatus
      +broker
      -knative.dev/pkg/apis/duck/v1.AddressStatus +string       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Parallel. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      +

      Broker refers to the Broker that can provide the EventType.
      -

      ParallelSubscriptionStatus -

      -

      -(Appears on: -ParallelBranchStatus) -

      -

      -

      - - - - - - - - + +
      FieldDescription
      -subscription
      +description
      - -Kubernetes core/v1.ObjectReference - +string       		-

      Subscription is the reference to the underlying Subscription.

      +(Optional) +

      Description is an optional field used to describe the EventType, in any meaningful way.

      +
      -ready
      +status
      -knative.dev/pkg/apis.Condition + +EventTypeStatus + -

      ReadyCondition indicates whether the Subscription is ready or not.

      +(Optional) +

      Status represents the current state of the EventType. +This data may be out of date.

      -

      Sequence +

      Trigger

      -

      Sequence defines a sequence of Subscribers that will be wired in -series through Channels and Subscriptions.

      +

      Trigger represents a request to have events delivered to a consumer from a +Broker’s event pool.

      @@ -2254,6 +1448,23 @@ series through Channels and Subscriptions.

      + + + + + + + +
      +apiVersion
      +string      		 + +eventing.knative.dev/v1beta1 + +
      +kind
      +string +      		Trigger
      metadata
      @@ -2271,55 +1482,53 @@ Refer to the Kubernetes API documentation for the fields of the       		spec
      - -SequenceSpec + +TriggerSpec       		-

      Spec defines the desired state of the Sequence.

      +

      Spec defines the desired state of the Trigger.



      -steps
      +broker
      - -[]SequenceStep - +string       		-

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided. Each step has its own delivery options

      +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.
      -channelTemplate
      +filter
      - -ChannelTemplateSpec + +TriggerFilter       		(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.
      -reply
      +subscriber
      knative.dev/pkg/apis/duck/v1.Destination       		-(Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.
      @@ -2329,26 +1538,74 @@ knative.dev/pkg/apis/duck/v1.Destination       		status
      - -SequenceStatus + +TriggerStatus       		(Optional) -

      Status represents the current state of the Sequence. This data may be out of +

      Status represents the current state of the Trigger. This data may be out of date.
      -

      SequenceChannelStatus +

      BrokerSpec +

      +

      +(Appears on: +Broker) +

      +

      +

      + + + + + + + + + + + + + + + + + +
      FieldDescription
      +config
      + +knative.dev/pkg/apis/duck/v1.KReference + +      		 +(Optional) +

      Config is a KReference to the configuration that specifies +configuration options for this Broker. For example, this could be +a pointer to a ConfigMap.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      Delivery is the delivery specification for Events within the Broker mesh. +This includes things like retries, DLQ, etc.

      +
      +

      BrokerStatus

      (Appears on: -SequenceStatus) +Broker)

      +

      BrokerStatus represents the current state of a Broker.

      @@ -2360,35 +1617,39 @@ date.

      -channel
      +Status
      - -Kubernetes core/v1.ObjectReference - +knative.dev/pkg/apis/duck/v1.Status       		-

      Channel is the reference to the underlying channel.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -ready
      +address
      -knative.dev/pkg/apis.Condition +knative.dev/pkg/apis/duck/v1.Addressable       		-

      ReadyCondition indicates whether the Channel is ready or not.

      +

      Broker is Addressable. It exposes the endpoint as an URI to get events +delivered into the Broker mesh.
      -

      SequenceSpec +

      EventTypeSpec

      (Appears on: -Sequence) +EventType)

      @@ -2402,55 +1663,72 @@ knative.dev/pkg/apis.Condition -steps
      +type
      - -[]SequenceStep - +string -

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided. Each step has its own delivery options

      +

      Type represents the CloudEvents type. It is authoritative.

      -channelTemplate
      +source
      - -ChannelTemplateSpec - +knative.dev/pkg/apis.URL + + + +

      Source is a URI, it represents the CloudEvents source.

      + + + + +schema
      + +knative.dev/pkg/apis.URL (Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. +It may be a JSON schema, a protobuf schema, etc. It is optional.

      -reply
      +broker
      -knative.dev/pkg/apis/duck/v1.Destination +string + + + +

      Broker refers to the Broker that can provide the EventType.

      + + + + +description
      + +string (Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +

      Description is an optional field used to describe the EventType, in any meaningful way.

      -

      SequenceStatus +

      EventTypeStatus

      (Appears on: -Sequence) +EventType)

      -

      SequenceStatus represents the current state of a Sequence.

      +

      EventTypeStatus represents the current state of a EventType.

      @@ -2476,57 +1754,60 @@ knative.dev/pkg/apis/duck/v1.Status * Conditions - the latest available observations of a resource’s current state.

      + +
      +

      TriggerFilter +

      +

      +(Appears on: +TriggerSpec) +

      +

      +

      + + - - + + + + - - - -
      -subscriptionStatuses
      - - -[]SequenceSubscriptionStatus - - -      		 -

      SubscriptionStatuses is an array of corresponding Subscription statuses. -Matches the Spec.Steps array in the order.

      -      		FieldDescription
      -channelStatuses
      +attributes
      - -[]SequenceChannelStatus + +TriggerFilterAttributes       		-

      ChannelStatuses is an array of corresponding Channel statuses. -Matches the Spec.Steps array in the order.

      -
      -AddressStatus
      - -knative.dev/pkg/apis/duck/v1.AddressStatus - -      		 -

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Sequence. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      +(Optional) +

      Attributes filters events by exact match on event context attributes. +Each key in the map is compared with the equivalent key in the event +context. An event passes the filter if all values are equal to the +specified values.

      +

      Nested context attributes are not supported as keys. Only string values are supported.
      -

      SequenceStep +

      TriggerFilterAttributes +(map[string]string alias)

      +

      +(Appears on: +TriggerFilter) +

      +

      +

      TriggerFilterAttributes is a map of context attribute names to values for +filtering by equality. Only exact matches will pass the filter. You can use the value “ +to indicate all strings match.

      +

      +

      TriggerSpec

      (Appears on: -SequenceSpec) +Trigger)

      @@ -2540,42 +1821,53 @@ It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      -Destination
      +broker
      -knative.dev/pkg/apis/duck/v1.Destination +string -

      -(Members of Destination are embedded into this type.) -

      -

      Subscriber receiving the step event

      +

      Broker is the broker that this trigger receives events from. If not specified, will default +to ‘default’.

      -delivery
      +filter
      - -DeliverySpec + +TriggerFilter (Optional) -

      Delivery is the delivery specification for events to the subscriber -This includes things like retries, DLQ, etc.

      +

      Filter is the filter to apply against all events from the Broker. Only events that pass this +filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      + + + + +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + + + +

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It +is required.

      -

      SequenceSubscriptionStatus +

      TriggerStatus

      (Appears on: -SequenceStatus) +Trigger)

      +

      TriggerStatus represents the current state of a Trigger.

      @@ -2587,88 +1879,54 @@ This includes things like retries, DLQ, etc.

      -subscription
      +Status
      - -Kubernetes core/v1.ObjectReference - +knative.dev/pkg/apis/duck/v1.Status       		-

      Subscription is the reference to the underlying Subscription.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -ready
      +subscriberUri
      -knative.dev/pkg/apis.Condition +knative.dev/pkg/apis.URL       		-

      ReadyCondition indicates whether the Subscription is ready or not.

      +

      SubscriberURI is the resolved URI of the receiver for this Trigger.
      -

      sources.eventing.knative.dev/v1alpha1

      +

      flows.knative.dev/v1alpha1

      -

      Package v1alpha1 contains API Schema definitions for the sources v1alpha1 API group

      +

      Package v1alpha1 is the v1alpha1 version of the API.

      Resource Types: - -

      ApiServerSource + +

      Parallel

      -

      ApiServerSource is the Schema for the apiserversources API

      +

      Parallel defines conditional branches that will be wired in +series through Channels and Subscriptions.

      - - - - - - - - - - - - - - - - + + + + @@ -2687,87 +1946,138 @@ Refer to the Kubernetes API documentation for the fields of the +
      FieldDescription
      -apiVersion
      -string      		 - -sources.eventing.knative.dev/v1alpha1 - -
      -kind
      -string -      		ApiServerSource
      -Deprecated
      - - -Deprecated - - -      		 -

      Deprecated allows ApiServerSource to have a deprecated message.

      -      		FieldDescription
      metadata
      @@ -2679,6 +1937,7 @@ Kubernetes meta/v1.ObjectMeta       		+(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -ApiServerSourceSpec + +ParallelSpec       		+

      Spec defines the desired state of the Parallel.



      + +
      -resources
      +branches
      - -[]ApiServerResource + +[]ParallelBranch       		-

      Resources is the list of resources to watch

      +

      Branches is the list of Filter/Subscribers pairs.
      -serviceAccountName
      +channelTemplate
      -string + +ChannelTemplateSpec +       		(Optional) -

      ServiceAccountName is the name of the ServiceAccount to use to run this -source.

      +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -sink
      +reply
      -knative.dev/pkg/apis/duck/v1beta1.Destination +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply

      +
      -mode
      +status
      -string + +ParallelStatus +       		-

      Mode is the mode the receive adapter controller runs under: Ref or Resource. -Ref sends only the reference to the resource. -Resource send the full resource.

      +(Optional) +

      Status represents the current state of the Parallel. This data may be out of +date.
      +

      ParallelBranch +

      +

      +(Appears on: +ParallelSpec) +

      +

      +

      + + + + + + + + + + + + + + +
      FieldDescription
      +filter
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Filter is the expression guarding the branch
      -status
      +subscriber
      - -ApiServerSourceStatus - +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber receiving the event when the filter passes

      +
      +reply
      + +knative.dev/pkg/apis/duck/v1.Destination       		+(Optional) +

      Reply is a Reference to where the result of Subscriber of this case gets sent to. +If not specified, sent the result to the Parallel Reply
      -

      ContainerSource +

      ParallelBranchStatus

      -

      ContainerSource is the Schema for the containersources API

      +(Appears on: +ParallelStatus) +

      +

      +

      ParallelBranchStatus represents the current state of a Parallel branch

      @@ -2779,165 +2089,232 @@ ApiServerSourceStatus +filterSubscriptionStatus
      + + +ParallelSubscriptionStatus + + + + - + +
      -apiVersion
      -string      		 - -sources.eventing.knative.dev/v1alpha1 - +

      FilterSubscriptionStatus corresponds to the filter subscription status.
      -kind
      -string +filterChannelStatus
      + + +ParallelChannelStatus + + +      		 +

      FilterChannelStatus corresponds to the filter channel status.

      		ContainerSource
      -Deprecated
      +subscriberSubscriptionStatus
      - -Deprecated + +ParallelSubscriptionStatus       		-

      Deprecated allows ContainerSource to have a deprecated message.

      +

      SubscriptionStatus corresponds to the subscriber subscription status.
      +

      ParallelChannelStatus +

      +

      +(Appears on: +ParallelBranchStatus, +ParallelStatus) +

      +

      +

      + + + + + + + + + + +
      FieldDescription
      -metadata
      +channel
      - -Kubernetes meta/v1.ObjectMeta + +Kubernetes core/v1.ObjectReference       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Channel is the reference to the underlying channel.
      -spec
      +ready
      - -ContainerSourceSpec - +knative.dev/pkg/apis.Condition       		-
      -
      +

      ReadyCondition indicates whether the Channel is ready or not.

      +
      +

      ParallelSpec +

      +

      +(Appears on: +Parallel) +

      +

      +

      + + + + + + + + +
      FieldDescription
      -template
      +branches
      - -Kubernetes core/v1.PodTemplateSpec + +[]ParallelBranch       		-(Optional) -

      Template describes the pods that will be created

      +

      Branches is the list of Filter/Subscribers pairs.
      -image
      +channelTemplate
      -string + +ChannelTemplateSpec +       		-

      DeprecatedImage is the image to run inside of the container. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -args
      +reply
      -[]string +knative.dev/pkg/apis/duck/v1.Destination       		-

      DeprecatedArgs are passed to the ContainerSpec as they are. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +(Optional) +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply
      +

      ParallelStatus +

      +

      +(Appears on: +Parallel) +

      +

      +

      ParallelStatus represents the current state of a Parallel.

      +

      + + + + + + + + - -
      FieldDescription
      -env
      +Status
      - -[]Kubernetes core/v1.EnvVar - +knative.dev/pkg/apis/duck/v1.Status       		-(Optional) -

      DeprecatedEnv is the list of environment variables to set in the container. -Cannot be updated. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -serviceAccountName
      +ingressChannelStatus
      -string + +ParallelChannelStatus +       		-(Optional) -

      DeprecatedServiceAccountName is the name of the ServiceAccount to use to run this -source. -This field is to be deprecated. Use Template instead. -When Template is set, this field is ignored.

      +

      IngressChannelStatus corresponds to the ingress channel status.
      -sink
      +branchStatuses
      -knative.dev/pkg/apis/duck/v1beta1.Destination + +[]ParallelBranchStatus +       		-

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      -
      +

      BranchStatuses is an array of corresponding to branch statuses. +Matches the Spec.Branches array in the order.

      -status
      +AddressStatus
      - -ContainerSourceStatus - +knative.dev/pkg/apis/duck/v1.AddressStatus +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the starting point to this Parallel. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      -

      CronJobSource +

      ParallelSubscriptionStatus

      -

      CronJobSource is the Schema for the cronjobsources API.

      +(Appears on: +ParallelBranchStatus) +

      +

      @@ -2949,34 +2326,44 @@ ContainerSourceStatus - - - - + +
      -apiVersion
      -string      		 - -sources.eventing.knative.dev/v1alpha1 - +subscription
      + + +Kubernetes core/v1.ObjectReference + +
      -kind
      -string +

      Subscription is the reference to the underlying Subscription.

      		CronJobSource
      -Deprecated
      +ready
      - -Deprecated - +knative.dev/pkg/apis.Condition       		-

      Deprecated allows CronJobSource to have a deprecated message.

      +

      ReadyCondition indicates whether the Subscription is ready or not.
      +

      Sequence +

      +

      +

      Sequence defines a sequence of Subscribers that will be wired in +series through Channels and Subscriptions.

      +

      + + + + + + + + @@ -2995,99 +2383,126 @@ Refer to the Kubernetes API documentation for the fields of the + +
      FieldDescription
      metadata
      @@ -2987,6 +2374,7 @@ Kubernetes meta/v1.ObjectMeta       		+(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -CronJobSourceSpec + +SequenceSpec       		+

      Spec defines the desired state of the Sequence.



      + +
      -schedule
      +steps
      -string + +[]SequenceStep +       		-

      Schedule is the cronjob schedule.

      +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided.
      -data
      +channelTemplate
      -string + +ChannelTemplateSpec +       		-

      Data is the data posted to the target function.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -sink
      +reply
      -knative.dev/pkg/apis/duck/v1beta1.Destination +knative.dev/pkg/apis/duck/v1.Destination       		-

      Sink is a reference to an object that will resolve to a domain name to use as the sink.

      +(Optional) +

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +
      -serviceAccountName
      +status
      -string + +SequenceStatus +       		-

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive -Adapter Deployment.

      +(Optional) +

      Status represents the current state of the Sequence. This data may be out of +date.
      +

      SequenceChannelStatus +

      +

      +(Appears on: +SequenceStatus) +

      +

      +

      + + + + + + + + - -
      FieldDescription
      -resources
      +channel
      - -CronJobResourceSpec + +Kubernetes core/v1.ObjectReference       		-

      Resource limits and Request specifications of the Receive Adapter Deployment

      -
      +

      Channel is the reference to the underlying channel.

      -status
      +ready
      - -CronJobSourceStatus - +knative.dev/pkg/apis.Condition +

      ReadyCondition indicates whether the Channel is ready or not.

      -

      SinkBinding +

      SequenceSpec

      -

      SinkBinding describes a Binding that is also a Source. -The sink (from the Source duck) is resolved to a URL and -then projected into the subject by augmenting the runtime -contract of the referenced containers to have a K_SINK -environment variable holding the endpoint to which to send -cloud events.

      +(Appears on: +Sequence) +

      +

      @@ -3099,112 +2514,181 @@ cloud events.

      +steps
      + + +[]SequenceStep + + + + - + + + +
      -apiVersion
      -string      		 - -sources.eventing.knative.dev/v1alpha1 - +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided.
      -kind
      -string +channelTemplate
      + + +ChannelTemplateSpec + + +      		 +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).

      		SinkBinding
      -Deprecated
      +reply
      - -Deprecated - +knative.dev/pkg/apis/duck/v1.Destination + +      		 +(Optional) +

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +
      +

      SequenceStatus +

      +

      +(Appears on: +Sequence) +

      +

      +

      SequenceStatus represents the current state of a Sequence.

      +

      + + + + + + + + + +
      FieldDescription
      +Status
      + +knative.dev/pkg/apis/duck/v1.Status       		-

      Deprecated allows ApiServerSource to have a deprecated message.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -metadata
      +subscriptionStatuses
      - -Kubernetes meta/v1.ObjectMeta + +[]SequenceSubscriptionStatus       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      SubscriptionStatuses is an array of corresponding Subscription statuses. +Matches the Spec.Steps array in the order.
      -spec
      +channelStatuses
      - -SinkBindingSpec + +[]SequenceChannelStatus       		-
      -
      - +

      ChannelStatuses is an array of corresponding Channel statuses. +Matches the Spec.Steps array in the order.

      + + + +
      -SourceSpec
      +AddressStatus
      -knative.dev/pkg/apis/duck/v1.SourceSpec +knative.dev/pkg/apis/duck/v1.AddressStatus

      -(Members of SourceSpec are embedded into this type.) +(Members of AddressStatus are embedded into this type.)

      +

      AddressStatus is the starting point to this Sequence. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}
      +

      SequenceStep +

      +

      +(Appears on: +SequenceSpec) +

      +

      +

      + + + + + + + + - -
      FieldDescription
      -BindingSpec
      +Destination
      -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec +knative.dev/pkg/apis/duck/v1.Destination

      -(Members of BindingSpec are embedded into this type.) +(Members of Destination are embedded into this type.)

      -
      +

      Subscriber receiving the step event
      -status
      +delivery
      - -SinkBindingStatus + +DeliverySpec       		+(Optional) +

      Delivery is the delivery specification for events to the subscriber +This includes things like retries, DLQ, etc. +Needed for Roundtripping v1alpha1 <-> v1beta1.
      -

      ApiServerResource +

      SequenceSubscriptionStatus

      (Appears on: -ApiServerSourceSpec) +SequenceStatus)

      -

      ApiServerResource defines the resource to watch

      @@ -3216,85 +2700,115 @@ SinkBindingStatus + + +
      -apiVersion
      +subscription
      -string + +Kubernetes core/v1.ObjectReference +       		-

      API version of the resource to watch.

      +

      Subscription is the reference to the underlying Subscription.
      -kind
      +ready
      -string +knative.dev/pkg/apis.Condition       		-

      Kind of the resource to watch. -More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

      +

      ReadyCondition indicates whether the Subscription is ready or not.

      +
      +
      +

      sources.eventing.knative.dev/v1alpha1

      +

      +

      Package v1alpha1 contains API Schema definitions for the sources v1alpha1 API group

      +

      +Resource Types: + +

      ApiServerSource +

      +

      +

      ApiServerSource is the Schema for the apiserversources API

      +

      + + + + + + + + + + + + + + + - - -
      FieldDescription
      +apiVersion
      +string      		 + +sources.eventing.knative.dev/v1alpha1 +
      -labelSelector
      +kind
      +string +      		ApiServerSource
      +Deprecated
      - -Kubernetes meta/v1.LabelSelector + +Deprecated       		-

      LabelSelector restricts this source to objects with the selected labels -More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

      +

      Deprecated allows ApiServerSource to have a deprecated message.
      -controllerSelector
      +metadata
      - -Kubernetes meta/v1.OwnerReference + +Kubernetes meta/v1.ObjectMeta       		-

      ControllerSelector restricts this source to objects with a controlling owner reference of the specified kind. -Only apiVersion and kind are used. Both are optional.

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -controller
      +spec
      -bool + +ApiServerSourceSpec +       		-

      If true, send an event referencing the object controlling the resource

      -
      -

      ApiServerSourceSpec -

      -

      -(Appears on: -ApiServerSource) -

      -

      -

      ApiServerSourceSpec defines the desired state of ApiServerSource

      -

      +
      +
      - - - - - - - +
      FieldDescription
      resources
      @@ -3346,16 +2860,27 @@ string Resource send the full resource.
      + + + + +status
      + + +ApiServerSourceStatus + + + + + + -

      ApiServerSourceStatus +

      ContainerSource

      -(Appears on: -ApiServerSource) -

      -

      -

      ApiServerSourceStatus defines the observed state of ApiServerSource

      +

      ContainerSource is the Schema for the containersources API

      @@ -3367,51 +2892,61 @@ string + + + + + + + + + + + + - - -
      -Status
      +apiVersion
      +string      		 + +sources.eventing.knative.dev/v1alpha1 + +
      +kind
      +string +      		ContainerSource
      +Deprecated
      -knative.dev/pkg/apis/duck/v1.Status + +Deprecated +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Deprecated allows ContainerSource to have a deprecated message.

      +
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -sinkUri
      +spec
      -string + +ContainerSourceSpec +       		-(Optional) -

      SinkURI is the current active sink URI that has been configured for the ApiServerSource.

      -
      -

      ContainerSourceSpec -

      -

      -(Appears on: -ContainerSource) -

      -

      -

      ContainerSourceSpec defines the desired state of ContainerSource

      -

      +
      +
      - - - - - - - -
      FieldDescription
      template
      @@ -3495,62 +3030,27 @@ knative.dev/pkg/apis/duck/v1beta1.Destination

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -

      ContainerSourceStatus -

      -

      -(Appears on: -ContainerSource) -

      -

      -

      ContainerSourceStatus defines the observed state of ContainerSource

      -

      - - - - - - - - - - -
      FieldDescription
      -Status
      - -knative.dev/pkg/apis/duck/v1.Status - -      		 -

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.
      -sinkUri
      +status
      -string + +ContainerSourceStatus +       		-(Optional) -

      SinkURI is the current active sink URI that has been configured for the ContainerSource.
      -

      CronJobLimitsSpec +

      CronJobSource

      -(Appears on: -CronJobResourceSpec) -

      -

      +

      CronJobSource is the Schema for the cronjobsources API.

      @@ -3562,123 +3062,61 @@ string - - - - +apiVersion
      +string - -
      -cpu
      - -string - -      		 -
      -memory
      - -string - -      		 + +sources.eventing.knative.dev/v1alpha1 +
      -

      CronJobRequestsSpec -

      -

      -(Appears on: -CronJobResourceSpec) -

      -

      -

      - - - - - - - - - + - -
      FieldDescription
      -cpu
      - +kind
      string -       -      		 CronJobSource
      -memory
      +Deprecated
      -string + +Deprecated +       		+

      Deprecated allows CronJobSource to have a deprecated message.
      -

      CronJobResourceSpec -

      -

      -(Appears on: -CronJobSourceSpec) -

      -

      -

      - - - - - - - - - - -
      FieldDescription
      -requests
      +metadata
      - -CronJobRequestsSpec + +Kubernetes meta/v1.ObjectMeta       		+Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -limits
      +spec
      - -CronJobLimitsSpec + +CronJobSourceSpec       		-
      -

      CronJobSourceSpec -

      -

      -(Appears on: -CronJobSource) -

      -

      -

      CronJobSourceSpec defines the desired state of the CronJobSource.

      -

      +
      +
      - - - - - - - +
      FieldDescription
      schedule
      @@ -3737,16 +3175,32 @@ CronJobResourceSpec

      Resource limits and Request specifications of the Receive Adapter Deployment
      + + + + +status
      + + +CronJobSourceStatus + + + + + + -

      CronJobSourceStatus +

      SinkBinding

      -(Appears on: -CronJobSource) -

      -

      -

      CronJobSourceStatus defines the observed state of CronJobSource.

      +

      SinkBinding describes a Binding that is also a Source. +The sink (from the Source duck) is resolved to a URL and +then projected into the subject by augmenting the runtime +contract of the referenced containers to have a K_SINK +environment variable holding the endpoint to which to send +cloud events.

      @@ -3758,62 +3212,61 @@ CronJobResourceSpec + + + + + + + + + + + + - - -
      -Status
      +apiVersion
      +string      		 + +sources.eventing.knative.dev/v1alpha1 + +
      +kind
      +string +      		SinkBinding
      +Deprecated
      -knative.dev/pkg/apis/duck/v1.Status + +Deprecated +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Deprecated allows ApiServerSource to have a deprecated message.

      +
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -sinkUri
      +spec
      -string + +SinkBindingSpec +       		-(Optional) -

      SinkURI is the current active sink URI that has been configured for the CronJobSource.

      -
      -

      Deprecated -

      -

      -(Appears on: -ApiServerSource, -ContainerSource, -CronJobSource, -SinkBinding) -

      -

      -

      -

      SinkBindingSpec -

      -

      -(Appears on: -SinkBinding) -

      -

      -

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      -

      +
      +
      - - - - - - - -
      FieldDescription
      SourceSpec
      @@ -3840,57 +3293,31 @@ knative.dev/pkg/apis/duck/v1alpha1.BindingSpec

      -

      SinkBindingStatus -

      -

      -(Appears on: -SinkBinding) -

      -

      -

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      -

      - - - - - + - -
      FieldDescription
      -SourceStatus
      +status
      -knative.dev/pkg/apis/duck/v1.SourceStatus + +SinkBindingStatus +       		-

      -(Members of SourceStatus are embedded into this type.) -
      -
      -

      messaging.knative.dev/v1alpha1

      +

      ApiServerResource +

      -

      Package v1alpha1 is the v1alpha1 version of the API.

      +(Appears on: +ApiServerSourceSpec)

      -Resource Types: - -

      Channel -

      -

      Channel represents a generic Channel. It is normally used when we want a Channel, but don’t need a specific Channel implementation.

      +

      ApiServerResource defines the resource to watch

      @@ -3903,113 +3330,145 @@ Resource Types: + +string + + + - + +
      apiVersion
      -string      		 - -messaging.knative.dev/v1alpha1 - +

      API version of the resource to watch.
      kind
      + string + +      		 +

      Kind of the resource to watch. +More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

      		Channel
      -metadata
      +labelSelector
      - -Kubernetes meta/v1.ObjectMeta + +Kubernetes meta/v1.LabelSelector       		-(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      LabelSelector restricts this source to objects with the selected labels +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
      -spec
      +controllerSelector
      - -ChannelSpec + +Kubernetes meta/v1.OwnerReference       		-

      Spec defines the desired state of the Channel.

      -
      -
      - +

      ControllerSelector restricts this source to objects with a controlling owner reference of the specified kind. +Only apiVersion and kind are used. Both are optional.

      + + + +
      -channelTemplate
      +controller
      - -ChannelTemplateSpec - +bool       		-

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. -This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      +

      If true, send an event referencing the object controlling the resource
      +

      ApiServerSourceSpec +

      +

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceSpec defines the desired state of ApiServerSource

      +

      + + + + + + + + -
      FieldDescription
      -subscribable
      +resources
      - -Subscribable + +[]ApiServerResource       		-

      Channel conforms to Duck type Subscribable.

      +

      Resources is the list of resources to watch
      -delivery
      +serviceAccountName
      - -DeliverySpec - +string       		-

      Delivery options.

      +(Optional) +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source.
      +
      +sink
      + +knative.dev/pkg/apis/duck/v1beta1.Destination + +      		 +(Optional) +

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -status
      +mode
      - -ChannelStatus - +string       		-(Optional) -

      Status represents the current state of the Channel. This data may be out of -date.

      +

      Mode is the mode the receive adapter controller runs under: Ref or Resource. +Ref sends only the reference to the resource. +Resource send the full resource.
      -

      InMemoryChannel +

      ApiServerSourceStatus

      -

      InMemoryChannel is a resource representing an in memory channel

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceStatus defines the observed state of ApiServerSource

      @@ -4021,101 +3480,144 @@ date.

      +Status
      + +knative.dev/pkg/apis/duck/v1.Status + + - + + + +
      -apiVersion
      -string      		 - -messaging.knative.dev/v1alpha1 - +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -kind
      +sinkUri
      + string +       		InMemoryChannel +(Optional) +

      SinkURI is the current active sink URI that has been configured for the ApiServerSource.

      +
      +

      ContainerSourceSpec +

      +

      +(Appears on: +ContainerSource) +

      +

      +

      ContainerSourceSpec defines the desired state of ContainerSource

      +

      + + + + + + + + +
      FieldDescription
      -metadata
      +template
      - -Kubernetes meta/v1.ObjectMeta + +Kubernetes core/v1.PodTemplateSpec       		(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Template describes the pods that will be created
      -spec
      +image
      - -InMemoryChannelSpec - +string       		-

      Spec defines the desired state of the Channel.

      -
      -
      - +

      DeprecatedImage is the image to run inside of the container. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.

      + + -
      -subscribable
      +args
      - -Subscribable - +[]string       		-

      Channel conforms to Duck type Subscribable.

      +

      DeprecatedArgs are passed to the ContainerSpec as they are. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -delivery
      +env
      - -DeliverySpec + +[]Kubernetes core/v1.EnvVar       		-

      For round tripping (v1beta1 <-> v1alpha1>

      +(Optional) +

      DeprecatedEnv is the list of environment variables to set in the container. +Cannot be updated. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      +
      +serviceAccountName
      + +string + +      		 +(Optional) +

      DeprecatedServiceAccountName is the name of the ServiceAccount to use to run this +source. +This field is to be deprecated. Use Template instead. +When Template is set, this field is ignored.
      -status
      +sink
      - -InMemoryChannelStatus - +knative.dev/pkg/apis/duck/v1beta1.Destination       		-(Optional) -

      Status represents the current state of the Channel. This data may be out of -date.

      +

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -

      Subscription +

      ContainerSourceStatus

      -

      Subscription routes events received on a Channel to a DNS name and -corresponds to the subscriptions.channels.knative.dev CRD.

      +(Appears on: +ContainerSource) +

      +

      +

      ContainerSourceStatus defines the observed state of ContainerSource

      @@ -4127,132 +3629,144 @@ corresponds to the subscriptions.channels.knative.dev CRD.

      - - - - - - - - + + +
      -apiVersion
      -string      		 - -messaging.knative.dev/v1alpha1 - -
      -kind
      -string -      		Subscription
      -metadata
      +Status
      - -Kubernetes meta/v1.ObjectMeta - +knative.dev/pkg/apis/duck/v1.Status       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -spec
      +sinkUri
      - -SubscriptionSpec - +string       		-
      -
      +(Optional) +

      SinkURI is the current active sink URI that has been configured for the ContainerSource.

      +
      +

      CronJobLimitsSpec +

      +

      +(Appears on: +CronJobResourceSpec) +

      +

      +

      + + + + + + + + +
      FieldDescription
      -generation
      +cpu
      -int64 +string       		-(Optional) -

      TODO By enabling the status subresource metadata.generation should increment -thus making this property obsolete.

      -

      We should be able to drop this property with a CRD conversion webhook -in the future
      -channel
      +memory
      - -Kubernetes core/v1.ObjectReference - +string       		-

      This field is immutable. We have no good answer on what happens to -the events that are currently in the channel being consumed from -and what the semantics there should be. For now, you can always -delete the Subscription and recreate it to point to a different -channel, giving the user more control over what semantics should -be used (drain the channel first, possibly have events dropped, -etc.)
      +

      CronJobRequestsSpec +

      +

      +(Appears on: +CronJobResourceSpec) +

      +

      +

      + + + + + + + + + +
      FieldDescription
      -subscriber
      +cpu
      -knative.dev/pkg/apis/duck/v1.Destination +string       		-(Optional) -

      Subscriber is reference to (optional) function for processing events. -Events from the Channel will be delivered here and replies are -sent to a Destination as specified by the Reply.
      -reply
      +memory
      -knative.dev/pkg/apis/duck/v1.Destination +string       		-(Optional) -

      Reply specifies (optionally) how to handle events returned from -the Subscriber target.
      +

      CronJobResourceSpec +

      +

      +(Appears on: +CronJobSourceSpec) +

      +

      +

      + + + + + + + + - -
      FieldDescription
      -delivery
      +requests
      - -DeliverySpec + +CronJobRequestsSpec       		-(Optional) -

      Delivery configuration

      -
      -status
      +limits
      - -SubscriptionStatus + +CronJobLimitsSpec @@ -4261,15 +3775,14 @@ SubscriptionStatus -

      ChannelSpec +

      CronJobSourceSpec

      (Appears on: -Channel) +CronJobSource)

      -

      ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. -It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.

      +

      CronJobSourceSpec defines the desired state of the CronJobSource.

      @@ -4277,58 +3790,76 @@ It also defines the ChannelTemplate to use in order to create the CRD Channel ba - - + + + + + + + + + +
      Field Description
      +schedule
      + +string + +      		 +

      Schedule is the cronjob schedule.

      +
      +data
      + +string + +      		 +

      Data is the data posted to the target function.

      +
      -channelTemplate
      +sink
      - -ChannelTemplateSpec - +knative.dev/pkg/apis/duck/v1beta1.Destination       		-

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. -This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      +

      Sink is a reference to an object that will resolve to a domain name to use as the sink.
      -subscribable
      +serviceAccountName
      - -Subscribable - +string       		-

      Channel conforms to Duck type Subscribable.

      +

      ServiceAccoutName is the name of the ServiceAccount that will be used to run the Receive +Adapter Deployment.
      -delivery
      +resources
      - -DeliverySpec + +CronJobResourceSpec       		-

      Delivery options.

      +

      Resource limits and Request specifications of the Receive Adapter Deployment
      -

      ChannelStatus +

      CronJobSourceStatus

      (Appears on: -Channel) +CronJobSource)

      -

      ChannelStatus represents the current state of a Channel.

      +

      CronJobSourceStatus defines the observed state of CronJobSource.

      @@ -4356,62 +3887,82 @@ knative.dev/pkg/apis/duck/v1.Status + + +
      -AddressStatus
      +sinkUri
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus +string       		+(Optional) +

      SinkURI is the current active sink URI that has been configured for the CronJobSource.

      +
      +

      Deprecated +

      -(Members of AddressStatus are embedded into this type.) +(Appears on: +ApiServerSource, +ContainerSource, +CronJobSource, +SinkBinding)

      -

      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}

      - +

      +

      +

      SinkBindingSpec +

      +

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      +

      + + + + + + +
      FieldDescription
      -SubscribableTypeStatus
      +SourceSpec
      - -SubscribableTypeStatus - +knative.dev/pkg/apis/duck/v1.SourceSpec

      -(Members of SubscribableTypeStatus are embedded into this type.) +(Members of SourceSpec are embedded into this type.)

      -

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.
      -channel
      +BindingSpec
      - -Kubernetes core/v1.ObjectReference - +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec       		-

      Channel is an ObjectReference to the Channel CRD backing this Channel.

      +

      +(Members of BindingSpec are embedded into this type.) +
      -

      InMemoryChannelSpec +

      SinkBindingStatus

      (Appears on: -InMemoryChannel) +SinkBinding)

      -

      InMemoryChannelSpec defines which subscribers have expressed interest in -receiving events from this InMemoryChannel. -arguments for a Channel.

      +

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      @@ -4423,40 +3974,36 @@ arguments for a Channel.

      - - - -
      -subscribable
      - - -Subscribable - - -      		 -

      Channel conforms to Duck type Subscribable.

      -
      -delivery
      +SourceStatus
      - -DeliverySpec - +knative.dev/pkg/apis/duck/v1.SourceStatus       		-

      For round tripping (v1beta1 <-> v1alpha1>

      +

      +(Members of SourceStatus are embedded into this type.) +
      -

      InMemoryChannelStatus -

      +
      +

      sources.knative.dev/v1alpha2

      -(Appears on: -InMemoryChannel) +

      Package v1alpha2 contains API Schema definitions for the sources v1beta1 API group

      +Resource Types: + +

      ApiServerSource +

      -

      ChannelStatus represents the current state of a Channel.

      +

      ApiServerSource is the Schema for the apiserversources API

      @@ -4468,74 +4015,161 @@ DeliverySpec + + + + + + + + + + + + +
      -Status
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha2 + +
      +kind
      +string +      		ApiServerSource
      +metadata
      + + +Kubernetes meta/v1.ObjectMeta + + +      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      +spec
      + + +ApiServerSourceSpec + + +      		 +
      +
      + + + + + + + + + + + + + + + + + + + + +
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +resources
      + + +[]APIVersionKind + + +      		 +

      Resource is the resource this source will track and send related +lifecycle events from the Kubernetes ApiServer.

      +
      +selector
      + + +Kubernetes meta/v1.LabelSelector + + +      		 +(Optional) +

      LabelSelector filters this source to objects to those resources pass the +label selector. +More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

      +
      +owner
      + + +APIVersionKind + + +      		 +(Optional) +

      ResourceOwner is an additional filter to only track resources that are +owned by a specific resource type. If ResourceOwner matches Resources[n] +then Resources[n] is allowed to pass the ResourceOwner filter.

      +
      +mode
      -knative.dev/pkg/apis/duck/v1.Status +string       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +(Optional) +

      EventMode controls the format of the event. +Reference sends a dataref event type for the resource under watch. +Resource send the full resource lifecycle event. +Defaults to Reference
      -AddressStatus
      +serviceAccountName
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus +string       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      InMemoryChannel 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}

      +(Optional) +

      ServiceAccountName is the name of the ServiceAccount to use to run this +source. Defaults to default if not set.

      +
      -SubscribableTypeStatus
      +status
      - -SubscribableTypeStatus + +ApiServerSourceStatus       		-

      -(Members of SubscribableTypeStatus are embedded into this type.) -

      -

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.
      -

      SubscriptionSpec +

      PingSource

      -(Appears on: -Subscription) -

      -

      -

      SubscriptionSpec specifies the Channel for incoming events, a Subscriber target -for processing those events and where to put the result of the processing. Only -From (where the events are coming from) is always required. You can optionally -only Process the events (results in no output events) by leaving out the Result. -You can also perform an identity transformation on the incoming events by leaving -out the Subscriber and only specifying Result.

      -

      The following are all valid specifications: -channel –[subscriber]–> reply -Sink, no outgoing events: -channel – subscriber -no-op function (identity transformation): -channel –> reply

      +

      PingSource is the Schema for the PingSources API.

      @@ -4547,89 +4181,118 @@ channel –> reply

      + + + + + + + +
      -generation
      +apiVersion
      +string      		 + +sources.knative.dev/v1alpha2 + +
      +kind
      +string +      		PingSource
      +metadata
      -int64 + +Kubernetes meta/v1.ObjectMeta +       		-(Optional) -

      TODO By enabling the status subresource metadata.generation should increment -thus making this property obsolete.

      -

      We should be able to drop this property with a CRD conversion webhook -in the future

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -channel
      +spec
      - -Kubernetes core/v1.ObjectReference + +PingSourceSpec       		-

      This field is immutable. We have no good answer on what happens to -the events that are currently in the channel being consumed from -and what the semantics there should be. For now, you can always -delete the Subscription and recreate it to point to a different -channel, giving the user more control over what semantics should -be used (drain the channel first, possibly have events dropped, -etc.)

      +
      +
      + + + + + +
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.
      -subscriber
      +schedule
      -knative.dev/pkg/apis/duck/v1.Destination +string       		(Optional) -

      Subscriber is reference to (optional) function for processing events. -Events from the Channel will be delivered here and replies are -sent to a Destination as specified by the Reply.

      +

      Schedule is the cronjob schedule. Defaults to * * * * *.
      -reply
      +jsonData
      -knative.dev/pkg/apis/duck/v1.Destination +string       		(Optional) -

      Reply specifies (optionally) how to handle events returned from -the Subscriber target.

      +

      JsonData is json encoded data used as the body of the event posted to +the sink. Default is empty. If set, datacontenttype will also be set +to “application/json”.

      +
      -delivery
      +status
      - -DeliverySpec + +PingSourceStatus       		-(Optional) -

      Delivery configuration
      -

      SubscriptionStatus +

      SinkBinding

      -(Appears on: -Subscription) -

      -

      -

      SubscriptionStatus (computed) for a subscription

      +

      SinkBinding describes a Binding that is also a Source. +The sink (from the Source duck) is resolved to a URL and +then projected into the subject by augmenting the runtime +contract of the referenced containers to have a K_SINK +environment variable holding the endpoint to which to send +cloud events.

      @@ -4641,105 +4304,108 @@ DeliverySpec + + + + - -
      -Status
      - -knative.dev/pkg/apis/duck/v1.Status - +apiVersion
      +string      		 + +sources.knative.dev/v1alpha2 +
      -

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +kind
      +string       		SinkBinding
      -physicalSubscription
      +metadata
      - -SubscriptionStatusPhysicalSubscription + +Kubernetes meta/v1.ObjectMeta       		-

      PhysicalSubscription is the fully resolved values that this Subscription represents.

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -

      SubscriptionStatusPhysicalSubscription -

      -

      -(Appears on: -SubscriptionStatus) -

      -

      -

      SubscriptionStatusPhysicalSubscription represents the fully resolved values for this -Subscription.

      -

      - - - - - - - + +
      FieldDescription
      +spec
      + + +SinkBindingSpec + + +      		 +
      +
      + + +
      -subscriberURI
      +SourceSpec
      -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1.SourceSpec       		-

      SubscriberURI is the fully resolved URI for spec.subscriber.

      +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.
      -replyURI
      +BindingSpec
      -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec       		-

      ReplyURI is the fully resolved URI for the spec.reply.

      +

      +(Members of BindingSpec are embedded into this type.) +

      +

      inherits duck/v1alpha1 BindingSpec, which currently provides: +* Subject - Subject references the resource(s) whose “runtime contract” +should be augmented by Binding implementations.

      +
      -deadLetterSinkURI
      +status
      -knative.dev/pkg/apis.URL + +SinkBindingStatus +       		-

      ReplyURI is the fully resolved URI for the spec.delivery.deadLetterSink.
      -
      -

      sources.knative.dev/v1alpha2

      +

      APIVersionKind +

      -

      Package v1alpha2 contains API Schema definitions for the sources v1beta1 API group

      +(Appears on: +ApiServerSourceSpec, +ApiServerSourceSpec)

      -Resource Types: - -

      ApiServerSource -

      -

      ApiServerSource is the Schema for the apiserversources API

      +

      APIVersionKind is an APIVersion and Kind tuple.

      @@ -4752,47 +4418,47 @@ Resource Types: - - - - - - - - + + +
      apiVersion
      -string      		 - -sources.knative.dev/v1alpha2 - -
      -kind
      -string -      		ApiServerSource
      -metadata
      - -Kubernetes meta/v1.ObjectMeta - +string       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +(Optional) +

      APIVersion - the API version of the resource to watch.
      -spec
      +kind
      - -ApiServerSourceSpec - +string       		-
      -
      +(Optional) +

      Kind of the resource to watch. +More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

      +
      +

      ApiServerSourceSpec +

      +

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceSpec defines the desired state of ApiServerSource

      +

      + + + + + + + + +
      FieldDescription
      SourceSpec
      @@ -4885,27 +4551,210 @@ string source. Defaults to default if not set.
      +

      ApiServerSourceStatus +

      +

      +(Appears on: +ApiServerSource) +

      +

      +

      ApiServerSourceStatus defines the observed state of ApiServerSource

      +

      + + + + + + + + + + + + + +
      FieldDescription
      +SourceStatus
      + +knative.dev/pkg/apis/duck/v1.SourceStatus + +      		 +

      +(Members of SourceStatus are embedded into this type.) +

      +

      inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.

      +
      +

      PingSourceSpec +

      +

      +(Appears on: +PingSource) +

      +

      +

      PingSourceSpec defines the desired state of the PingSource.

      +

      + + + + + + + + + + + + + + + + + + + + +
      FieldDescription
      +SourceSpec
      + +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +schedule
      + +string + +      		 +(Optional) +

      Schedule is the cronjob schedule. Defaults to * * * * *.

      +
      +jsonData
      + +string + +      		 +(Optional) +

      JsonData is json encoded data used as the body of the event posted to +the sink. Default is empty. If set, datacontenttype will also be set +to “application/json”.

      +
      +

      PingSourceStatus +

      +

      +(Appears on: +PingSource) +

      +

      +

      PingSourceStatus defines the observed state of PingSource.

      +

      + + + + + + + + + + + + +
      FieldDescription
      +SourceStatus
      + +knative.dev/pkg/apis/duck/v1.SourceStatus + +      		 +

      +(Members of SourceStatus are embedded into this type.) +

      +

      inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.
      +

      SinkBindingSpec +

      +

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      +

      + + + + + + + + + + + +
      FieldDescription
      -status
      +SourceSpec
      - -ApiServerSourceStatus - +knative.dev/pkg/apis/duck/v1.SourceSpec + +      		 +

      +(Members of SourceSpec are embedded into this type.) +

      +

      inherits duck/v1 SourceSpec, which currently provides: +* Sink - a reference to an object that will resolve to a domain name or +a URI directly to use as the sink. +* CloudEventOverrides - defines overrides to control the output format +and modifications of the event sent to the sink.

      +
      +BindingSpec
      + +knative.dev/pkg/apis/duck/v1alpha1.BindingSpec       		+

      +(Members of BindingSpec are embedded into this type.) +

      +

      inherits duck/v1alpha1 BindingSpec, which currently provides: +* Subject - Subject references the resource(s) whose “runtime contract” +should be augmented by Binding implementations.
      -

      PingSource +

      SinkBindingStatus

      -

      PingSource is the Schema for the PingSources API.

      +(Appears on: +SinkBinding) +

      +

      +

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      @@ -4917,21 +4766,48 @@ ApiServerSourceStatus +SourceStatus
      + +knative.dev/pkg/apis/duck/v1.SourceStatus + + + +
      -apiVersion
      -string      		 - -sources.knative.dev/v1alpha2 - +

      +(Members of SourceStatus are embedded into this type.) +

      +

      inherits duck/v1 SourceStatus, 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. +* SinkURI - the current active sink URI that has been configured for the +Source.
      +
      +

      duck.knative.dev/v1alpha1

      +

      +

      Package v1alpha1 is the v1alpha1 version of the API.

      +

      +Resource Types: + +

      Channelable +

      +

      +

      Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers +defining compatible resources to embed it. We will typically use this type to deserialize +Channelable ObjectReferences and access their subscription and address data. This is not a real resource.

      +

      + + - - + + + + @@ -5020,15 +4882,14 @@ PingSourceStatus
      -kind
      -string -      		PingSourceFieldDescription
      metadata
      @@ -4950,57 +4826,43 @@ Refer to the Kubernetes API documentation for the fields of the       		spec
      - -PingSourceSpec + +ChannelableSpec       		+

      Spec is the part where the Channelable fulfills the Subscribable contract.



      - - - -
      -SourceSpec
      +SubscribableTypeSpec
      -knative.dev/pkg/apis/duck/v1.SourceSpec + +SubscribableTypeSpec +

      -(Members of SourceSpec are embedded into this type.) +(Members of SubscribableTypeSpec are embedded into this type.)

      -

      inherits duck/v1 SourceSpec, which currently provides: -* Sink - a reference to an object that will resolve to a domain name or -a URI directly to use as the sink. -* CloudEventOverrides - defines overrides to control the output format -and modifications of the event sent to the sink.

      -
      -schedule
      - -string - -      		 -(Optional) -

      Schedule is the cronjob schedule. Defaults to * * * * *.
      -jsonData
      +delivery
      -string + +DeliverySpec +       		(Optional) -

      JsonData is json encoded data used as the body of the event posted to -the sink. Default is empty. If set, datacontenttype will also be set -to “application/json”.

      +

      DeliverySpec contains options controlling the event delivery
      @@ -5010,8 +4872,8 @@ to “application/json”.

      		 status
      - -PingSourceStatus + +ChannelableStatus
      -

      SinkBinding +

      ChannelableCombined

      -

      SinkBinding describes a Binding that is also a Source. -The sink (from the Source duck) is resolved to a URL and -then projected into the subject by augmenting the runtime -contract of the referenced containers to have a K_SINK -environment variable holding the endpoint to which to send -cloud events.

      +

      ChannelableCombined is a skeleton type wrapping Subscribable and Addressable of both +v1alpha1 and v1beta1 duck types. This is not to be used by resource writers and is +only used by Subscription Controller to synthesize patches and read the Status +of the Channelable Resources. +This is not a real resource.

      @@ -5040,23 +4901,6 @@ cloud events.

      - - - - - - - - @@ -5133,15 +4990,14 @@ SinkBindingStatus
      -apiVersion
      -string      		 - -sources.knative.dev/v1alpha2 - -
      -kind
      -string -      		SinkBinding
      metadata
      @@ -5073,47 +4917,60 @@ Refer to the Kubernetes API documentation for the fields of the       		spec
      - -SinkBindingSpec + +ChannelableCombinedSpec       		+

      Spec is the part where the Channelable fulfills the Subscribable contract.



      + + + +
      -SourceSpec
      +SubscribableTypeSpec
      -knative.dev/pkg/apis/duck/v1.SourceSpec + +SubscribableTypeSpec +

      -(Members of SourceSpec are embedded into this type.) +(Members of SubscribableTypeSpec are embedded into this type.)

      -

      inherits duck/v1 SourceSpec, which currently provides: -* Sink - a reference to an object that will resolve to a domain name or -a URI directly to use as the sink. -* CloudEventOverrides - defines overrides to control the output format -and modifications of the event sent to the sink.

      +

      SubscribableTypeSpec is for the v1alpha1 spec compatibility.
      -BindingSpec
      +SubscribableSpec
      -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +SubscribableSpec +

      -(Members of BindingSpec are embedded into this type.) +(Members of SubscribableSpec are embedded into this type.)

      -

      inherits duck/v1alpha1 BindingSpec, which currently provides: -* Subject - Subject references the resource(s) whose “runtime contract” -should be augmented by Binding implementations.

      +

      SubscribableSpec is for the v1beta1 spec compatibility.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      DeliverySpec contains options controlling the event delivery
      @@ -5123,8 +4980,8 @@ should be augmented by Binding implementations.

      		 status
      - -SinkBindingStatus + +ChannelableCombinedStatus
      -

      APIVersionKind +

      ChannelableCombinedSpec

      (Appears on: -ApiServerSourceSpec, -ApiServerSourceSpec) +ChannelableCombined)

      -

      APIVersionKind is an APIVersion and Kind tuple.

      +

      ChannelableSpec contains Spec of the Channelable object

      @@ -5153,39 +5009,60 @@ SinkBindingStatus + + + +
      -apiVersion
      +SubscribableTypeSpec
      -string + +SubscribableTypeSpec +       		-(Optional) -

      APIVersion - the API version of the resource to watch.

      +

      +(Members of SubscribableTypeSpec are embedded into this type.) +

      +

      SubscribableTypeSpec is for the v1alpha1 spec compatibility.
      -kind
      +SubscribableSpec
      -string + +SubscribableSpec + + +      		 +

      +(Members of SubscribableSpec are embedded into this type.) +

      +

      SubscribableSpec is for the v1beta1 spec compatibility.

      +
      +delivery
      + + +DeliverySpec +       		(Optional) -

      Kind of the resource to watch. -More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

      +

      DeliverySpec contains options controlling the event delivery
      -

      ApiServerSourceSpec +

      ChannelableCombinedStatus

      (Appears on: -ApiServerSource) +ChannelableCombined)

      -

      ApiServerSourceSpec defines the desired state of ApiServerSource

      +

      ChannelableStatus contains the Status of a Channelable object.

      @@ -5197,106 +5074,90 @@ More info: -[]APIVersionKind - +knative.dev/pkg/apis/duck/v1.Status
      -

      Resource is the resource this source will track and send related -lifecycle events from the Kubernetes ApiServer.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -selector
      +AddressStatus
      - -Kubernetes meta/v1.LabelSelector - +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus       		-(Optional) -

      LabelSelector filters this source to objects to those resources pass the -label selector. -More info: http://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the part where the Channelable fulfills the Addressable contract.
      -owner
      +SubscribableTypeStatus
      - -APIVersionKind + +SubscribableTypeStatus       		-(Optional) -

      ResourceOwner is an additional filter to only track resources that are -owned by a specific resource type. If ResourceOwner matches Resources[n] -then Resources[n] is allowed to pass the ResourceOwner filter.

      +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      SubscribableTypeStatus is the v1alpha1 part of the Subscribers status
      -mode
      +SubscribableStatus
      -string + +SubscribableStatus +       		-(Optional) -

      EventMode controls the format of the event. -Reference sends a dataref event type for the resource under watch. -Resource send the full resource lifecycle event. -Defaults to Reference

      +

      +(Members of SubscribableStatus are embedded into this type.) +

      +

      SubscribableStatus is the v1beta1 part of the Subscribers status.
      -serviceAccountName
      +errorChannel
      -string + +Kubernetes core/v1.ObjectReference +       		(Optional) -

      ServiceAccountName is the name of the ServiceAccount to use to run this -source. Defaults to default if not set.

      +

      ErrorChannel is set by the channel when it supports native error handling via a channel
      -

      ApiServerSourceStatus +

      ChannelableSpec

      (Appears on: -ApiServerSource) +Channelable)

      -

      ApiServerSourceStatus defines the observed state of ApiServerSource

      +

      ChannelableSpec contains Spec of the Channelable object

      @@ -5308,34 +5169,43 @@ source. Defaults to default if not set.

      + + + +
      -SourceStatus
      +SubscribableTypeSpec
      -knative.dev/pkg/apis/duck/v1.SourceStatus + +SubscribableTypeSpec +

      -(Members of SourceStatus are embedded into this type.) +(Members of SubscribableTypeSpec are embedded into this type.)

      -

      inherits duck/v1 SourceStatus, 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. -* SinkURI - the current active sink URI that has been configured for the -Source.

      +
      +delivery
      + + +DeliverySpec + + +      		 +(Optional) +

      DeliverySpec contains options controlling the event delivery
      -

      PingSourceSpec +

      ChannelableStatus

      (Appears on: -PingSource) +Channelable)

      -

      PingSourceSpec defines the desired state of the PingSource.

      +

      ChannelableStatus contains the Status of a Channelable object.

      @@ -5347,58 +5217,71 @@ Source.

      + + + +
      -SourceSpec
      +Status
      -knative.dev/pkg/apis/duck/v1.SourceSpec +knative.dev/pkg/apis/duck/v1.Status

      -(Members of SourceSpec are embedded into this type.) +(Members of Status are embedded into this type.)

      -

      inherits duck/v1 SourceSpec, which currently provides: -* Sink - a reference to an object that will resolve to a domain name or -a URI directly to use as the sink. -* CloudEventOverrides - defines overrides to control the output format -and modifications of the event sent to the sink.

      +

      inherits duck/v1 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.
      -schedule
      +AddressStatus
      -string +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus       		-(Optional) -

      Schedule is the cronjob schedule. Defaults to * * * * *.

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the part where the Channelable fulfills the Addressable contract.
      -jsonData
      +SubscribableTypeStatus
      -string + +SubscribableTypeStatus + + +      		 +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      +
      +errorChannel
      + + +Kubernetes core/v1.ObjectReference +       		(Optional) -

      JsonData is json encoded data used as the body of the event posted to -the sink. Default is empty. If set, datacontenttype will also be set -to “application/json”.

      +

      ErrorChannel is set by the channel when it supports native error handling via a channel
      -

      PingSourceStatus +

      Resource

      -(Appears on: -PingSource) -

      -

      -

      PingSourceStatus defines the observed state of PingSource.

      +

      Resource is a skeleton type wrapping all Kubernetes resources. It is typically used to watch +arbitrary other resources (such as any Source or Addressable). This is not a real resource.

      @@ -5410,34 +5293,31 @@ to “application/json”.

      -SourceStatus
      +metadata
      -knative.dev/pkg/apis/duck/v1.SourceStatus + +Kubernetes meta/v1.ObjectMeta +       		-

      -(Members of SourceStatus are embedded into this type.) -

      -

      inherits duck/v1 SourceStatus, 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. -* SinkURI - the current active sink URI that has been configured for the -Source.

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -

      SinkBindingSpec +

      Subscribable

      (Appears on: -SinkBinding) +ChannelSpec, +InMemoryChannelSpec, +SubscribableTypeSpec)

      -

      SinkBindingSpec holds the desired state of the SinkBinding (from the client).

      +

      Subscribable is the schema for the subscribable portion of the spec +section of the resource.

      @@ -5449,48 +5329,28 @@ Source.

      - - - -
      -SourceSpec
      - -knative.dev/pkg/apis/duck/v1.SourceSpec - -      		 -

      -(Members of SourceSpec are embedded into this type.) -

      -

      inherits duck/v1 SourceSpec, which currently provides: -* Sink - a reference to an object that will resolve to a domain name or -a URI directly to use as the sink. -* CloudEventOverrides - defines overrides to control the output format -and modifications of the event sent to the sink.

      -
      -BindingSpec
      +subscribers
      -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +[]SubscriberSpec +       		-

      -(Members of BindingSpec are embedded into this type.) -

      -

      inherits duck/v1alpha1 BindingSpec, which currently provides: -* Subject - Subject references the resource(s) whose “runtime contract” -should be augmented by Binding implementations.

      +

      This is the list of subscriptions for this subscribable.
      -

      SinkBindingStatus +

      SubscribableStatus

      (Appears on: -SinkBinding) +SubscribableTypeStatus)

      -

      SinkBindingStatus communicates the observed state of the SinkBinding (from the controller).

      +

      SubscribableStatus is the schema for the subscribable’s status portion of the status +section of the resource.

      @@ -5502,39 +5362,25 @@ should be augmented by Binding implementations.

      - -
      -SourceStatus
      +subscribers
      -knative.dev/pkg/apis/duck/v1.SourceStatus + +[]SubscriberStatus +       		-

      -(Members of SourceStatus are embedded into this type.) -

      -

      inherits duck/v1 SourceStatus, 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. -* SinkURI - the current active sink URI that has been configured for the -Source.

      +

      This is the list of subscription’s statuses for this channel.
      -
      -

      duck.knative.dev/v1alpha1

      -

      -

      Package v1alpha1 is the v1alpha1 version of the API.

      -

      -Resource Types: - -

      Channelable + + +

      SubscribableType

      -

      Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers +

      SubscribableType is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize -Channelable ObjectReferences and access their subscription and address data. This is not a real resource.

      +SubscribableType ObjectReferences and access the Subscription data. This is not a real resource.

      @@ -5562,54 +5408,73 @@ Refer to the Kubernetes API documentation for the fields of the +
      spec
      - -ChannelableSpec + +SubscribableTypeSpec       		-

      Spec is the part where the Channelable fulfills the Subscribable contract.

      +

      SubscribableTypeSpec is the part where Subscribable object is +configured as to be compatible with Subscribable contract.



      + +
      -SubscribableTypeSpec
      +subscribable
      - -SubscribableTypeSpec + +Subscribable       		-

      -(Members of SubscribableTypeSpec are embedded into this type.) -

      +
      -delivery
      +status
      - -DeliverySpec + +SubscribableTypeStatus       		-(Optional) -

      DeliverySpec contains options controlling the event delivery

      +

      SubscribableTypeStatus is the part where SubscribableStatus object is +configured as to be compatible with Subscribable contract.
      - +

      SubscribableTypeSpec +

      +

      +(Appears on: +ChannelableCombinedSpec, +ChannelableSpec, +SubscribableType) +

      +

      +

      SubscribableTypeSpec shows how we expect folks to embed Subscribable in their Spec field.

      +

      + + + + + + + @@ -5618,14 +5483,18 @@ ChannelableStatus
      FieldDescription
      -status
      +subscribable
      - -ChannelableStatus + +Subscribable
      -

      ChannelableCombined +

      SubscribableTypeStatus

      -

      ChannelableCombined is a skeleton type wrapping Subscribable and Addressable of both -v1alpha1 and v1beta1 duck types. This is not to be used by resource writers and is -only used by Subscription Controller to synthesize patches and read the Status -of the Channelable Resources. -This is not a real resource.

      +(Appears on: +ChannelStatus, +ChannelableCombinedStatus, +ChannelableStatus, +InMemoryChannelStatus, +SubscribableType) +

      +

      +

      SubscribableTypeStatus shows how we expect folks to embed Subscribable in their Status field.

      @@ -5637,103 +5506,119 @@ This is not a real resource.

      + +
      -metadata
      +subscribableStatus
      - -Kubernetes meta/v1.ObjectMeta + +SubscribableStatus       		-Refer to the Kubernetes API documentation for the fields of the -metadata field.
      +

      SubscriberSpec +

      +

      +(Appears on: +Subscribable) +

      +

      +

      SubscriberSpec defines a single subscriber to a Subscribable. +Ref is a reference to the Subscription this SubscriberSpec was created for +SubscriberURI is the endpoint for the subscriber +ReplyURI is the endpoint for the reply +At least one of SubscriberURI and ReplyURI must be present

      +

      + + + + + + + + + +
      FieldDescription
      -spec
      +uid
      - -ChannelableCombinedSpec - +k8s.io/apimachinery/pkg/types.UID       		-

      Spec is the part where the Channelable fulfills the Subscribable contract.

      -
      -
      - +(Optional) +

      UID is used to understand the origin of the subscriber.

      + + -
      -SubscribableTypeSpec
      +generation
      - -SubscribableTypeSpec - +int64       		-

      -(Members of SubscribableTypeSpec are embedded into this type.) -

      -

      SubscribableTypeSpec is for the v1alpha1 spec compatibility.

      +(Optional) +

      Generation of the origin of the subscriber with uid:UID.
      -SubscribableSpec
      +subscriberURI
      - -SubscribableSpec - +knative.dev/pkg/apis.URL       		-

      -(Members of SubscribableSpec are embedded into this type.) -

      -

      SubscribableSpec is for the v1beta1 spec compatibility.

      +(Optional)
      -delivery
      +replyURI
      - -DeliverySpec - +knative.dev/pkg/apis.URL       		(Optional) -

      DeliverySpec contains options controlling the event delivery
      +
      +deadLetterSink
      + +knative.dev/pkg/apis.URL + +      		 +(Optional)
      -status
      +delivery
      - -ChannelableCombinedStatus + +DeliverySpec       		+(Optional)
      -

      ChannelableCombinedSpec +

      SubscriberStatus

      (Appears on: -ChannelableCombined) +SubscribableStatus)

      -

      ChannelableSpec contains Spec of the Channelable object

      +

      SubscriberStatus defines the status of a single subscriber to a Channel.

      @@ -5745,60 +5630,78 @@ ChannelableCombinedStatus + + + +
      -SubscribableTypeSpec
      +uid
      - -SubscribableTypeSpec - +k8s.io/apimachinery/pkg/types.UID       		-

      -(Members of SubscribableTypeSpec are embedded into this type.) -

      -

      SubscribableTypeSpec is for the v1alpha1 spec compatibility.

      +(Optional) +

      UID is used to understand the origin of the subscriber.
      -SubscribableSpec
      +observedGeneration
      - -SubscribableSpec - +int64       		-

      -(Members of SubscribableSpec are embedded into this type.) -

      -

      SubscribableSpec is for the v1beta1 spec compatibility.

      +(Optional) +

      Generation of the origin of the subscriber with uid:UID.
      -delivery
      +ready
      - -DeliverySpec + +Kubernetes core/v1.ConditionStatus       		(Optional) -

      DeliverySpec contains options controlling the event delivery

      +

      Status of the subscriber.

      +
      +message
      + +string + +      		 +(Optional) +

      A human readable message indicating details of Ready status.
      -

      ChannelableCombinedStatus -

      +
      +

      duck.knative.dev/v1beta1

      +

      +

      Package v1beta1 is the v1beta1 version of the API.

      +

      +Resource Types: + +

      BackoffPolicyType +(string alias)

      (Appears on: -ChannelableCombined) +DeliverySpec)

      -

      ChannelableStatus contains the Status of a Channelable object.

      +

      BackoffPolicyType is the type for backoff policies

      +

      +

      Channelable +

      +

      +

      Channelable is a skeleton type wrapping Subscribable and Addressable in the manner we expect resource writers +defining compatible resources to embed it. We will typically use this type to deserialize +Channelable ObjectReferences and access their subscription and address data. This is not a real resource.

      @@ -5810,87 +5713,85 @@ DeliverySpec - + - +

      Spec is the part where the Channelable fulfills the Subscribable contract.

      +
      +
      +
      -Status
      +metadata
      -knative.dev/pkg/apis/duck/v1.Status + +Kubernetes meta/v1.ObjectMeta +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      -      		 +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
      -AddressStatus
      +spec
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus + +ChannelableSpec +       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the part where the Channelable fulfills the Addressable contract.

      -
      + +
      -SubscribableTypeStatus
      +SubscribableSpec
      - -SubscribableTypeStatus + +SubscribableSpec

      -(Members of SubscribableTypeStatus are embedded into this type.) +(Members of SubscribableSpec are embedded into this type.)

      -

      SubscribableTypeStatus is the v1alpha1 part of the Subscribers status
      -SubscribableStatus
      +delivery
      - -SubscribableStatus + +DeliverySpec       		-

      -(Members of SubscribableStatus are embedded into this type.) -

      -

      SubscribableStatus is the v1beta1 part of the Subscribers status.

      +(Optional) +

      DeliverySpec contains options controlling the event delivery

      +
      -errorChannel
      +status
      - -Kubernetes core/v1.ObjectReference + +ChannelableStatus -(Optional) -

      ErrorChannel is set by the channel when it supports native error handling via a channel

      -

      ChannelableSpec +

      ChannelableSpec

      (Appears on: -Channelable) +ChannelSpec, +Channelable, +InMemoryChannelSpec)

      ChannelableSpec contains Spec of the Channelable object

      @@ -5905,16 +5806,16 @@ Kubernetes core/v1.ObjectReference -SubscribableTypeSpec
      +SubscribableSpec
      - -SubscribableTypeSpec + +SubscribableSpec

      -(Members of SubscribableTypeSpec are embedded into this type.) +(Members of SubscribableSpec are embedded into this type.)

      @@ -5934,11 +5835,13 @@ DeliverySpec -

      ChannelableStatus +

      ChannelableStatus

      (Appears on: -Channelable) +ChannelStatus, +Channelable, +InMemoryChannelStatus)

      ChannelableStatus contains the Status of a Channelable object.

      @@ -5971,7 +5874,7 @@ knative.dev/pkg/apis/duck/v1.Status AddressStatus
      -knative.dev/pkg/apis/duck/v1alpha1.AddressStatus +knative.dev/pkg/apis/duck/v1.AddressStatus @@ -5983,41 +5886,56 @@ knative.dev/pkg/apis/duck/v1alpha1.AddressStatus -SubscribableTypeStatus
      +SubscribableStatus
      - -SubscribableTypeStatus + +SubscribableStatus

      -(Members of SubscribableTypeStatus are embedded into this type.) +(Members of SubscribableStatus are embedded into this type.)

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      -errorChannel
      +deadLetterChannel
      - -Kubernetes core/v1.ObjectReference - +knative.dev/pkg/apis/duck/v1.KReference (Optional) -

      ErrorChannel is set by the channel when it supports native error handling via a channel

      +

      DeadLetterChannel is a KReference and is set by the channel when it supports native error handling via a channel +Failed messages are delivered here.

      -

      Resource +

      DeliverySpec

      -

      Resource is a skeleton type wrapping all Kubernetes resources. It is typically used to watch -arbitrary other resources (such as any Source or Addressable). This is not a real resource.

      +(Appears on: +BrokerSpec, +BrokerSpec, +ChannelSpec, +ChannelableCombinedSpec, +ChannelableSpec, +ChannelableSpec, +InMemoryChannelSpec, +SequenceStep, +SequenceStep, +SubscriberSpec, +SubscriberSpec, +SubscriptionSpec, +SubscriptionSpec) +

      +

      +

      DeliverySpec contains the delivery options for event senders, +such as channelable and source.

      @@ -6029,64 +5947,65 @@ arbitrary other resources (such as any Source or Addressable). This is not a rea - -
      -metadata
      +deadLetterSink
      - -Kubernetes meta/v1.ObjectMeta - +knative.dev/pkg/apis/duck/v1.Destination       		-Refer to the Kubernetes API documentation for the fields of the -metadata field. +(Optional) +

      DeadLetterSink is the sink receiving event that couldn’t be sent to +a destination.
      -

      Subscribable -

      -

      -(Appears on: -ChannelSpec, -InMemoryChannelSpec, -SubscribableTypeSpec) -

      -

      -

      Subscribable is the schema for the subscribable portion of the spec -section of the resource.

      -

      - - - - + + - - + + + +
      FieldDescription +retry
      + +int32 + +      		 +(Optional) +

      Retry is the minimum number of retries the sender should attempt when +sending an event before moving it to the dead letter sink.

      +
      -subscribers
      +backoffPolicy
      - -[]SubscriberSpec + +BackoffPolicyType       		-

      This is the list of subscriptions for this subscribable.

      +(Optional) +

      BackoffPolicy is the retry backoff policy (linear, exponential)

      +
      +backoffDelay
      + +string + +      		 +(Optional) +

      BackoffDelay is the delay before retrying. +More information on Duration format: https://www.ietf.org/rfc/rfc3339.txt

      +

      For linear policy, backoff delay is the time interval between retries. +For exponential policy , backoff delay is backoffDelay*2^
      -

      SubscribableStatus +

      DeliveryStatus

      -(Appears on: -SubscribableTypeStatus) -

      -

      -

      SubscribableStatus is the schema for the subscribable’s status portion of the status -section of the resource.

      +

      DeliveryStatus contains the Status of an object supporting delivery options.

      @@ -6098,23 +6017,23 @@ section of the resource.

      -subscribers
      +deadLetterChannel
      - -[]SubscriberStatus - +knative.dev/pkg/apis/duck/v1.KReference       		-

      This is the list of subscription’s statuses for this channel.

      +(Optional) +

      DeadLetterChannel is a KReference that is the reference to the native, platform specific channel +where failed events are sent to.
      -

      SubscribableType +

      Subscribable

      -

      SubscribableType is a skeleton type wrapping Subscribable in the manner we expect resource writers +

      Subscribable is a skeleton type wrapping Subscribable in the manner we expect resource writers defining compatible resources to embed it. We will typically use this type to deserialize SubscribableType ObjectReferences and access the Subscription data. This is not a real resource.

      @@ -6144,27 +6063,28 @@ Refer to the Kubernetes API documentation for the fields of the spec
      - -SubscribableTypeSpec + +SubscribableSpec -

      SubscribableTypeSpec is the part where Subscribable object is +

      SubscribableSpec is the part where Subscribable object is configured as to be compatible with Subscribable contract.



      -subscribable
      +subscribers
      - -Subscribable + +[]SubscriberSpec       		+

      This is the list of subscriptions for this subscribable.
      @@ -6174,28 +6094,28 @@ Subscribable status
      - -SubscribableTypeStatus + +SubscribableStatus -

      SubscribableTypeStatus is the part where SubscribableStatus object is +

      SubscribableStatus is the part where SubscribableStatus object is configured as to be compatible with Subscribable contract.

      -

      SubscribableTypeSpec +

      SubscribableSpec

      (Appears on: ChannelableCombinedSpec, -ChannelableSpec, -SubscribableType) +ChannelableSpec, +Subscribable)

      -

      SubscribableTypeSpec shows how we expect folks to embed Subscribable in their Spec field.

      +

      SubscribableSpec shows how we expect folks to embed Subscribable in their Spec field.

      @@ -6207,30 +6127,30 @@ configured as to be compatible with Subscribable contract.

      -subscribable
      +subscribers
      - -Subscribable + +[]SubscriberSpec       		+

      This is the list of subscriptions for this subscribable.
      -

      SubscribableTypeStatus +

      SubscribableStatus

      (Appears on: -ChannelStatus, ChannelableCombinedStatus, -ChannelableStatus, -InMemoryChannelStatus, -SubscribableType) +ChannelableStatus, +Subscribable)

      -

      SubscribableTypeStatus shows how we expect folks to embed Subscribable in their Status field.

      +

      SubscribableStatus is the schema for the subscribable’s status portion of the status +section of the resource.

      @@ -6242,30 +6162,28 @@ Subscribable
      -subscribableStatus
      +subscribers
      - -SubscribableStatus + +[]SubscriberStatus       		+

      This is the list of subscription’s statuses for this channel.
      -

      SubscriberSpec +

      SubscriberSpec

      (Appears on: -Subscribable) +SubscribableSpec)

      -

      SubscriberSpec defines a single subscriber to a Subscribable. -Ref is a reference to the Subscription this SubscriberSpec was created for -SubscriberURI is the endpoint for the subscriber -ReplyURI is the endpoint for the reply -At least one of SubscriberURI and ReplyURI must be present

      +

      SubscriberSpec defines a single subscriber to a Subscribable.

      +

      At least one of SubscriberURI and ReplyURI must be present

      @@ -6301,35 +6219,26 @@ int64 - - - - @@ -6343,15 +6252,16 @@ DeliverySpec
      -subscriberURI
      - -knative.dev/pkg/apis.URL - -      		 -(Optional) -
      -replyURI
      +subscriberUri
      knative.dev/pkg/apis.URL       		(Optional) +

      SubscriberURI is the endpoint for the subscriber
      -deadLetterSink
      +replyUri
      knative.dev/pkg/apis.URL       		(Optional) +

      ReplyURI is the endpoint for the reply
      (Optional) +

      DeliverySpec contains options controlling the event delivery
      -

      SubscriberStatus +

      SubscriberStatus

      (Appears on: -SubscribableStatus) +SubscribableStatus)

      SubscriberStatus defines the status of a single subscriber to a Channel.

      @@ -6398,7 +6308,6 @@ Kubernetes core/v1.ConditionStatus -(Optional)

      Status of the subscriber.

      @@ -6417,26 +6326,17 @@ string
      -

      eventing.knative.dev/v1alpha1

      +

      flows.knative.dev/v1beta1

      -

      Package v1alpha1 is the v1alpha1 version of the API.

      +

      Package v1beta1 is the v1beta1 version of the API.

      Resource Types: - -

      Broker + +

      Parallel

      -

      Broker collects a pool of events that are consumable using Triggers. Brokers -provide a well-known endpoint for event delivery that senders can use with -minimal knowledge of the event routing strategy. Receivers use Triggers to -request delivery of events from a Broker’s pool to a specific URL or -Addressable endpoint.

      +

      Parallel defines conditional branches that will be wired in +series through Channels and Subscriptions.

      @@ -6448,23 +6348,6 @@ Addressable endpoint.

      - - - - - - - -
      -apiVersion
      -string      		 - -eventing.knative.dev/v1alpha1 - -
      -kind
      -string -      		Broker
      metadata
      @@ -6482,62 +6365,55 @@ Refer to the Kubernetes API documentation for the fields of the       		spec
      - -BrokerSpec + +ParallelSpec       		-

      Spec defines the desired state of the Broker.

      +

      Spec defines the desired state of the Parallel.



      -channelTemplateSpec
      +branches
      - -ChannelTemplateSpec + +[]ParallelBranch       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the -Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there -are no defaults for the namespace). -Deprecated: See spec.config to configure aditional broker options. -Unless class is for channel based broker implementation.

      +

      Branches is the list of Filter/Subscribers pairs.
      -config
      +channelTemplate
      -knative.dev/pkg/apis/duck/v1.KReference + +ChannelTemplateSpec +       		(Optional) -

      Config is a KReference to the configuration that specifies -configuration options for this Broker. For example, this could be -a pointer to a ConfigMap. -NOTE: this is for backwards compatibility with v1alpha1 <-> v1beta1 conversions.

      +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -delivery
      +reply
      - -DeliverySpec - +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Delivery is the delivery specification to be used internally by the broker to -create subscriptions.

      +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply
      @@ -6547,22 +6423,26 @@ create subscriptions.

      		 status
      - -BrokerStatus + +ParallelStatus       		(Optional) -

      Status represents the current state of the Broker. This data may be out of +

      Status represents the current state of the Parallel. This data may be out of date.
      -

      EventType +

      ParallelBranch

      +(Appears on: +ParallelSpec) +

      +

      @@ -6574,133 +6454,210 @@ date.

      +filter
      + +knative.dev/pkg/apis/duck/v1.Destination + + + - + +
      -apiVersion
      -string      		 - -eventing.knative.dev/v1alpha1 - +(Optional) +

      Filter is the expression guarding the branch
      -kind
      -string +subscriber
      + +knative.dev/pkg/apis/duck/v1.Destination + +      		 +

      Subscriber receiving the event when the filter passes

      		EventType
      -metadata
      +reply
      - -Kubernetes meta/v1.ObjectMeta - +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Reply is a Reference to where the result of Subscriber of this case gets sent to. +If not specified, sent the result to the Parallel Reply
      +

      ParallelBranchStatus +

      +

      +(Appears on: +ParallelStatus) +

      +

      +

      ParallelBranchStatus represents the current state of a Parallel branch

      +

      + + + + + + + +
      FieldDescription
      -spec
      +filterSubscriptionStatus
      - -EventTypeSpec + +ParallelSubscriptionStatus       		-

      Spec defines the desired state of the EventType.

      -
      -
      - +

      FilterSubscriptionStatus corresponds to the filter subscription status.

      + + + +
      -type
      +filterChannelStatus
      -string + +ParallelChannelStatus +       		-

      Type represents the CloudEvents type. It is authoritative.

      +

      FilterChannelStatus corresponds to the filter channel status.
      -source
      +subscriberSubscriptionStatus
      -string + +ParallelSubscriptionStatus +       		-

      Source is a URI, it represents the CloudEvents source.

      +

      SubscriptionStatus corresponds to the subscriber subscription status.
      +

      ParallelChannelStatus +

      +

      +(Appears on: +ParallelBranchStatus, +ParallelStatus) +

      +

      +

      + + + + + + + + + + + + + +
      FieldDescription
      -schema
      +channel
      -string + +Kubernetes core/v1.ObjectReference +       		-(Optional) -

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. -It may be a JSON schema, a protobuf schema, etc. It is optional.

      +

      Channel is the reference to the underlying channel.

      +
      +ready
      + +knative.dev/pkg/apis.Condition + +      		 +

      ReadyCondition indicates whether the Channel is ready or not.
      +

      ParallelSpec +

      +

      +(Appears on: +Parallel) +

      +

      +

      + + + + + + + + - -
      FieldDescription
      -broker
      +branches
      -string + +[]ParallelBranch +       		-

      Broker refers to the Broker that can provide the EventType.

      +

      Branches is the list of Filter/Subscribers pairs.
      -description
      +channelTemplate
      -string + +ChannelTemplateSpec +       		(Optional) -

      Description is an optional field used to describe the EventType, in any meaningful way.

      -
      +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -status
      +reply
      - -EventTypeStatus - +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Status represents the current state of the EventType. -This data may be out of date.

      +

      Reply is a Reference to where the result of a case Subscriber gets sent to +when the case does not have a Reply
      -

      Trigger +

      ParallelStatus

      -

      Trigger represents a request to have events delivered to a consumer from a -Broker’s event pool.

      +(Appears on: +Parallel) +

      +

      +

      ParallelStatus represents the current state of a Parallel.

      @@ -6712,116 +6669,112 @@ Broker’s event pool.

      - - - -
      -apiVersion
      -string      		 - -eventing.knative.dev/v1alpha1 - +Status
      + +knative.dev/pkg/apis/duck/v1.Status +
      -kind
      -string +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.

      		Trigger
      -metadata
      +ingressChannelStatus
      - -Kubernetes meta/v1.ObjectMeta + +ParallelChannelStatus       		-(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      IngressChannelStatus corresponds to the ingress channel status.
      -spec
      +branchStatuses
      - -TriggerSpec + +[]ParallelBranchStatus       		-

      Spec defines the desired state of the Trigger.

      -
      -
      - - - - + +
      -broker
      - -string - -      		 -

      Broker is the broker that this trigger receives events from. If not specified, will default -to ‘default’.

      +

      BranchStatuses is an array of corresponding to branch statuses. +Matches the Spec.Branches array in the order.
      -filter
      +AddressStatus
      - -TriggerFilter - +knative.dev/pkg/apis/duck/v1.AddressStatus       		-(Optional) -

      Filter is the filter to apply against all events from the Broker. Only events that pass this -filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the starting point to this Parallel. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}
      +

      ParallelSubscriptionStatus +

      +

      +(Appears on: +ParallelBranchStatus) +

      +

      +

      + + + + + + + + - -
      FieldDescription
      -subscriber
      +subscription
      -knative.dev/pkg/apis/duck/v1.Destination + +Kubernetes core/v1.ObjectReference +       		-

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It -is required.

      -
      +

      Subscription is the reference to the underlying Subscription.
      -status
      +ready
      - -TriggerStatus - +knative.dev/pkg/apis.Condition       		-(Optional) -

      Status represents the current state of the Trigger. This data may be out of -date.

      +

      ReadyCondition indicates whether the Subscription is ready or not.
      -

      BrokerSpec +

      Sequence

      -(Appears on: -Broker) -

      -

      +

      Sequence defines a sequence of Subscribers that will be wired in +series through Channels and Subscriptions.

      @@ -6833,121 +6786,99 @@ date.

      - +

      Spec defines the desired state of the Sequence.

      +
      +
      +
      -channelTemplateSpec
      +metadata
      - -ChannelTemplateSpec + +Kubernetes meta/v1.ObjectMeta       		(Optional) -

      ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the -Broker. If left unspecified, it is set to the default Channel CRD for the namespace (or cluster, in case there -are no defaults for the namespace). -Deprecated: See spec.config to configure aditional broker options. -Unless class is for channel based broker implementation.

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -config
      +spec
      -knative.dev/pkg/apis/duck/v1.KReference + +SequenceSpec +       		-(Optional) -

      Config is a KReference to the configuration that specifies -configuration options for this Broker. For example, this could be -a pointer to a ConfigMap. -NOTE: this is for backwards compatibility with v1alpha1 <-> v1beta1 conversions.

      -
      - -
      -delivery
      +steps
      - -DeliverySpec + +[]SequenceStep       		-(Optional) -

      Delivery is the delivery specification to be used internally by the broker to -create subscriptions.

      +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided. Each step has its own delivery options
      -

      BrokerStatus -

      -

      -(Appears on: -Broker) -

      -

      -

      BrokerStatus represents the current state of a Broker.

      -

      - - - - - - - - + +
      FieldDescription
      -Status
      +channelTemplate
      -knative.dev/pkg/apis/duck/v1.Status + +ChannelTemplateSpec +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -address
      +reply
      -knative.dev/pkg/apis/duck/v1alpha1.Addressable +knative.dev/pkg/apis/duck/v1.Destination       		-

      Broker 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 {broker}-router.{namespace}.svc.{cluster domain name}

      +(Optional) +

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +
      -triggerChannel
      +status
      - -Kubernetes core/v1.ObjectReference + +SequenceStatus -

      TriggerChannel is an objectref to the object for the TriggerChannel

      +(Optional) +

      Status represents the current state of the Sequence. This data may be out of +date.

      -

      EventTypeSpec +

      SequenceChannelStatus

      (Appears on: -EventType) +SequenceStatus)

      @@ -6961,72 +6892,97 @@ Kubernetes core/v1.ObjectReference -type
      +channel
      -string + +Kubernetes core/v1.ObjectReference + -

      Type represents the CloudEvents type. It is authoritative.

      +

      Channel is the reference to the underlying channel.

      -source
      +ready
      -string +knative.dev/pkg/apis.Condition -

      Source is a URI, it represents the CloudEvents source.

      +

      ReadyCondition indicates whether the Channel is ready or not.

      + + +

      SequenceSpec +

      +

      +(Appears on: +Sequence) +

      +

      +

      + + + + + + + +
      FieldDescription
      -schema
      +steps
      -string + +[]SequenceStep +       		-(Optional) -

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. -It may be a JSON schema, a protobuf schema, etc. It is optional.

      +

      Steps is the list of Destinations (processors / functions) that will be called in the order +provided. Each step has its own delivery options
      -broker
      +channelTemplate
      -string + +ChannelTemplateSpec +       		-

      Broker refers to the Broker that can provide the EventType.

      +(Optional) +

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD +for the namespace (or cluster, in case there are no defaults for the namespace).
      -description
      +reply
      -string +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Description is an optional field used to describe the EventType, in any meaningful way.

      +

      Reply is a Reference to where the result of the last Subscriber gets sent to.
      -

      EventTypeStatus +

      SequenceStatus

      (Appears on: -EventType) +Sequence)

      -

      EventTypeStatus represents the current state of a EventType.

      +

      SequenceStatus represents the current state of a Sequence.

      @@ -7052,13 +7008,57 @@ knative.dev/pkg/apis/duck/v1.Status * Conditions - the latest available observations of a resource’s current state.

      + + + + + + + + + + + +
      +subscriptionStatuses
      + + +[]SequenceSubscriptionStatus + + +      		 +

      SubscriptionStatuses is an array of corresponding Subscription statuses. +Matches the Spec.Steps array in the order.

      +
      +channelStatuses
      + + +[]SequenceChannelStatus + + +      		 +

      ChannelStatuses is an array of corresponding Channel statuses. +Matches the Spec.Steps array in the order.

      +
      +AddressStatus
      + +knative.dev/pkg/apis/duck/v1.AddressStatus + +      		 +

      +(Members of AddressStatus are embedded into this type.) +

      +

      AddressStatus is the starting point to this Sequence. Sending to this +will target the first subscriber. +It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      +
      -

      TriggerFilter +

      SequenceStep

      (Appears on: -TriggerSpec) +SequenceSpec)

      @@ -7072,61 +7072,42 @@ knative.dev/pkg/apis/duck/v1.Status -sourceAndType
      +Destination
      - -TriggerFilterSourceAndType - +knative.dev/pkg/apis/duck/v1.Destination -(Optional) -

      DeprecatedSourceAndType filters events based on exact matches on the -CloudEvents type and source attributes. This field has been replaced by the -Attributes field.

      +

      +(Members of Destination are embedded into this type.) +

      +

      Subscriber receiving the step event

      -attributes
      +delivery
      - -TriggerFilterAttributes + +DeliverySpec (Optional) -

      Attributes filters events by exact match on event context attributes. -Each key in the map is compared with the equivalent key in the event -context. An event passes the filter if all values are equal to the -specified values.

      -

      Nested context attributes are not supported as keys. Only string values are supported.

      +

      Delivery is the delivery specification for events to the subscriber +This includes things like retries, DLQ, etc.

      -

      TriggerFilterAttributes -(map[string]string alias)

      -

      -(Appears on: -TriggerFilter) -

      -

      -

      TriggerFilterAttributes is a map of context attribute names to values for -filtering by equality. Only exact matches will pass the filter. You can use the value “ -to indicate all strings match.

      -

      -

      TriggerFilterSourceAndType +

      SequenceSubscriptionStatus

      (Appears on: -TriggerFilter) +SequenceStatus)

      -

      TriggerFilterSourceAndType filters events based on exact matches on the cloud event’s type and -source attributes. Only exact matches will pass the filter. Either or both type and source can -use the value “ to indicate all strings match.

      @@ -7138,33 +7119,47 @@ use the value “ to indicate all strings match.

      -type
      +subscription
      -string + +Kubernetes core/v1.ObjectReference +       		+

      Subscription is the reference to the underlying Subscription.
      -source
      +ready
      -string +knative.dev/pkg/apis.Condition       		+

      ReadyCondition indicates whether the Subscription is ready or not.
      -

      TriggerSpec -

      +
      +

      messaging.knative.dev/v1alpha1

      -(Appears on: -Trigger) +

      Package v1alpha1 is the v1alpha1 version of the API.

      +Resource Types: + +

      Channel +

      +

      Channel represents a generic Channel. It is normally used when we want a Channel, but don’t need a specific Channel implementation.

      @@ -7176,112 +7171,114 @@ string + + + +
      -broker
      - -string - +apiVersion
      +string      		 + +messaging.knative.dev/v1alpha1 +
      -

      Broker is the broker that this trigger receives events from. If not specified, will default -to ‘default’.

      +kind
      +string       		Channel
      -filter
      +metadata
      - -TriggerFilter + +Kubernetes meta/v1.ObjectMeta       		(Optional) -

      Filter is the filter to apply against all events from the Broker. Only events that pass this -filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -subscriber
      +spec
      -knative.dev/pkg/apis/duck/v1.Destination + +ChannelSpec +       		-

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It -is required.

      +

      Spec defines the desired state of the Channel.

      +
      +
      + + + + - -
      +channelTemplate
      + + +ChannelTemplateSpec + + +      		 +

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.
      -

      TriggerStatus -

      -

      -(Appears on: -Trigger) -

      -

      -

      TriggerStatus represents the current state of a Trigger.

      -

      - - - - + + - - + +
      FieldDescription +subscribable
      + + +Subscribable + + +      		 +

      Channel conforms to Duck type Subscribable.

      +
      -Status
      +delivery
      -knative.dev/pkg/apis/duck/v1.Status + +DeliverySpec +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Delivery options.

      +
      -subscriberURI
      +status
      -knative.dev/pkg/apis.URL + +ChannelStatus +       		-

      SubscriberURI is the resolved URI of the receiver for this Trigger.

      +(Optional) +

      Status represents the current state of the Channel. This data may be out of +date.
      -
      -

      eventing.knative.dev/v1beta1

      -

      -

      Package v1beta1 is the v1beta1 version of the API.

      -

      -Resource Types: - -

      Broker +

      InMemoryChannel

      -

      Broker collects a pool of events that are consumable using Triggers. Brokers -provide a well-known endpoint for event delivery that senders can use with -minimal knowledge of the event routing strategy. Receivers use Triggers to -request delivery of events from a Broker’s pool to a specific URL or -Addressable endpoint.

      +

      InMemoryChannel is a resource representing an in memory channel

      @@ -7297,7 +7294,7 @@ Addressable endpoint.

      string @@ -7306,7 +7303,7 @@ eventing.knative.dev/v1beta1 kind
      string - +
      -eventing.knative.dev/v1beta1 +messaging.knative.dev/v1alpha1
      BrokerInMemoryChannel
      @@ -7327,28 +7324,27 @@ Refer to the Kubernetes API documentation for the fields of the spec
      - -BrokerSpec + +InMemoryChannelSpec       		-

      Spec defines the desired state of the Broker.

      +

      Spec defines the desired state of the Channel.



      @@ -7361,9 +7357,7 @@ DeliverySpec
      -config
      +subscribable
      -knative.dev/pkg/apis/duck/v1.KReference + +Subscribable +       		-(Optional) -

      Config is a KReference to the configuration that specifies -configuration options for this Broker. For example, this could be -a pointer to a ConfigMap.

      +

      Channel conforms to Duck type Subscribable.
      -(Optional) -

      Delivery is the delivery specification for Events within the Broker mesh. -This includes things like retries, DLQ, etc.

      +

      For round tripping (v1beta1 <-> v1alpha1>
      @@ -7373,22 +7367,24 @@ This includes things like retries, DLQ, etc.

      		 status
      - -BrokerStatus + +InMemoryChannelStatus       		(Optional) -

      Status represents the current state of the Broker. This data may be out of +

      Status represents the current state of the Channel. This data may be out of date.
      -

      EventType +

      Subscription

      +

      Subscription routes events received on a Channel to a DNS name and +corresponds to the subscriptions.channels.knative.dev CRD.

      @@ -7404,7 +7400,7 @@ date.

      string @@ -7413,7 +7409,7 @@ eventing.knative.dev/v1beta1 kind
      string - + @@ -7434,72 +7429,88 @@ Refer to the Kubernetes API documentation for the fields of the
      -eventing.knative.dev/v1beta1 +messaging.knative.dev/v1alpha1
      EventTypeSubscription
      @@ -7425,7 +7421,6 @@ Kubernetes meta/v1.ObjectMeta -(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
      - -EventTypeSpec + +SubscriptionSpec       		-

      Spec defines the desired state of the EventType.



      -type
      +generation
      -string +int64       		-

      Type represents the CloudEvents type. It is authoritative.

      +(Optional) +

      TODO By enabling the status subresource metadata.generation should increment +thus making this property obsolete.

      +

      We should be able to drop this property with a CRD conversion webhook +in the future
      -source
      +channel
      -knative.dev/pkg/apis.URL + +Kubernetes core/v1.ObjectReference +       		-

      Source is a URI, it represents the CloudEvents source.

      +

      This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)
      -schema
      +subscriber
      -knative.dev/pkg/apis.URL +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. -It may be a JSON schema, a protobuf schema, etc. It is optional.

      +

      Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.
      -broker
      +reply
      -string +knative.dev/pkg/apis/duck/v1.Destination       		-

      Broker refers to the Broker that can provide the EventType.

      +(Optional) +

      Reply specifies (optionally) how to handle events returned from +the Subscriber target.
      -description
      +delivery
      -string + +DeliverySpec +       		(Optional) -

      Description is an optional field used to describe the EventType, in any meaningful way.

      +

      Delivery configuration
      @@ -7509,24 +7520,25 @@ string       		status
      - -EventTypeStatus + +SubscriptionStatus       		-(Optional) -

      Status represents the current state of the EventType. -This data may be out of date.
      -

      Trigger +

      ChannelSpec

      -

      Trigger represents a request to have events delivered to a consumer from a -Broker’s event pool.

      +(Appears on: +Channel) +

      +

      +

      ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. +It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.

      @@ -7538,116 +7550,137 @@ Broker’s event pool.

      - - - - + + +
      -apiVersion
      -string      		 - -eventing.knative.dev/v1beta1 - +channelTemplate
      + + +ChannelTemplateSpec + +
      -kind
      -string +

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.

      		Trigger
      -metadata
      +subscribable
      - -Kubernetes meta/v1.ObjectMeta + +Subscribable       		-(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

      Channel conforms to Duck type Subscribable.
      -spec
      +delivery
      - -TriggerSpec + +DeliverySpec       		-

      Spec defines the desired state of the Trigger.

      -
      -
      +

      Delivery options.

      +
      +

      ChannelStatus +

      +

      +(Appears on: +Channel) +

      +

      +

      ChannelStatus represents the current state of a Channel.

      +

      + + + + + + + - -
      FieldDescription
      -broker
      +Status
      -string +knative.dev/pkg/apis/duck/v1.Status       		-

      Broker is the broker that this trigger receives events from. If not specified, will default -to ‘default’.

      +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -filter
      +AddressStatus
      - -TriggerFilter - +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus       		-(Optional) -

      Filter is the filter to apply against all events from the Broker. Only events that pass this -filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      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}
      -subscriber
      +SubscribableTypeStatus
      -knative.dev/pkg/apis/duck/v1.Destination + +SubscribableTypeStatus +       		-

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It -is required.

      -
      +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.

      -status
      +channel
      - -TriggerStatus + +Kubernetes core/v1.ObjectReference -(Optional) -

      Status represents the current state of the Trigger. This data may be out of -date.

      +

      Channel is an ObjectReference to the Channel CRD backing this Channel.

      -

      BrokerSpec +

      InMemoryChannelSpec

      (Appears on: -Broker) +InMemoryChannel)

      +

      InMemoryChannelSpec defines which subscribers have expressed interest in +receiving events from this InMemoryChannel. +arguments for a Channel.

      @@ -7659,16 +7692,15 @@ date.

      @@ -7681,21 +7713,19 @@ DeliverySpec
      -config
      +subscribable
      -knative.dev/pkg/apis/duck/v1.KReference + +Subscribable +       		-(Optional) -

      Config is a KReference to the configuration that specifies -configuration options for this Broker. For example, this could be -a pointer to a ConfigMap.

      +

      Channel conforms to Duck type Subscribable.
      -(Optional) -

      Delivery is the delivery specification for Events within the Broker mesh. -This includes things like retries, DLQ, etc.

      +

      For round tripping (v1beta1 <-> v1alpha1>
      -

      BrokerStatus +

      InMemoryChannelStatus

      (Appears on: -Broker) +InMemoryChannel)

      -

      BrokerStatus represents the current state of a Broker.

      +

      ChannelStatus represents the current state of a Channel.

      @@ -7723,25 +7753,58 @@ knative.dev/pkg/apis/duck/v1.Status + + + +
      -address
      +AddressStatus
      -knative.dev/pkg/apis/duck/v1.Addressable +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus       		-

      Broker is Addressable. It exposes the endpoint as an URI to get events -delivered into the Broker mesh.

      +

      +(Members of AddressStatus are embedded into this type.) +

      +

      InMemoryChannel 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}

      +
      +SubscribableTypeStatus
      + + +SubscribableTypeStatus + + +      		 +

      +(Members of SubscribableTypeStatus are embedded into this type.) +

      +

      Subscribers is populated with the statuses of each of the Channelable’s subscribers.
      -

      EventTypeSpec +

      SubscriptionSpec

      (Appears on: -EventType) +Subscription)

      +

      SubscriptionSpec specifies the Channel for incoming events, a Subscriber target +for processing those events and where to put the result of the processing. Only +From (where the events are coming from) is always required. You can optionally +only Process the events (results in no output events) by leaving out the Result. +You can also perform an identity transformation on the incoming events by leaving +out the Subscriber and only specifying Result.

      +

      The following are all valid specifications: +channel –[subscriber]–> reply +Sink, no outgoing events: +channel – subscriber +no-op function (identity transformation): +channel –> reply

      @@ -7753,153 +7816,89 @@ delivered into the Broker mesh.

      - - - - - - - - - -
      -type
      - -string - -      		 -

      Type represents the CloudEvents type. It is authoritative.

      -
      -source
      - -knative.dev/pkg/apis.URL - -      		 -

      Source is a URI, it represents the CloudEvents source.

      -
      -schema
      +generation
      -knative.dev/pkg/apis.URL +int64       		(Optional) -

      Schema is a URI, it represents the CloudEvents schemaurl extension attribute. -It may be a JSON schema, a protobuf schema, etc. It is optional.

      +

      TODO By enabling the status subresource metadata.generation should increment +thus making this property obsolete.

      +

      We should be able to drop this property with a CRD conversion webhook +in the future
      -broker
      +channel
      -string + +Kubernetes core/v1.ObjectReference +       		-

      Broker refers to the Broker that can provide the EventType.

      +

      This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)
      -description
      +subscriber
      -string +knative.dev/pkg/apis/duck/v1.Destination       		(Optional) -

      Description is an optional field used to describe the EventType, in any meaningful way.

      +

      Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.
      -

      EventTypeStatus -

      -

      -(Appears on: -EventType) -

      -

      -

      EventTypeStatus represents the current state of a EventType.

      -

      - - - - - - - - - -
      FieldDescription
      -Status
      +reply
      -knative.dev/pkg/apis/duck/v1.Status +knative.dev/pkg/apis/duck/v1.Destination       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +(Optional) +

      Reply specifies (optionally) how to handle events returned from +the Subscriber target.
      -

      TriggerFilter -

      -

      -(Appears on: -TriggerSpec) -

      -

      -

      - - - - - - - -
      FieldDescription
      -attributes
      +delivery
      - -TriggerFilterAttributes + +DeliverySpec       		(Optional) -

      Attributes filters events by exact match on event context attributes. -Each key in the map is compared with the equivalent key in the event -context. An event passes the filter if all values are equal to the -specified values.

      -

      Nested context attributes are not supported as keys. Only string values are supported.

      +

      Delivery configuration
      -

      TriggerFilterAttributes -(map[string]string alias)

      -

      -(Appears on: -TriggerFilter) -

      -

      -

      TriggerFilterAttributes is a map of context attribute names to values for -filtering by equality. Only exact matches will pass the filter. You can use the value “ -to indicate all strings match.

      -

      -

      TriggerSpec +

      SubscriptionStatus

      (Appears on: -Trigger) +Subscription)

      +

      SubscriptionStatus (computed) for a subscription

      @@ -7911,53 +7910,44 @@ to indicate all strings match.

      - - - - -
      -broker
      - -string - -      		 -

      Broker is the broker that this trigger receives events from. If not specified, will default -to ‘default’.

      -
      -filter
      +Status
      - -TriggerFilter - +knative.dev/pkg/apis/duck/v1.Status       		-(Optional) -

      Filter is the filter to apply against all events from the Broker. Only events that pass this -filter will be sent to the Subscriber. If not specified, will default to allowing all events.

      +      		 +

      +(Members of Status are embedded into this type.) +

      +

      inherits duck/v1 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.
      -subscriber
      +physicalSubscription
      -knative.dev/pkg/apis/duck/v1.Destination + +SubscriptionStatusPhysicalSubscription +       		-

      Subscriber is the addressable that receives events from the Broker that pass the Filter. It -is required.

      +

      PhysicalSubscription is the fully resolved values that this Subscription represents.
      -

      TriggerStatus +

      SubscriptionStatusPhysicalSubscription

      (Appears on: -Trigger) +SubscriptionStatus)

      -

      TriggerStatus represents the current state of a Trigger.

      +

      SubscriptionStatusPhysicalSubscription represents the fully resolved values for this +Subscription.

      @@ -7969,45 +7959,56 @@ is required.

      + + + +
      -Status
      +subscriberURI
      -knative.dev/pkg/apis/duck/v1.Status +knative.dev/pkg/apis.URL       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      SubscriberURI is the fully resolved URI for spec.subscriber.
      -subscriberUri
      +replyURI
      knative.dev/pkg/apis.URL       		-

      SubscriberURI is the resolved URI of the receiver for this Trigger.

      +

      ReplyURI is the fully resolved URI for the spec.reply.

      +
      +deadLetterSinkURI
      + +knative.dev/pkg/apis.URL + +      		 +

      ReplyURI is the fully resolved URI for the spec.delivery.deadLetterSink.
      -

      flows.knative.dev/v1alpha1

      +

      messaging.knative.dev/v1beta1

      -

      Package v1alpha1 is the v1alpha1 version of the API.

      +

      Package v1beta1 is the v1beta1 version of the API.

      Resource Types: - -

      Parallel + +

      Channel

      -

      Parallel defines conditional branches that will be wired in -series through Channels and Subscriptions.

      +

      Channel represents a generic Channel. It is normally used when we want a Channel, but don’t need a specific Channel implementation.

      @@ -8019,6 +8020,23 @@ series through Channels and Subscriptions.

      + + + + + + + +
      +apiVersion
      +string      		 + +messaging.knative.dev/v1beta1 + +
      +kind
      +string +      		Channel
      metadata
      @@ -8036,31 +8054,18 @@ Refer to the Kubernetes API documentation for the fields of the       		spec
      - -ParallelSpec + +ChannelSpec       		-

      Spec defines the desired state of the Parallel.

      +

      Spec defines the desired state of the Channel.



      - - - -
      -branches
      - - -[]ParallelBranch - - -      		 -

      Branches is the list of Filter/Subscribers pairs.

      -
      channelTemplate
      @@ -8069,22 +8074,24 @@ ChannelTemplateSpec       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.
      -reply
      +ChannelableSpec
      -knative.dev/pkg/apis/duck/v1.Destination + +ChannelableSpec +       		-(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      +

      +(Members of ChannelableSpec are embedded into this type.) +

      +

      Channel conforms to ChannelableSpec
      @@ -8094,26 +8101,23 @@ when the case does not have a Reply

      		 status
      - -ParallelStatus + +ChannelStatus       		(Optional) -

      Status represents the current state of the Parallel. This data may be out of +

      Status represents the current state of the Channel. This data may be out of date.
      -

      ParallelBranch +

      InMemoryChannel

      -(Appears on: -ParallelSpec) -

      -

      +

      InMemoryChannel is a resource representing an in memory channel

      @@ -8125,149 +8129,91 @@ date.

      - - - - +apiVersion
      +string - + - -
      -filter
      - -knative.dev/pkg/apis/duck/v1.Destination - -      		 -

      Filter is the expression guarding the branch

      -
      -subscriber
      - -knative.dev/pkg/apis/duck/v1.Destination - -      		 -

      Subscriber receiving the event when the filter passes

      + +messaging.knative.dev/v1beta1 +
      -reply
      - -knative.dev/pkg/apis/duck/v1.Destination - -      		 -(Optional) -

      Reply is a Reference to where the result of Subscriber of this case gets sent to. -If not specified, sent the result to the Parallel Reply

      +kind
      +string       		InMemoryChannel
      -

      ParallelBranchStatus -

      -

      -(Appears on: -ParallelStatus) -

      -

      -

      ParallelBranchStatus represents the current state of a Parallel branch

      -

      - - - - - - - - - +

      Spec defines the desired state of the Channel.

      +
      +
      +
      FieldDescription
      -filterSubscriptionStatus
      +metadata
      - -ParallelSubscriptionStatus + +Kubernetes meta/v1.ObjectMeta       		-

      FilterSubscriptionStatus corresponds to the filter subscription status.

      +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -filterChannelStatus
      +spec
      - -ParallelChannelStatus + +InMemoryChannelSpec       		-

      FilterChannelStatus corresponds to the filter channel status.

      -
      - - -
      -subscriberSubscriptionStatus
      +ChannelableSpec
      - -ParallelSubscriptionStatus + +ChannelableSpec       		-

      SubscriptionStatus corresponds to the subscriber subscription status.

      -
      -

      ParallelChannelStatus -

      -

      -(Appears on: -ParallelBranchStatus, -ParallelStatus) -

      +(Members of ChannelableSpec are embedded into this type.)

      - - - - - - - - - - - +
      FieldDescription
      -channel
      - - -Kubernetes core/v1.ObjectReference - - +

      Channel conforms to Duck type Channelable.

      		 -

      Channel is the reference to the underlying channel.

      +
      -ready
      +status
      -knative.dev/pkg/apis.Condition + +InMemoryChannelStatus + -

      ReadyCondition indicates whether the Channel is ready or not.

      +(Optional) +

      Status represents the current state of the Channel. This data may be out of +date.

      -

      ParallelSpec +

      Subscription

      -(Appears on: -Parallel) -

      -

      +

      Subscription routes events received on a Channel to a DNS name and +corresponds to the subscriptions.channels.knative.dev CRD.

      @@ -8279,132 +8225,148 @@ knative.dev/pkg/apis.Condition + + + + - - -
      -branches
      - - -[]ParallelBranch - - +apiVersion
      +string      		 + +messaging.knative.dev/v1beta1 +
      -

      Branches is the list of Filter/Subscribers pairs.

      +kind
      +string       		Subscription
      -channelTemplate
      +metadata
      - -ChannelTemplateSpec + +Kubernetes meta/v1.ObjectMeta       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -reply
      +spec
      -knative.dev/pkg/apis/duck/v1.Destination + +SubscriptionSpec +       		-(Optional) -

      Reply is a Reference to where the result of a case Subscriber gets sent to -when the case does not have a Reply

      -
      -

      ParallelStatus -

      -

      -(Appears on: -Parallel) -

      -

      -

      ParallelStatus represents the current state of a Parallel.

      -

      +
      +
      - - - + + - - + +
      FieldDescription +channel
      + + +Kubernetes core/v1.ObjectReference + + +      		 +

      Reference to a channel that will be used to create the subscription +You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name +The resource pointed by this ObjectReference must meet the +contract to the ChannelableSpec duck type. If the resource does not +meet this contract it will be reflected in the Subscription’s status.

      +

      This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)

      +
      -Status
      +subscriber
      -knative.dev/pkg/apis/duck/v1.Status +knative.dev/pkg/apis/duck/v1.Destination       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +(Optional) +

      Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.
      -ingressChannelStatus
      +reply
      - -ParallelChannelStatus - +knative.dev/pkg/apis/duck/v1.Destination       		-

      IngressChannelStatus corresponds to the ingress channel status.

      +(Optional) +

      Reply specifies (optionally) how to handle events returned from +the Subscriber target.
      -branchStatuses
      +delivery
      - -[]ParallelBranchStatus + +DeliverySpec       		-

      BranchStatuses is an array of corresponding to branch statuses. -Matches the Spec.Branches array in the order.

      +(Optional) +

      Delivery configuration

      +
      -AddressStatus
      +status
      -knative.dev/pkg/apis/duck/v1.AddressStatus + +SubscriptionStatus + -

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Parallel. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      -

      ParallelSubscriptionStatus +

      ChannelDefaulter +

      +

      +

      ChannelDefaulter sets the default Channel CRD and Arguments on Channels that do not +specify any implementation.

      +

      +

      ChannelSpec

      (Appears on: -ParallelBranchStatus) +Channel)

      +

      ChannelSpec defines which subscribers have expressed interest in receiving events from this Channel. +It also defines the ChannelTemplate to use in order to create the CRD Channel backing this Channel.

      @@ -8416,35 +8378,44 @@ It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      -subscription
      +channelTemplate
      - -Kubernetes core/v1.ObjectReference + +ChannelTemplateSpec       		-

      Subscription is the reference to the underlying Subscription.

      +

      ChannelTemplate specifies which Channel CRD to use to create the CRD Channel backing this Channel. +This is immutable after creation. Normally this is set by the Channel defaulter, not directly by the user.
      -ready
      +ChannelableSpec
      -knative.dev/pkg/apis.Condition + +ChannelableSpec +       		-

      ReadyCondition indicates whether the Subscription is ready or not.

      +

      +(Members of ChannelableSpec are embedded into this type.) +

      +

      Channel conforms to ChannelableSpec
      -

      Sequence +

      ChannelStatus

      -

      Sequence defines a sequence of Subscribers that will be wired in -series through Channels and Subscriptions.

      +(Appears on: +Channel) +

      +

      +

      ChannelStatus represents the current state of a Channel.

      @@ -8456,101 +8427,79 @@ series through Channels and Subscriptions.

      - - - - - +

      ChannelTemplateSpec +

      +

      +(Appears on: +BrokerSpec, +ChannelSpec, +ChannelSpec, +ParallelSpec, +ParallelSpec, +SequenceSpec, +SequenceSpec) +

      +

      +

      +
      -metadata
      - - -Kubernetes meta/v1.ObjectMeta - - -      		 -(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
      -spec
      - - -SequenceSpec - - -      		 -

      Spec defines the desired state of the Sequence.

      -
      -
      - - - - - - - +
      -steps
      - - -[]SequenceStep - - -      		 -

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided.

      -
      -channelTemplate
      +ChannelableStatus
      - -ChannelTemplateSpec + +ChannelableStatus       		-(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      +

      +(Members of ChannelableStatus are embedded into this type.) +

      +

      Channel conforms to ChannelableStatus
      -reply
      +channel
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1.KReference       		-(Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +

      Channel is an KReference to the Channel CRD backing this Channel.
      -
      + + + + + +
      FieldDescription
      -status
      +spec
      - -SequenceStatus - +k8s.io/apimachinery/pkg/runtime.RawExtension       		(Optional) -

      Status represents the current state of the Sequence. This data may be out of -date.

      +

      Spec defines the Spec to use for each channel created. Passed +in verbatim to the Channel CRD as Spec section.

      +
      +
      + +
      -

      SequenceChannelStatus +

      ChannelTemplateSpecInternal

      -(Appears on: -SequenceStatus) -

      -

      +

      ChannelTemplateSpecInternal is an internal only version that includes ObjectMeta so that +we can easily create new Channels off of it.

      @@ -8562,37 +8511,48 @@ date.

      -channel
      +metadata
      - -Kubernetes core/v1.ObjectReference + +Kubernetes meta/v1.ObjectMeta       		-

      Channel is the reference to the underlying channel.

      +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field.
      -ready
      +spec
      -knative.dev/pkg/apis.Condition +k8s.io/apimachinery/pkg/runtime.RawExtension       		-

      ReadyCondition indicates whether the Channel is ready or not.

      +(Optional) +

      Spec defines the Spec to use for each channel created. Passed +in verbatim to the Channel CRD as Spec section.

      +
      +
      + +
      -

      SequenceSpec +

      InMemoryChannelSpec

      (Appears on: -Sequence) +InMemoryChannel)

      +

      InMemoryChannelSpec defines which subscribers have expressed interest in +receiving events from this InMemoryChannel. +arguments for a Channel.

      @@ -8604,55 +8564,76 @@ knative.dev/pkg/apis.Condition + +
      -steps
      +ChannelableSpec
      - -[]SequenceStep + +ChannelableSpec       		-

      Steps is the list of Destinations (processors / functions) that will be called in the order -provided.

      +

      +(Members of ChannelableSpec are embedded into this type.) +

      +

      Channel conforms to Duck type Channelable.
      +

      InMemoryChannelStatus +

      +

      +(Appears on: +InMemoryChannel) +

      +

      +

      ChannelStatus represents the current state of a Channel.

      +

      + + - - + + + +
      -channelTemplate
      - - -ChannelTemplateSpec - - -      		 -(Optional) -

      ChannelTemplate specifies which Channel CRD to use. If left unspecified, it is set to the default Channel CRD -for the namespace (or cluster, in case there are no defaults for the namespace).

      -      		FieldDescription
      -reply
      +ChannelableStatus
      -knative.dev/pkg/apis/duck/v1.Destination + +ChannelableStatus +       		-(Optional) -

      Reply is a Reference to where the result of the last Subscriber gets sent to.

      +

      +(Members of ChannelableStatus are embedded into this type.) +

      +

      Channel conforms to Duck type Channelable.
      -

      SequenceStatus +

      SubscriptionSpec

      (Appears on: -Sequence) +Subscription)

      -

      SequenceStatus represents the current state of a Sequence.

      +

      SubscriptionSpec specifies the Channel for incoming events, a Subscriber target +for processing those events and where to put the result of the processing. Only +From (where the events are coming from) is always required. You can optionally +only Process the events (results in no output events) by leaving out the Result. +You can also perform an identity transformation on the incoming events by leaving +out the Subscriber and only specifying Result.

      +

      The following are all valid specifications: +channel –[subscriber]–> reply +Sink, no outgoing events: +channel – subscriber +no-op function (identity transformation): +channel –> reply

      @@ -8664,73 +8645,82 @@ knative.dev/pkg/apis/duck/v1.Destination
      -Status
      +channel
      -knative.dev/pkg/apis/duck/v1.Status + +Kubernetes core/v1.ObjectReference +       		-

      -(Members of Status are embedded into this type.) -

      -

      inherits duck/v1 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.

      +

      Reference to a channel that will be used to create the subscription +You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name +The resource pointed by this ObjectReference must meet the +contract to the ChannelableSpec duck type. If the resource does not +meet this contract it will be reflected in the Subscription’s status.

      +

      This field is immutable. We have no good answer on what happens to +the events that are currently in the channel being consumed from +and what the semantics there should be. For now, you can always +delete the Subscription and recreate it to point to a different +channel, giving the user more control over what semantics should +be used (drain the channel first, possibly have events dropped, +etc.)
      -subscriptionStatuses
      +subscriber
      - -[]SequenceSubscriptionStatus - +knative.dev/pkg/apis/duck/v1.Destination       		-

      SubscriptionStatuses is an array of corresponding Subscription statuses. -Matches the Spec.Steps array in the order.

      +(Optional) +

      Subscriber is reference to (optional) function for processing events. +Events from the Channel will be delivered here and replies are +sent to a Destination as specified by the Reply.
      -channelStatuses
      +reply
      - -[]SequenceChannelStatus - +knative.dev/pkg/apis/duck/v1.Destination       		-

      ChannelStatuses is an array of corresponding Channel statuses. -Matches the Spec.Steps array in the order.

      +(Optional) +

      Reply specifies (optionally) how to handle events returned from +the Subscriber target.
      -AddressStatus
      +delivery
      -knative.dev/pkg/apis/duck/v1.AddressStatus + +DeliverySpec +       		-

      -(Members of AddressStatus are embedded into this type.) -

      -

      AddressStatus is the starting point to this Sequence. Sending to this -will target the first subscriber. -It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      +(Optional) +

      Delivery configuration
      -

      SequenceStep +

      SubscriptionStatus

      (Appears on: -SequenceSpec) +Subscription)

      +

      SubscriptionStatus (computed) for a subscription

      @@ -8742,43 +8732,44 @@ It generally has the form {channel}.{namespace}.svc.{cluster domain name}

      -Destination
      +Status
      -knative.dev/pkg/apis/duck/v1.Destination +knative.dev/pkg/apis/duck/v1.Status

      -(Members of Destination are embedded into this type.) +(Members of Status are embedded into this type.)

      -

      Subscriber receiving the step event

      +

      inherits duck/v1 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.
      -delivery
      +physicalSubscription
      - -DeliverySpec + +SubscriptionStatusPhysicalSubscription       		-(Optional) -

      Delivery is the delivery specification for events to the subscriber -This includes things like retries, DLQ, etc. -Needed for Roundtripping v1alpha1 <-> v1beta1.

      +

      PhysicalSubscription is the fully resolved values that this Subscription represents.
      -

      SequenceSubscriptionStatus +

      SubscriptionStatusPhysicalSubscription

      (Appears on: -SequenceStatus) +SubscriptionStatus)

      +

      SubscriptionStatusPhysicalSubscription represents the fully resolved values for this +Subscription.

      @@ -8790,26 +8781,35 @@ Needed for Roundtripping v1alpha1 <-> v1beta1.

      + + + + From f55cb4b798776eadbbe05ec246728ae5525726c6 Mon Sep 17 00:00:00 2001 From: ellenevans <35748459+ellenevans@users.noreply.github.com> Date: Tue, 3 Mar 2020 16:07:59 -0800 Subject: [PATCH 3/3] Update docs/reference/eventing/eventing-contrib.md Co-Authored-By: Matt Moore --- docs/reference/eventing/eventing-contrib.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/eventing/eventing-contrib.md b/docs/reference/eventing/eventing-contrib.md index a112a8e3b51..1e82faf9ac4 100644 --- a/docs/reference/eventing/eventing-contrib.md +++ b/docs/reference/eventing/eventing-contrib.md @@ -2095,7 +2095,7 @@ for the PrometheusSource.

      (Appears on: -KafkaSourceSASLSpec, +KafkaSourceSASLSpec, KafkaSourceTLSSpec)

      -subscription
      +subscriberUri
      - -Kubernetes core/v1.ObjectReference - +knative.dev/pkg/apis.URL       		-

      Subscription is the reference to the underlying Subscription.

      +

      SubscriberURI is the fully resolved URI for spec.subscriber.
      -ready
      +replyUri
      -knative.dev/pkg/apis.Condition +knative.dev/pkg/apis.URL       		-

      ReadyCondition indicates whether the Subscription is ready or not.

      +

      ReplyURI is the fully resolved URI for the spec.reply.

      +
      +deadLetterSinkUri
      + +knative.dev/pkg/apis.URL + +      		 +

      ReplyURI is the fully resolved URI for the spec.delivery.deadLetterSink.