diff --git a/blog/articles/event-drive-app-knative-eventing-kogito.md b/blog/articles/event-drive-app-knative-eventing-kogito.md index 5354c7883d2..5b38480574f 100644 --- a/blog/articles/event-drive-app-knative-eventing-kogito.md +++ b/blog/articles/event-drive-app-knative-eventing-kogito.md @@ -28,7 +28,7 @@ As part of the Serverless Workflow implementation, Kogito offers a Kubernetes Op To demonstrate how the Kogito workflow implementation works on Knative's event-driven architecture, we will use the [patient onboarding example](https://github.com/kiegroup/kogito-examples/tree/master/serverless-workflow-functions-events-quarkus). In this example, we simulate a workflow used in hospitals to onboard new patients and assign them to the correct doctor. -The following image taken from the [specification examples page](https://github.com/serverlessworkflow/specification/blob/master/examples/examples.md#New-Patient-Onboarding) illustrates this workflow: +The following image taken from the [specification examples page](https://github.com/serverlessworkflow/specification/tree/main/examples#New-Patient-Onboarding) illustrates this workflow: ![Patient onboarding workflow representation](/blog/articles/images/kogito-example-patientonboarding.png) *Patient Onboarding workflow representation* diff --git a/docs/eventing/event-registry.md b/docs/eventing/event-registry.md index 73fd25d81bf..38b7dd2c1a7 100644 --- a/docs/eventing/event-registry.md +++ b/docs/eventing/event-registry.md @@ -62,7 +62,7 @@ kubectl get eventtype dev.knative.source.github.push-34cnb -o yaml Omitting irrelevant fields: ```yaml -apiVersion: eventing.knative.dev/v1 +apiVersion: eventing.knative.dev/v1beta1 kind: EventType metadata: name: dev.knative.source.github.push-34cnb diff --git a/docs/eventing/samples/kafka/README.md b/docs/eventing/samples/kafka/README.md index a1038c0de48..b56c8ba2162 100644 --- a/docs/eventing/samples/kafka/README.md +++ b/docs/eventing/samples/kafka/README.md @@ -36,7 +36,7 @@ is to install it by using [Strimzi](https://strimzi.io). ``` 1. Describe the size of your Apache Kafka installation in `kafka.yaml`, like: ```yaml - apiVersion: kafka.strimzi.io/v1beta1 + apiVersion: kafka.strimzi.io/v1beta2 kind: Kafka metadata: name: my-cluster diff --git a/docs/eventing/samples/kafka/channel/README.md b/docs/eventing/samples/kafka/channel/README.md index bd0bbdf243e..f245739df90 100644 --- a/docs/eventing/samples/kafka/channel/README.md +++ b/docs/eventing/samples/kafka/channel/README.md @@ -96,6 +96,8 @@ with `knative-messaging-kafka`. This indicates it is an Apache Kafka channel from Knative. It contains the name of the namespace, `default` in this example, followed by the actual name of the channel. +**NOTE:** The topic of a Kafka channel is an implementation detail and records from it should not be consumed from different applications. + ## Configuring the Knative broker for Apache Kafka channels To setup a broker that will use the new default Kafka channels, you must create @@ -127,6 +129,8 @@ knative-messaging-kafka.default.default-kn2-trigger ... ``` +**NOTE:** The topic of a Kafka channel is an implementation detail and records from it should not be consumed from different applications. + ## Creating a service and trigger to use the Apache Kafka broker To use the Apache Kafka based broker, let's take a look at a simple demo. Use diff --git a/docs/eventing/samples/kafka/kafka.yaml b/docs/eventing/samples/kafka/kafka.yaml index 9188d7609af..c98cca5b14e 100644 --- a/docs/eventing/samples/kafka/kafka.yaml +++ b/docs/eventing/samples/kafka/kafka.yaml @@ -1,4 +1,4 @@ -apiVersion: kafka.strimzi.io/v1beta1 +apiVersion: kafka.strimzi.io/v1beta2 kind: Kafka metadata: name: my-cluster diff --git a/docs/eventing/sources/kafka-source/README.md b/docs/eventing/sources/kafka-source/README.md index 6fcbe7d6fb4..c05eda7082c 100644 --- a/docs/eventing/sources/kafka-source/README.md +++ b/docs/eventing/sources/kafka-source/README.md @@ -31,7 +31,7 @@ The `KafkaSource` reads all the messages, from all partitions, and sends those m - Replicas ```yaml - apiVersion: kafka.strimzi.io/v1beta1 + apiVersion: kafka.strimzi.io/v1beta2 kind: KafkaTopic metadata: name: knative-demo-topic diff --git a/docs/eventing/sources/kafka-source/kafka-topic.yaml b/docs/eventing/sources/kafka-source/kafka-topic.yaml index b7826a6ab3c..f09e63359b2 100644 --- a/docs/eventing/sources/kafka-source/kafka-topic.yaml +++ b/docs/eventing/sources/kafka-source/kafka-topic.yaml @@ -12,7 +12,7 @@ # See the License for the specific language governing permissions and # limitations under the License. -apiVersion: kafka.strimzi.io/v1beta1 +apiVersion: kafka.strimzi.io/v1beta2 kind: KafkaTopic metadata: name: knative-demo-topic diff --git a/docs/getting-started/contributing/contributing.md b/docs/getting-started/contributing/contributing.md index 59ec83cf711..12606474af8 100644 --- a/docs/getting-started/contributing/contributing.md +++ b/docs/getting-started/contributing/contributing.md @@ -44,7 +44,8 @@ Once you have installed Material for MkDocs and all of the extensions, head over --8<-- "docs/snippets/links/main-docs-branch-link.md" and clone the repo. -In your terminal, find your way over to the location of the cloned repo. Once you are in the main folder (.../docs) and run: +In your terminal, find your way over to the location of the cloned repo. Once you are in the main folder and run: + === "Local Preview" ``` diff --git a/docs/reference/api/eventing/eventing.md b/docs/reference/api/eventing/eventing.md index 9257224f022..1b94c6c62f7 100644 --- a/docs/reference/api/eventing/eventing.md +++ b/docs/reference/api/eventing/eventing.md @@ -16,44 +16,29 @@ flows.knative.dev/v1
  • -flows.knative.dev/v1beta1 -
  • -
  • messaging.knative.dev/v1
  • -messaging.knative.dev/v1beta1 -
  • -
  • sources.knative.dev/v1
  • -sources.knative.dev/v1alpha1 -
  • -
  • -sources.knative.dev/v1alpha2 -
  • -
  • -sources.knative.dev/v1beta1 -
  • -
  • sources.knative.dev/v1beta2
  • duck.knative.dev/v1

    -

    +

    Package v1 is the v1 version of the API.

    -

    +
    Resource Types:

    BackoffPolicyType -(string alias)

    +(string alias)

    (Appears on:DeliverySpec)

    -

    +

    BackoffPolicyType is the type for backoff policies

    -

    +
    @@ -71,11 +56,11 @@ 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.

    -

    +
    @@ -165,9 +150,9 @@ ChannelableStatus

    (Appears on:Channelable, ChannelSpec, InMemoryChannelSpec)

    -

    +

    ChannelableSpec contains Spec of the Channelable object

    -

    +
    @@ -214,9 +199,9 @@ global delivery spec.

    (Appears on:Channelable, ChannelStatus, InMemoryChannelStatus)

    -

    +

    ChannelableStatus contains the Status of a Channelable object.

    -

    +
    @@ -256,6 +241,7 @@ knative.dev/pkg/apis/duck/v1.AddressStatus

    (Members of AddressStatus are embedded into this type.)

    +(Optional)

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

    @@ -295,12 +281,12 @@ Failed messages are delivered here.

    DeliverySpec

    -(Appears on:ChannelableSpec, SubscriberSpec, BrokerSpec, TriggerSpec, TriggerSpec, ParallelBranch, SequenceStep, SubscriptionSpec) +(Appears on:ChannelableSpec, SubscriberSpec, BrokerSpec, TriggerSpec, ParallelBranch, SequenceStep, SubscriptionSpec)

    -

    +

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

    -

    +
    @@ -372,9 +358,9 @@ For exponential policy, backoff delay is backoffDelay*2^.

    DeliveryStatus

    -

    +

    DeliveryStatus contains the Status of an object supporting delivery options.

    -

    +
    @@ -402,11 +388,11 @@ 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.

    -

    +
    @@ -481,9 +467,9 @@ configured as to be compatible with Subscribable contract.

    (Appears on:ChannelableSpec, Subscribable)

    -

    +

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

    -

    +
    @@ -512,10 +498,10 @@ configured as to be compatible with Subscribable contract.

    (Appears on:ChannelableStatus, Subscribable)

    -

    +

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

    -

    +
    @@ -544,10 +530,10 @@ section of the resource.

    (Appears on:SubscribableSpec)

    -

    +

    SubscriberSpec defines a single subscriber to a Subscribable.

    At least one of SubscriberURI and ReplyURI must be present

    -

    +
    @@ -629,9 +615,9 @@ DeliverySpec

    (Appears on:SubscribableStatus)

    -

    +

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

    -

    +
    @@ -693,19 +679,19 @@ string

    duck.knative.dev/v1beta1

    -

    +

    Package v1beta1 is the v1beta1 version of the API.

    -

    +
    Resource Types:

    BackoffPolicyType -(string alias)

    +(string alias)

    (Appears on:DeliverySpec)

    -

    +

    BackoffPolicyType is the type for backoff policies

    -

    +
    @@ -723,11 +709,11 @@ 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.

    -

    +
    @@ -813,11 +799,11 @@ ChannelableStatus

    ChannelableSpec

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

    -

    +

    ChannelableSpec contains Spec of the Channelable object

    -

    +
    @@ -860,11 +846,11 @@ DeliverySpec

    ChannelableStatus

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

    -

    +

    ChannelableStatus contains the Status of a Channelable object.

    -

    +
    @@ -943,12 +929,12 @@ Failed messages are delivered here.

    DeliverySpec

    -(Appears on:ChannelableSpec, SubscriberSpec, BrokerSpec, ParallelBranch, SequenceStep, SubscriptionSpec) +(Appears on:ChannelableSpec, SubscriberSpec)

    -

    +

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

    -

    +
    @@ -1020,9 +1006,9 @@ For exponential policy, backoff delay is backoffDelay*2^.

    DeliveryStatus

    -

    +

    DeliveryStatus contains the Status of an object supporting delivery options.

    -

    +
    @@ -1050,11 +1036,11 @@ 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.

    -

    +
    @@ -1129,9 +1115,9 @@ configured as to be compatible with Subscribable contract.

    (Appears on:ChannelableSpec, Subscribable)

    -

    +

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

    -

    +
    @@ -1160,10 +1146,10 @@ configured as to be compatible with Subscribable contract.

    (Appears on:ChannelableStatus, Subscribable)

    -

    +

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

    -

    +
    @@ -1192,10 +1178,10 @@ section of the resource.

    (Appears on:SubscribableSpec)

    -

    +

    SubscriberSpec defines a single subscriber to a Subscribable.

    At least one of SubscriberURI and ReplyURI must be present

    -

    +
    @@ -1277,9 +1263,9 @@ DeliverySpec

    (Appears on:SubscribableStatus)

    -

    +

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

    -

    +
    @@ -1341,9 +1327,9 @@ string

    eventing.knative.dev/v1

    -

    +

    Package v1 is the v1 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. Subscribers use Triggers to request delivery of events from a Broker’s pool to a specific URL or Addressable endpoint.

    -

    +
    @@ -1467,10 +1453,10 @@ date.

    Trigger

    -

    +

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

    -

    +
    @@ -1604,8 +1590,8 @@ date.

    (Appears on:Broker)

    -

    -

    +
    +
    @@ -1653,9 +1639,9 @@ global delivery spec.

    (Appears on:Broker)

    -

    +

    BrokerStatus represents the current state of a Broker.

    -

    +
    @@ -1692,6 +1678,7 @@ knative.dev/pkg/apis/duck/v1.Addressable @@ -1703,8 +1690,8 @@ delivered into the Broker mesh.

    (Appears on:TriggerSpec)

    -

    -

    +
    +
    +(Optional)

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

    @@ -1734,22 +1721,22 @@ specified values.

    TriggerFilterAttributes -(map[string]string alias)

    +(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:Trigger)

    -

    -

    +
    +
    @@ -1819,9 +1806,9 @@ DeliverySpec

    (Appears on:Trigger)

    -

    +

    TriggerStatus represents the current state of a Trigger.

    -

    +
    @@ -1866,136 +1853,18 @@ knative.dev/pkg/apis.URL

    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

    -

    +

    EventType represents a type of event that can be consumed from a Broker.

    -

    +
    @@ -2150,12 +2019,13 @@ TODO might be removed
    -

    Trigger +

    EventTypeSpec

    -

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

    +(Appears on:
    EventType)

    +
    +
    @@ -2166,181 +2036,93 @@ Broker’s event pool.

    - - - - - - - - - - -
    -apiVersion
    -string
    - -eventing.knative.dev/v1beta1 - +type
    + +string +
    -kind
    -string +

    Type represents the CloudEvents type. It is authoritative.

    Trigger
    -metadata
    +source
    - -Kubernetes meta/v1.ObjectMeta + +knative.dev/pkg/apis.URL
    (Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. +

    Source is a URI, it represents the CloudEvents source.

    -spec
    +schema
    - -TriggerSpec + +knative.dev/pkg/apis.URL
    -

    Spec defines the desired state of the Trigger.

    -
    -
    - +(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
    +schemaData
    string
    -

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

    +(Optional) +

    SchemaData allows the CloudEvents schema to be stored directly in the +EventType. Content is dependent on the encoding. Optional attribute. +The contents are not validated or manipulated by the system.

    -filter
    +broker
    - -TriggerFilter - +string
    (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.

    +

    TODO remove https://github.com/knative/eventing/issues/2750 +Broker refers to the Broker that can provide the EventType.

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

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

    -
    -delivery
    - - -DeliverySpec - - -
    -(Optional) -

    Delivery contains the delivery spec for this specific trigger.

    -
    -
    -status
    - - -TriggerStatus - - -
    -(Optional) -

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

    -
    -

    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 - +string
    (Optional) -

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

    +

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

    -

    BrokerStatus +

    EventTypeStatus

    -(Appears on:Broker) -

    -

    -

    BrokerStatus represents the current state of a Broker.

    +(Appears on:EventType)

    +
    +

    EventTypeStatus represents the current state of a EventType.

    +
    @@ -2367,29 +2149,21 @@ knative.dev/pkg/apis/duck/v1.Status * Conditions - the latest available observations of a resource’s current state.

    - - - -
    -address
    - - -knative.dev/pkg/apis/duck/v1.Addressable - - -
    -

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

    -
    -

    EventTypeSpec +
    +

    flows.knative.dev/v1

    +
    +

    Package v1 is the v1 version of the API.

    +
    +Resource Types: + +

    Parallel

    -

    -(Appears on:EventType) -

    -

    -

    +
    +

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

    +
    @@ -2400,128 +2174,103 @@ delivered into the Broker mesh.

    - - - - - +

    Spec defines the desired state of the Parallel.

    +
    +
    +
    -type
    - -string - -
    -

    Type represents the CloudEvents type. It is authoritative.

    -
    -source
    +metadata
    - -knative.dev/pkg/apis.URL + +Kubernetes meta/v1.ObjectMeta
    (Optional) -

    Source is a URI, it represents the CloudEvents source.

    +Refer to the Kubernetes API documentation for the fields of the +metadata field.
    -schema
    +spec
    - -knative.dev/pkg/apis.URL + +ParallelSpec
    -(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.

    -
    -
    -schemaData
    +branches
    -string + +[]ParallelBranch +
    -(Optional) -

    SchemaData allows the CloudEvents schema to be stored directly in the -EventType. Content is dependent on the encoding. Optional attribute. -The contents are not validated or manipulated by the system.

    +

    Branches is the list of Filter/Subscribers pairs.

    -broker
    +channelTemplate
    -string + +ChannelTemplateSpec +
    (Optional) -

    TODO remove https://github.com/knative/eventing/issues/2750 -Broker refers to the Broker that can provide the EventType.

    +

    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 -

    -

    -(Appears on:EventType) -

    -

    -

    EventTypeStatus represents the current state of a EventType.

    -

    - - - - - + - -
    FieldDescription
    -Status
    +status
    - -knative.dev/pkg/apis/duck/v1.Status + +ParallelStatus
    -

    -(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) +

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

    -

    TriggerFilter +

    ParallelBranch

    -(Appears on:TriggerSpec) -

    -

    +(Appears on:ParallelSpec)

    +
    +
    @@ -2532,4394 +2281,127 @@ knative.dev/pkg/apis/duck/v1.Status - -
    -attributes
    +filter
    - -TriggerFilterAttributes + +knative.dev/pkg/apis/duck/v1.Destination
    (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.

    +

    Filter is the expression guarding the branch

    -

    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:Trigger) -

    -

    -

    - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -broker
    +subscriber
    -string + +knative.dev/pkg/apis/duck/v1.Destination +
    -

    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.

    -
    -delivery
    - - -DeliverySpec - - -
    -(Optional) -

    Delivery contains the delivery spec for this specific trigger.

    -
    -

    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 - - -
    -(Optional) -

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

    -
    -
    -

    flows.knative.dev/v1

    -

    -

    Package v1 is the v1 version of the API.

    -

    -Resource Types: - -

    Parallel -

    -

    -

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

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -ParallelSpec - - -
    -

    Spec defines the desired state of the Parallel.

    -
    -
    - - - - - - - - - - - - - -
    -branches
    - - -[]ParallelBranch - - -
    -

    Branches is the list of Filter/Subscribers pairs.

    -
    -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).

    -
    -reply
    - - -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

    -
    -
    -status
    - - -ParallelStatus - - -
    -(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 - - -
    -(Optional) -

    Filter is the expression guarding the branch

    -
    -subscriber
    - - -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

    -
    -delivery
    - - -DeliverySpec - - -
    -(Optional) -

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

    -
    -

    ParallelBranchStatus -

    -

    -(Appears on:ParallelStatus) -

    -

    -

    ParallelBranchStatus represents the current state of a Parallel branch

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -filterSubscriptionStatus
    - - -ParallelSubscriptionStatus - - -
    -

    FilterSubscriptionStatus corresponds to the filter subscription status.

    -
    -filterChannelStatus
    - - -ParallelChannelStatus - - -
    -

    FilterChannelStatus corresponds to the filter channel status.

    -
    -subscriberSubscriptionStatus
    - - -ParallelSubscriptionStatus - - -
    -

    SubscriptionStatus corresponds to the subscriber subscription status.

    -
    -

    ParallelChannelStatus -

    -

    -(Appears on:ParallelBranchStatus, ParallelStatus) -

    -

    -

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

    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
    -branches
    - - -[]ParallelBranch - - -
    -

    Branches is the list of Filter/Subscribers pairs.

    -
    -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).

    -
    -reply
    - - -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

    -
    -

    ParallelStatus -

    -

    -(Appears on:Parallel) -

    -

    -

    ParallelStatus represents the current state of a Parallel.

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    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.

    -
    -ingressChannelStatus
    - - -ParallelChannelStatus - - -
    -

    IngressChannelStatus corresponds to the ingress channel status.

    -
    -branchStatuses
    - - -[]ParallelBranchStatus - - -
    -

    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}

    -
    -

    ParallelSubscriptionStatus -

    -

    -(Appears on:ParallelBranchStatus) -

    -

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -subscription
    - - -Kubernetes core/v1.ObjectReference - - -
    -

    Subscription is the reference to the underlying Subscription.

    -
    -ready
    - -knative.dev/pkg/apis.Condition - -
    -

    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.

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -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. Each step has its own delivery options

    -
    -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).

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

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

    -
    -
    -status
    - - -SequenceStatus - - -
    -(Optional) -

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

    -
    -

    SequenceChannelStatus -

    -

    -(Appears on:SequenceStatus) -

    -

    -

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

    Channel is the reference to the underlying channel.

    -
    -ready
    - -knative.dev/pkg/apis.Condition - -
    -

    ReadyCondition indicates whether the Channel is ready or not.

    -
    -

    SequenceSpec -

    -

    -(Appears on:Sequence) -

    -

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -steps
    - - -[]SequenceStep - - -
    -

    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 - - -
    -(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
    - - -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 - - -
    -

    -(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
    - - -[]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}

    -
    -

    SequenceStep -

    -

    -(Appears on:SequenceSpec) -

    -

    -

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

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

    -

    Subscriber receiving the step event

    -
    -delivery
    - - -DeliverySpec - - -
    -(Optional) -

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

    -
    -

    SequenceSubscriptionStatus -

    -

    -(Appears on:SequenceStatus) -

    -

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -subscription
    - - -Kubernetes core/v1.ObjectReference - - -
    -

    Subscription is the reference to the underlying Subscription.

    -
    -ready
    - -knative.dev/pkg/apis.Condition - -
    -

    ReadyCondition indicates whether the Subscription is ready or not.

    -
    -
    -

    flows.knative.dev/v1beta1

    -

    -

    Package v1beta1 is the v1beta1 version of the API.

    -

    -Resource Types: - -

    Parallel -

    -

    -

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

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -ParallelSpec - - -
    -

    Spec defines the desired state of the Parallel.

    -
    -
    - - - - - - - - - - - - - -
    -branches
    - - -[]ParallelBranch - - -
    -

    Branches is the list of Filter/Subscribers pairs.

    -
    -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).

    -
    -reply
    - - -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

    -
    -
    -status
    - - -ParallelStatus - - -
    -(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 - - -
    -(Optional) -

    Filter is the expression guarding the branch

    -
    -subscriber
    - - -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

    -
    -delivery
    - - -DeliverySpec - - -
    -(Optional) -

    Delivery is the delivery specification for events to the subscriber -This includes things like retries, DLQ, etc. -Needed for Roundtripping v1alpha1 <-> v1beta1.

    -
    -

    ParallelBranchStatus -

    -

    -(Appears on:ParallelStatus) -

    -

    -

    ParallelBranchStatus represents the current state of a Parallel branch

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -filterSubscriptionStatus
    - - -ParallelSubscriptionStatus - - -
    -

    FilterSubscriptionStatus corresponds to the filter subscription status.

    -
    -filterChannelStatus
    - - -ParallelChannelStatus - - -
    -

    FilterChannelStatus corresponds to the filter channel status.

    -
    -subscriberSubscriptionStatus
    - - -ParallelSubscriptionStatus - - -
    -

    SubscriptionStatus corresponds to the subscriber subscription status.

    -
    -

    ParallelChannelStatus -

    -

    -(Appears on:ParallelBranchStatus, ParallelStatus) -

    -

    -

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

    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
    -branches
    - - -[]ParallelBranch - - -
    -

    Branches is the list of Filter/Subscribers pairs.

    -
    -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).

    -
    -reply
    - - -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

    -
    -

    ParallelStatus -

    -

    -(Appears on:Parallel) -

    -

    -

    ParallelStatus represents the current state of a Parallel.

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    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.

    -
    -ingressChannelStatus
    - - -ParallelChannelStatus - - -
    -

    IngressChannelStatus corresponds to the ingress channel status.

    -
    -branchStatuses
    - - -[]ParallelBranchStatus - - -
    -

    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}

    -
    -

    ParallelSubscriptionStatus -

    -

    -(Appears on:ParallelBranchStatus) -

    -

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -subscription
    - - -Kubernetes core/v1.ObjectReference - - -
    -

    Subscription is the reference to the underlying Subscription.

    -
    -ready
    - -knative.dev/pkg/apis.Condition - -
    -

    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.

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -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. Each step has its own delivery options

    -
    -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).

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

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

    -
    -
    -status
    - - -SequenceStatus - - -
    -(Optional) -

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

    -
    -

    SequenceChannelStatus -

    -

    -(Appears on:SequenceStatus) -

    -

    -

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

    Channel is the reference to the underlying channel.

    -
    -ready
    - -knative.dev/pkg/apis.Condition - -
    -

    ReadyCondition indicates whether the Channel is ready or not.

    -
    -

    SequenceSpec -

    -

    -(Appears on:Sequence) -

    -

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -steps
    - - -[]SequenceStep - - -
    -

    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 - - -
    -(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
    - - -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 - - -
    -

    -(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
    - - -[]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}

    -
    -

    SequenceStep -

    -

    -(Appears on:SequenceSpec) -

    -

    -

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

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

    -

    Subscriber receiving the step event

    -
    -delivery
    - - -DeliverySpec - - -
    -(Optional) -

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

    -
    -

    SequenceSubscriptionStatus -

    -

    -(Appears on:SequenceStatus) -

    -

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -subscription
    - - -Kubernetes core/v1.ObjectReference - - -
    -

    Subscription is the reference to the underlying Subscription.

    -
    -ready
    - -knative.dev/pkg/apis.Condition - -
    -

    ReadyCondition indicates whether the Subscription is ready or not.

    -
    -
    -

    messaging.knative.dev/v1

    -

    -

    Package v1 is the v1 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/v1 - -
    -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.

    -
    -ChannelableSpec
    - - -ChannelableSpec - - -
    -

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

    -

    Channel conforms to ChannelableSpec

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

    -
    -
    - - - - - -
    -ChannelableSpec
    - - -ChannelableSpec - - -
    -

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

    -

    Channel conforms to Duck type Channelable.

    -
    -
    -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/v1 - -
    -kind
    -string -
    Subscription
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -SubscriptionSpec - - -
    -
    -
    - - - - - - - - - - - - - - - - - -
    -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

    -
    -
    -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:ParallelSpec, SequenceSpec, ChannelSpec) -

    -

    -

    - - - - - - - - - - - - - -
    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.

    -
    -
    - -
    -
    -

    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.

    -
    -
    -

    messaging.knative.dev/v1beta1

    -

    -

    Package v1beta1 is the v1beta1 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/v1beta1 - -
    -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.

    -
    -ChannelableSpec
    - - -ChannelableSpec - - -
    -

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

    -

    Channel conforms to ChannelableSpec

    -
    -
    -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/v1beta1 - -
    -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.

    -
    -
    - - - - - -
    -ChannelableSpec
    - - -ChannelableSpec - - -
    -

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

    -

    Channel conforms to Duck type Channelable.

    -
    -
    -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/v1beta1 - -
    -kind
    -string -
    Subscription
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -SubscriptionSpec - - -
    -
    -
    - - - - - - - - - - - - - - - - - -
    -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

    -
    -
    -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:ParallelSpec, SequenceSpec, ChannelSpec) -

    -

    -

    - - - - - - - - - - - - - -
    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.

    -
    -
    - -
    -
    -

    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.

    -
    -
    -

    sources.knative.dev/v1

    -

    -

    Package v1 contains API Schema definitions for the sources v1 API group.

    -

    -Resource Types: - -

    ApiServerSource -

    -

    -

    ApiServerSource is the Schema for the apiserversources API

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -apiVersion
    -string
    - -sources.knative.dev/v1 - -
    -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
    - - -[]APIVersionKindSelector - - -
    -

    Resource are the resources this source will track and send related -lifecycle events from the Kubernetes ApiServer, with an optional label -selector to help filter.

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

    ContainerSource -

    -

    -

    ContainerSource is the Schema for the containersources API

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -apiVersion
    -string
    - -sources.knative.dev/v1 - -
    -kind
    -string -
    ContainerSource
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -ContainerSourceSpec - - -
    -
    -
    - - - - - - - - - -
    -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.

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

    Template describes the pods that will be created

    -
    -
    -status
    - - -ContainerSourceStatus - - -
    -
    -

    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/v1 - -
    -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/v1.BindingSpec - - -
    -

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

    -

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

    -

    -

    APIVersionKind is an APIVersion and Kind tuple.

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -apiVersion
    - -string - -
    -

    APIVersion - the 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

    -
    -

    APIVersionKindSelector -

    -

    -(Appears on:ApiServerSourceSpec) -

    -

    -

    APIVersionKindSelector is an APIVersion Kind tuple with a LabelSelector.

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -apiVersion
    - -string - -
    -

    APIVersion - the 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

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

    -
    -

    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
    - - -[]APIVersionKindSelector - - -
    -

    Resource are the resources this source will track and send related -lifecycle events from the Kubernetes ApiServer, with an optional label -selector to help filter.

    -
    -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.

    -
    -

    ContainerSourceSpec -

    -

    -(Appears on:ContainerSource) -

    -

    -

    ContainerSourceSpec defines the desired state of ContainerSource

    -

    - - - - - - - - - - - - - - - - - -
    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.

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

    Template describes the pods that will be created

    -
    -

    ContainerSourceStatus -

    -

    -(Appears on:ContainerSource) -

    -

    -

    ContainerSourceStatus defines the observed state of ContainerSource

    -

    - - - - - - - - - - - - - -
    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/v1.BindingSpec - - -
    -

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

    -

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

    -
    -
    -

    sources.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.knative.dev/v1alpha1 - -
    -kind
    -string -
    ApiServerSource
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -ApiServerSourceSpec - - -
    -
    -
    - - - - - - - - + +
    -resources
    - - -[]ApiServerResource - - -
    -

    Resources is the list of resources to watch

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

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

    +
    +

    Subscriber receiving the event when the filter passes

    -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 Subscriber of this case gets sent to. +If not specified, sent the result to the Parallel Reply

    -ceOverrides
    +delivery
    - -knative.dev/pkg/apis/duck/v1.CloudEventOverrides + +DeliverySpec
    (Optional) -

    CloudEventOverrides defines overrides to control the output format and -modifications of the event sent to the sink.

    +

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

    +

    ParallelBranchStatus +

    +

    +(Appears on:ParallelStatus) +

    +
    +

    ParallelBranchStatus represents the current state of a Parallel branch

    +
    + + + + + + + + - -
    FieldDescription
    -owner
    +filterSubscriptionStatus
    - -APIVersionKind + +ParallelSubscriptionStatus
    -(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.

    +

    FilterSubscriptionStatus corresponds to the filter subscription status.

    -mode
    +filterChannelStatus
    -string + +ParallelChannelStatus +
    -

    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.

    -
    +

    FilterChannelStatus corresponds to the filter channel status.

    -status
    +subscriberSubscriptionStatus
    - -ApiServerSourceStatus + +ParallelSubscriptionStatus
    +

    SubscriptionStatus corresponds to the subscriber subscription status.

    -

    SinkBinding +

    ParallelChannelStatus

    -

    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:ParallelBranchStatus, ParallelStatus)

    +
    +
    @@ -6930,103 +2412,98 @@ cloud events.

    - - - - - - - - + + +
    -apiVersion
    -string
    - -sources.knative.dev/v1alpha1 - -
    -kind
    -string -
    SinkBinding
    -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
    - -SinkBindingSpec - +knative.dev/pkg/apis.Condition
    -
    -
    +

    ReadyCondition indicates whether the Channel is ready or not.

    +
    +

    ParallelSpec +

    +

    +(Appears on:Parallel) +

    +
    +
    + + + + + + + - -
    FieldDescription
    -SourceSpec
    +branches
    - -knative.dev/pkg/apis/duck/v1.SourceSpec + +[]ParallelBranch
    -

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

    +

    Branches is the list of Filter/Subscribers pairs.

    -BindingSpec
    +channelTemplate
    - -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +ChannelTemplateSpec
    -

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

    -
    +(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
    - -SinkBindingStatus + +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

    -

    ApiServerResource +

    ParallelStatus

    -(Appears on:ApiServerSourceSpec) -

    -

    -

    ApiServerResource defines the resource to watch

    +(Appears on:Parallel)

    +
    +

    ParallelStatus represents the current state of a Parallel.

    +
    @@ -7037,80 +2514,116 @@ SinkBindingStatus + + + + + +
    -apiVersion
    +Status
    -string + +knative.dev/pkg/apis/duck/v1.Status +
    -

    API version of the resource to watch.

    +

    +(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
    +ingressChannelStatus
    -string + +ParallelChannelStatus +
    -

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

    +

    IngressChannelStatus corresponds to the ingress channel status.

    -labelSelector
    +branchStatuses
    - -Kubernetes meta/v1.LabelSelector + +[]ParallelBranchStatus
    -

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

    +

    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}

    +

    ParallelSubscriptionStatus +

    +

    +(Appears on:ParallelBranchStatus) +

    +
    +
    + + + + + + + +
    FieldDescription
    -controllerSelector
    +subscription
    - -Kubernetes meta/v1.OwnerReference + +Kubernetes core/v1.ObjectReference
    -

    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.

    +

    Subscription is the reference to the underlying Subscription.

    -controller
    +ready
    -bool +knative.dev/pkg/apis.Condition
    -

    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.

    +

    ReadyCondition indicates whether the Subscription is ready or not.

    -

    ApiServerSourceSpec +

    Sequence

    -

    -(Appears on:ApiServerSource) -

    -

    -

    ApiServerSourceSpec defines the desired state of ApiServerSource

    -

    +
    +

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

    +
    @@ -7121,98 +2634,103 @@ v1alpha2, please use Spec.Owner as a GKV.

    - +

    Spec defines the desired state of the Sequence.

    +
    +
    +
    -resources
    +metadata
    - -[]ApiServerResource + +Kubernetes meta/v1.ObjectMeta
    -

    Resources is the list of resources to watch

    +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field.
    -serviceAccountName
    +spec
    -string + +SequenceSpec +
    -(Optional) -

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

    -
    + +
    -sink
    +steps
    - -knative.dev/pkg/apis/duck/v1beta1.Destination + +[]SequenceStep
    -(Optional) -

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

    +

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

    -ceOverrides
    +channelTemplate
    - -knative.dev/pkg/apis/duck/v1.CloudEventOverrides + +ChannelTemplateSpec
    (Optional) -

    CloudEventOverrides defines overrides to control the output format and -modifications of the event sent to the sink.

    +

    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).

    -owner
    +reply
    - -APIVersionKind + +knative.dev/pkg/apis/duck/v1.Destination
    (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.

    +

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

    +
    -mode
    +status
    -string + +SequenceStatus + -

    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 Sequence. This data may be out of +date.

    -

    ApiServerSourceStatus +

    SequenceChannelStatus

    -(Appears on:ApiServerSource) -

    -

    -

    ApiServerSourceStatus defines the observed state of ApiServerSource

    +(Appears on:SequenceStatus)

    +
    +
    @@ -7223,36 +2741,37 @@ string + + + +
    -SourceStatus
    +channel
    - -knative.dev/pkg/apis/duck/v1.SourceStatus + +Kubernetes core/v1.ObjectReference
    -

    -(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.

    +

    Channel is the reference to the underlying channel.

    +
    +ready
    + +knative.dev/pkg/apis.Condition + +
    +

    ReadyCondition indicates whether the Channel is ready or not.

    -

    SinkBindingSpec +

    SequenceSpec

    -(Appears on:SinkBinding) -

    -

    -

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

    +(Appears on:Sequence)

    +
    +
    @@ -7263,89 +2782,57 @@ Source.

    - -
    -SourceSpec
    +steps
    - -knative.dev/pkg/apis/duck/v1.SourceSpec + +[]SequenceStep
    -

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

    +

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

    -BindingSpec
    +channelTemplate
    - -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +ChannelTemplateSpec
    -

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

    +(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).

    -

    SinkBindingStatus -

    -

    -(Appears on:SinkBinding) -

    -

    -

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

    -

    - - - - - - - -
    FieldDescription
    -SourceStatus
    +reply
    - -knative.dev/pkg/apis/duck/v1.SourceStatus + +knative.dev/pkg/apis/duck/v1.Destination
    -

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

    +(Optional) +

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

    -
    -

    sources.knative.dev/v1alpha2

    -

    -

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

    -

    -Resource Types: - -

    ApiServerSource +

    SequenceStatus

    -

    ApiServerSource is the Schema for the apiserversources API

    +(Appears on:Sequence)

    +
    +

    SequenceStatus represents the current state of a Sequence.

    +
    @@ -7356,149 +2843,176 @@ Resource Types: - - - - +
    +
    +
    -apiVersion
    -string
    - -sources.knative.dev/v1alpha2 - +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.

    ApiServerSource
    -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
    - -ApiServerSourceSpec + +[]SequenceChannelStatus
    -
    -
    - +

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

    + + + + +
    -SourceSpec
    +address
    - -knative.dev/pkg/apis/duck/v1.SourceSpec + +knative.dev/pkg/apis/duck/v1.Addressable
    +(Optional) +

    Address 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 +

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

    -

    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.

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

    Resource are the resources this source will track and send related -lifecycle events from the Kubernetes ApiServer, with an optional label -selector to help filter.

    +

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

    +

    Subscriber receiving the step event

    -owner
    +delivery
    - -APIVersionKind + +DeliverySpec
    (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.

    +

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

    +

    SequenceSubscriptionStatus +

    +

    +(Appears on:SequenceStatus) +

    +
    +
    + + - - + + + + - - -
    -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

    -
    FieldDescription
    -serviceAccountName
    +subscription
    -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.

    -
    - + +

    Subscription is the reference to the underlying Subscription.

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

    ReadyCondition indicates whether the Subscription is ready or not.

    -

    ContainerSource +
    +

    messaging.knative.dev/v1

    +
    +

    Package v1 is the v1 version of the API.

    +
    +Resource Types: + +

    Channel

    -

    -

    ContainerSource is the Schema for the containersources API

    -

    +
    +

    Channel represents a generic Channel. It is normally used when we want a +Channel, but do not need a specific Channel implementation.

    +
    @@ -7513,7 +3027,7 @@ ApiServerSourceStatus string @@ -7522,7 +3036,7 @@ sources.knative.dev/v1alpha2 kind
    string - + @@ -7542,46 +3057,46 @@ Refer to the Kubernetes API documentation for the fields of the
    -sources.knative.dev/v1alpha2 +messaging.knative.dev/v1
    ContainerSourceChannel
    @@ -7534,6 +3048,7 @@ Kubernetes meta/v1.ObjectMeta +(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
    - -ContainerSourceSpec + +ChannelSpec
    +

    Spec defines the desired state of the Channel.



    -SourceSpec
    +channelTemplate
    - -knative.dev/pkg/apis/duck/v1.SourceSpec + +ChannelTemplateSpec
    -

    -(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.

    +(Optional) +

    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.

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

    Template describes the pods that will be created

    +

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

    +

    Channel conforms to ChannelableSpec

    @@ -7591,21 +3106,24 @@ Kubernetes core/v1.PodTemplateSpec
    status
    - -ContainerSourceStatus + +ChannelStatus
    +(Optional) +

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

    -

    PingSource +

    InMemoryChannel

    -

    -

    PingSource is the Schema for the PingSources API.

    -

    +
    +

    InMemoryChannel is a resource representing an in memory channel

    +
    @@ -7620,7 +3138,7 @@ ContainerSourceStatus string @@ -7629,7 +3147,7 @@ sources.knative.dev/v1alpha2 kind
    string - + @@ -7649,59 +3168,30 @@ Refer to the Kubernetes API documentation for the fields of the
    -sources.knative.dev/v1alpha2 +messaging.knative.dev/v1
    PingSourceInMemoryChannel
    @@ -7641,6 +3159,7 @@ Kubernetes meta/v1.ObjectMeta +(Optional) Refer to the Kubernetes API documentation for the fields of the metadata field. spec
    - -PingSourceSpec + +InMemoryChannelSpec
    +

    Spec defines the desired state of the Channel.



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

    -(Members of SourceSpec are embedded into this type.) +(Members of ChannelableSpec 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”.

    +

    Channel conforms to Duck type Channelable.

    @@ -7711,26 +3201,25 @@ to “application/json”.

    status
    - -PingSourceStatus + +InMemoryChannelStatus
    +(Optional) +

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

    -

    SinkBinding +

    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.

    -

    +
    +

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

    +
    @@ -7745,7 +3234,7 @@ cloud events.

    string @@ -7754,7 +3243,7 @@ sources.knative.dev/v1alpha2 kind
    string - + @@ -7785,165 +3274,109 @@ SinkBindingSpec
    -sources.knative.dev/v1alpha2 +messaging.knative.dev/v1
    SinkBindingSubscription
    @@ -7774,8 +3263,8 @@ Refer to the Kubernetes API documentation for the fields of the spec
    - -SinkBindingSpec + +SubscriptionSpec
    - -
    -SourceSpec
    +channel
    - -knative.dev/pkg/apis/duck/v1.SourceSpec + +Kubernetes core/v1.ObjectReference
    -

    -(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.

    +

    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.)

    -BindingSpec
    +subscriber
    - -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +knative.dev/pkg/apis/duck/v1.Destination
    -

    -(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.

    -
    +(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.

    -status
    +reply
    - -SinkBindingStatus + +knative.dev/pkg/apis/duck/v1.Destination - - - - -

    APIVersionKind -

    -

    -(Appears on:ApiServerSourceSpec, ApiServerSourceSpec) -

    -

    -

    APIVersionKind is an APIVersion and Kind tuple.

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -apiVersion
    - -string - -
    -

    APIVersion - the 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

    -
    -

    APIVersionKindSelector -

    -

    -(Appears on:ApiServerSourceSpec) -

    -

    -

    APIVersionKindSelector is an APIVersion Kind tuple with a LabelSelector.

    -

    - - - - - - - - - - - + +
    FieldDescription
    -apiVersion
    - -string - -
    -

    APIVersion - the API version of the resource to watch.

    +(Optional) +

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

    -kind
    +delivery
    -string + +DeliverySpec +
    -

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

    +(Optional) +

    Delivery configuration

    +
    -selector
    +status
    - -Kubernetes meta/v1.LabelSelector + +SubscriptionStatus -(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

    -

    ApiServerSourceSpec +

    ChannelDefaulter +

    +
    +

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

    +
    +

    ChannelSpec

    -(Appears on:ApiServerSource) -

    -

    -

    ApiServerSourceSpec defines the desired state of ApiServerSource

    +(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.

    +
    @@ -7954,93 +3387,93 @@ More info: -knative.dev/pkg/apis/duck/v1.SourceSpec + +ChannelTemplateSpec + +
    -

    -(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.

    +(Optional) +

    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.

    -resources
    +ChannelableSpec
    - -[]APIVersionKindSelector + +ChannelableSpec
    -

    Resource are the resources this source will track and send related -lifecycle events from the Kubernetes ApiServer, with an optional label -selector to help filter.

    +

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

    +

    Channel conforms to ChannelableSpec

    +

    ChannelStatus +

    +

    +(Appears on:Channel) +

    +
    +

    ChannelStatus represents the current state of a Channel.

    +
    + + - - + + + +
    -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.

    -
    FieldDescription
    -mode
    +ChannelableStatus
    -string + +ChannelableStatus +
    -(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 ChannelableStatus are embedded into this type.) +

    +

    Channel conforms to ChannelableStatus

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

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

    +

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

    -

    ApiServerSourceStatus +

    ChannelTemplateSpec

    -(Appears on:ApiServerSource) -

    -

    -

    ApiServerSourceStatus defines the observed state of ApiServerSource

    +(Appears on:ParallelSpec, SequenceSpec, ChannelSpec)

    +
    +
    @@ -8051,36 +3484,33 @@ source. Defaults to default if not set.

    -SourceStatus
    +spec
    - -knative.dev/pkg/apis/duck/v1.SourceStatus - +k8s.io/apimachinery/pkg/runtime.RawExtension
    -

    -(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.

    +(Optional) +

    Spec defines the Spec to use for each channel created. Passed +in verbatim to the Channel CRD as Spec section.

    +
    +
    + +
    -

    ContainerSourceSpec +

    InMemoryChannelSpec

    -(Appears on:ContainerSource) -

    -

    -

    ContainerSourceSpec defines the desired state of ContainerSource

    +(Appears on:InMemoryChannel)

    +
    +

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

    +
    @@ -8091,47 +3521,30 @@ Source.

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

    -(Members of SourceSpec are embedded into this type.) +(Members of ChannelableSpec 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.

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

    Template describes the pods that will be created

    +

    Channel conforms to Duck type Channelable.

    -

    ContainerSourceStatus +

    InMemoryChannelStatus

    -(Appears on:ContainerSource) -

    -

    -

    ContainerSourceStatus defines the observed state of ContainerSource

    +(Appears on:InMemoryChannel)

    +
    +

    ChannelStatus represents the current state of a Channel.

    +
    @@ -8142,36 +3555,41 @@ Kubernetes core/v1.PodTemplateSpec
    -SourceStatus
    +ChannelableStatus
    - -knative.dev/pkg/apis/duck/v1.SourceStatus + +ChannelableStatus

    -(Members of SourceStatus are embedded into this type.) +(Members of ChannelableStatus 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.

    +

    Channel conforms to Duck type Channelable.

    -

    PingSourceSpec +

    SubscriptionSpec

    -(Appears on:PingSource) -

    -

    -

    PingSourceSpec defines the desired state of the 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

    +
    @@ -8182,60 +3600,86 @@ Source.

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

    -(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.

    +

    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.)

    -schedule
    +subscriber
    -string + +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) -

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

    +

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

    -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”.

    +

    Delivery configuration

    -

    PingSourceStatus +

    SubscriptionStatus

    -(Appears on:PingSource) -

    -

    -

    PingSourceStatus defines the observed state of PingSource.

    +(Appears on:Subscription)

    +
    +

    SubscriptionStatus (computed) for a subscription

    +
    @@ -8246,36 +3690,46 @@ to “application/json”.

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

    -(Members of SourceStatus are embedded into this type.) +(Members of Status 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.

    +

    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.

    -

    SinkBindingSpec +

    SubscriptionStatusPhysicalSubscription

    -(Appears on:SinkBinding) -

    -

    -

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

    +(Appears on:SubscriptionStatus)

    +
    +

    SubscriptionStatusPhysicalSubscription represents the fully resolved values for this +Subscription.

    +
    @@ -8286,104 +3740,68 @@ Source.

    - -
    -SourceSpec
    +subscriberUri
    - -knative.dev/pkg/apis/duck/v1.SourceSpec + +knative.dev/pkg/apis.URL
    -

    -(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.

    +(Optional) +

    SubscriberURI is the fully resolved URI for spec.subscriber.

    -BindingSpec
    +replyUri
    - -knative.dev/pkg/apis/duck/v1alpha1.BindingSpec + +knative.dev/pkg/apis.URL
    -

    -(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.

    +(Optional) +

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

    -

    SinkBindingStatus -

    -

    -(Appears on:SinkBinding) -

    -

    -

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

    -

    - - - - - - - -
    FieldDescription
    -SourceStatus
    +deadLetterSinkUri
    - -knative.dev/pkg/apis/duck/v1.SourceStatus + +knative.dev/pkg/apis.URL
    -

    -(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.

    +(Optional) +

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


    -

    sources.knative.dev/v1beta1

    -

    -

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

    -

    +

    sources.knative.dev/v1

    +
    +

    Package v1 contains API Schema definitions for the sources v1 API group.

    +
    Resource Types: -

    ApiServerSource +

    ApiServerSource

    -

    +

    ApiServerSource is the Schema for the apiserversources API

    -

    +
    @@ -8398,7 +3816,7 @@ Resource Types: string @@ -8427,7 +3845,7 @@ Refer to the Kubernetes API documentation for the fields of the
    -sources.knative.dev/v1beta1 +sources.knative.dev/v1
    spec
    - + ApiServerSourceSpec @@ -8460,7 +3878,7 @@ and modifications of the event sent to the sink.

    resources
    - + []APIVersionKindSelector @@ -8475,7 +3893,7 @@ selector to help filter.

    owner
    - + APIVersionKind @@ -8522,7 +3940,7 @@ source. Defaults to default if not set.

    status
    - + ApiServerSourceStatus @@ -8532,11 +3950,11 @@ ApiServerSourceStatus
    -

    ContainerSource +

    ContainerSource

    -

    +

    ContainerSource is the Schema for the containersources API

    -

    +
    @@ -8551,7 +3969,7 @@ ApiServerSourceStatus string @@ -8580,7 +3998,7 @@ Refer to the Kubernetes API documentation for the fields of the
    -sources.knative.dev/v1beta1 +sources.knative.dev/v1
    spec
    - + ContainerSourceSpec @@ -8629,7 +4047,7 @@ Kubernetes core/v1.PodTemplateSpec
    status
    - + ContainerSourceStatus @@ -8639,11 +4057,11 @@ ContainerSourceStatus
    -

    PingSource +

    PingSource

    -

    +

    PingSource is the Schema for the PingSources API.

    -

    +
    @@ -8658,7 +4076,7 @@ ContainerSourceStatus string @@ -8687,7 +4105,7 @@ Refer to the Kubernetes API documentation for the fields of the @@ -8744,16 +4162,40 @@ List of valid timezone values: + PingSourceStatus @@ -8773,16 +4215,16 @@ PingSourceStatus
    -sources.knative.dev/v1beta1 +sources.knative.dev/v1
    spec
    - + PingSourceSpec @@ -8725,7 +4143,7 @@ string
    (Optional) -

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

    +

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

    -

    SinkBinding +

    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.

    -

    +
    @@ -8797,7 +4239,7 @@ cloud events.

    string @@ -8826,7 +4268,7 @@ Refer to the Kubernetes API documentation for the fields of the @@ -8868,7 +4310,7 @@ knative.dev/pkg/apis/duck/v1beta1.BindingSpec

    (Members of BindingSpec are embedded into this type.)

    -

    inherits duck/v1beta1 BindingSpec, which currently provides: +

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

    @@ -8880,7 +4322,7 @@ should be augmented by Binding implementations.

    -sources.knative.dev/v1beta1 +sources.knative.dev/v1
    spec
    - + SinkBindingSpec @@ -8859,8 +4301,8 @@ and modifications of the event sent to the sink.

    BindingSpec
    - -knative.dev/pkg/apis/duck/v1beta1.BindingSpec + +knative.dev/pkg/apis/duck/v1.BindingSpec
    status
    - + SinkBindingStatus @@ -8890,14 +4332,14 @@ SinkBindingStatus
    -

    APIVersionKind +

    APIVersionKind

    -(Appears on:ApiServerSourceSpec) +(Appears on:ApiServerSourceSpec)

    -

    +

    APIVersionKind is an APIVersion and Kind tuple.

    -

    +
    @@ -8931,14 +4373,14 @@ More info: APIVersionKindSelector +

    APIVersionKindSelector

    -(Appears on:ApiServerSourceSpec) +(Appears on:ApiServerSourceSpec)

    -

    +

    APIVersionKindSelector is an APIVersion Kind tuple with a LabelSelector.

    -

    +
    @@ -8988,14 +4430,14 @@ More info: ApiServerSourceSpec +

    ApiServerSourceSpec

    -(Appears on:ApiServerSource) +(Appears on:ApiServerSource)

    -

    +

    ApiServerSourceSpec defines the desired state of ApiServerSource

    -

    +
    @@ -9028,7 +4470,7 @@ and modifications of the event sent to the sink.

    resources
    - + []APIVersionKindSelector @@ -9043,7 +4485,7 @@ selector to help filter.

    owner
    - + APIVersionKind @@ -9085,14 +4527,14 @@ source. Defaults to default if not set.

    -

    ApiServerSourceStatus +

    ApiServerSourceStatus

    -(Appears on:ApiServerSource) +(Appears on:ApiServerSource)

    -

    +

    ApiServerSourceStatus defines the observed state of ApiServerSource

    -

    +
    @@ -9125,14 +4567,14 @@ Source.

    -

    ContainerSourceSpec +

    ContainerSourceSpec

    -(Appears on:ContainerSource) +(Appears on:ContainerSource)

    -

    +

    ContainerSourceSpec defines the desired state of ContainerSource

    -

    +
    @@ -9176,14 +4618,14 @@ Kubernetes core/v1.PodTemplateSpec
    -

    ContainerSourceStatus +

    ContainerSourceStatus

    -(Appears on:ContainerSource) +(Appears on:ContainerSource)

    -

    +

    ContainerSourceStatus defines the observed state of ContainerSource

    -

    +
    @@ -9216,14 +4658,14 @@ Source.

    -

    PingSourceSpec +

    PingSourceSpec

    -(Appears on:PingSource) +(Appears on:PingSource)

    -

    +

    PingSourceSpec defines the desired state of the PingSource.

    -

    +
    @@ -9261,7 +4703,7 @@ string @@ -9280,28 +4722,52 @@ List of valid timezone values: PingSourceStatus +

    PingSourceStatus

    -(Appears on:PingSource) +(Appears on:PingSource)

    -

    +

    PingSourceStatus defines the observed state of PingSource.

    -

    +
    (Optional) -

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

    +

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

    @@ -9334,14 +4800,14 @@ Source.

    -

    SinkBindingSpec +

    SinkBindingSpec

    -(Appears on:SinkBinding) +(Appears on:SinkBinding)

    -

    +

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

    -

    +
    @@ -9374,8 +4840,8 @@ and modifications of the event sent to the sink.

    @@ -9383,21 +4849,21 @@ knative.dev/pkg/apis/duck/v1beta1.BindingSpec

    (Members of BindingSpec are embedded into this type.)

    -

    inherits duck/v1beta1 BindingSpec, which currently provides: +

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

    BindingSpec
    - -knative.dev/pkg/apis/duck/v1beta1.BindingSpec + +knative.dev/pkg/apis/duck/v1.BindingSpec
    -

    SinkBindingStatus +

    SinkBindingStatus

    -(Appears on:SinkBinding) +(Appears on:SinkBinding)

    -

    +

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

    -

    +
    @@ -9432,18 +4898,18 @@ Source.


    sources.knative.dev/v1beta2

    -

    +

    Package v1beta2 contains API Schema definitions for the sources v1beta2 API group.

    -

    +
    Resource Types:

    PingSource

    -

    +

    PingSource is the Schema for the PingSources API.

    -

    +
    @@ -9602,9 +5068,9 @@ PingSourceStatus

    (Appears on:PingSource)

    -

    +

    PingSourceSpec defines the desired state of the PingSource.

    -

    +
    @@ -9704,9 +5170,9 @@ Mutually exclusive with Data.

    (Appears on:PingSource)

    -

    +

    PingSourceStatus defines the observed state of PingSource.

    -

    +
    @@ -9742,5 +5208,5 @@ Source.


    Generated with gen-crd-api-reference-docs -on git commit 8f35d4254. +on git commit 200e54c6c.

    diff --git a/docs/reference/api/serving.md b/docs/reference/api/serving.md index 5806aa8a964..86e175363de 100644 --- a/docs/reference/api/serving.md +++ b/docs/reference/api/serving.md @@ -11,21 +11,21 @@

    autoscaling.internal.knative.dev/v1alpha1

    -

    +

    Package v1alpha1 contains the Autoscaling v1alpha1 API types.

    -

    +
    Resource Types:

    PodAutoscaler

    -

    +

    PodAutoscaler is a Knative abstraction that encapsulates the interface by which Knative components instantiate autoscalers. This definition is an abstraction that may be backed by multiple definitions. For more information, see the Knative Pluggability presentation: https://docs.google.com/presentation/d/10KWynvAJYuOEWy69VBa6bHJVCqIsz1TNdEKosNvcpPY/edit

    -

    +
    @@ -158,9 +158,9 @@ PodAutoscalerStatus

    Metric

    -

    +

    Metric represents a resource to configure the metric collector with.

    -

    +
    @@ -260,9 +260,9 @@ MetricStatus

    (Appears on:Metric)

    -

    +

    MetricSpec contains all values a metric collector needs to operate.

    -

    +
    @@ -315,9 +315,9 @@ string

    (Appears on:Metric)

    -

    +

    MetricStatus reflects the status of metric collection for this specific entity.

    -

    +
    @@ -348,9 +348,9 @@ knative.dev/pkg/apis/duck/v1.Status

    (Appears on:PodAutoscaler)

    -

    +

    PodAutoscalerSpec holds the desired state of the PodAutoscaler (from the client).

    -

    +
    @@ -422,9 +422,9 @@ knative.dev/networking/pkg/apis/networking.ProtocolType

    (Appears on:PodAutoscaler)

    -

    +

    PodAutoscalerStatus communicates the observed state of the PodAutoscaler (from the controller).

    -

    +
    @@ -498,13 +498,13 @@ int32

    PodScalable

    -

    +

    PodScalable is a duck type that the resources referenced by the PodAutoscaler’s ScaleTargetRef must implement. They must also implement the /scale sub-resource for use with /scale based implementations (e.g. HPA), but this further constrains the shape the referenced resources may take.

    -

    +
    @@ -596,10 +596,10 @@ PodScalableStatus

    (Appears on:PodScalable)

    -

    +

    PodScalableSpec is the specification for the desired state of a PodScalable (or at least our shared portion).

    -

    +
    @@ -649,10 +649,10 @@ Kubernetes core/v1.PodTemplateSpec

    (Appears on:PodScalable)

    -

    +

    PodScalableStatus is the observed state of a PodScalable (or at least our shared portion).

    -

    +
    @@ -674,14 +674,14 @@ int32

    ReachabilityType -(string alias)

    +(string alias)

    (Appears on:PodAutoscalerSpec)

    -

    +

    ReachabilityType is the enumeration type for the different states of reachability to the ScaleTarget of a PodAutoscaler

    -

    +
    @@ -703,9 +703,9 @@ Used when the reachability cannot be determined, eg. during activation.


    serving.knative.dev/v1

    -

    +

    Package v1 contains the Serving v1 API types.

    -

    +
    Resource Types:

    Configuration

    -

    +

    Configuration represents the “floating HEAD” of a linear history of Revisions. Users create new Revisions by updating the Configuration’s spec. The “latest created” revision’s name is available under status, as is the “latest ready” revision’s name. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#configuration

    -

    +
    @@ -813,12 +813,12 @@ ConfigurationStatus

    Revision

    -

    +

    Revision is an immutable snapshot of code and configuration. A revision references a container image. Revisions are created by updates to a Configuration.

    See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#revision

    -

    +
    @@ -937,14 +937,14 @@ RevisionStatus

    Route

    -

    +

    Route is responsible for configuring ingress over a collection of Revisions. Some of the Revisions a Route distributes traffic over may be specified by referencing the Configuration responsible for creating them; in these cases the Route is additionally responsible for monitoring the Configuration for “latest ready revision” changes, and smoothly rolling out latest revisions. See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#route

    -

    +
    @@ -1036,7 +1036,7 @@ RouteStatus

    Service

    -

    +

    Service acts as a top-level container that manages a Route and Configuration which implement a network service. Service exists to provide a singular abstraction which can be access controlled, reasoned about, and which @@ -1047,7 +1047,7 @@ orchestrates ReplicaSets), and its usage is optional but recommended.

    The Service’s controller will track the statuses of its owned Configuration and Route, reflecting their statuses and conditions as its own.

    See also: https://github.com/knative/serving/blob/main/docs/spec/overview.md#service

    -

    +
    @@ -1160,9 +1160,9 @@ ServiceStatus

    (Appears on:Configuration, ServiceSpec)

    -

    +

    ConfigurationSpec holds the desired state of the Configuration (from the client).

    -

    +
    @@ -1192,9 +1192,9 @@ RevisionTemplateSpec

    (Appears on:Configuration)

    -

    +

    ConfigurationStatus communicates the observed state of the Configuration (from the controller).

    -

    +
    @@ -1240,11 +1240,11 @@ ConfigurationStatusFields

    (Appears on:ConfigurationStatus, ServiceStatus)

    -

    +

    ConfigurationStatusFields holds the fields of Configuration’s status that are not generally shared. This is defined separately and inlined so that other types can readily consume these fields via duck typing.

    -

    +
    @@ -1286,9 +1286,9 @@ Configuration. It might not be ready yet, for that use LatestReadyRevisionName.<

    (Appears on:RevisionStatus)

    -

    +

    ContainerStatus holds the information of container name and image digest value

    -

    +
    @@ -1324,9 +1324,9 @@ string

    (Appears on:Revision, RevisionTemplateSpec)

    -

    +

    RevisionSpec holds the desired state of the Revision (from the client).

    -

    +
    @@ -1386,9 +1386,9 @@ layer will wait for a request delivered to a container to begin replying

    (Appears on:Revision)

    -

    +

    RevisionStatus communicates the observed state of the Revision (from the controller).

    -

    +
    @@ -1513,10 +1513,10 @@ int32

    (Appears on:ConfigurationSpec)

    -

    +

    RevisionTemplateSpec describes the data a revision should have when created from a template. Based on: https://github.com/kubernetes/api/blob/e771f807/core/v1/types.go#L3179-L3190

    -

    +
    @@ -1608,9 +1608,9 @@ layer will wait for a request delivered to a container to begin replying

    (Appears on:Route, ServiceSpec)

    -

    +

    RouteSpec holds the desired state of the Route (from the client).

    -

    +
    @@ -1641,9 +1641,9 @@ revisions and configurations.

    (Appears on:Route)

    -

    +

    RouteStatus communicates the observed state of the Route (from the controller).

    -

    +
    @@ -1689,11 +1689,11 @@ RouteStatusFields

    (Appears on:RouteStatus, ServiceStatus)

    -

    +

    RouteStatusFields holds the fields of Route’s status that are not generally shared. This is defined separately and inlined so that other types can readily consume these fields via duck typing.

    -

    +
    @@ -1751,10 +1751,10 @@ LatestReadyRevisionName that we last observed.

    RoutingState -(string alias)

    -

    +(string alias) +

    RoutingState represents states of a revision with regards to serving a route.

    -

    +
    @@ -1784,7 +1784,7 @@ and is scaled down, but may be rapidly pinned to a route to be made active again

    (Appears on:Service)

    -

    +

    ServiceSpec represents the configuration for the Service object. A Service’s specification is the union of the specifications for a Route and Configuration. The Service restricts what can be expressed in these @@ -1792,7 +1792,7 @@ fields, e.g. the Route must reference the provided Configuration; however, these limitations also enable friendlier defaulting, e.g. Route never needs a Configuration name, and may be defaulted to the appropriate “run latest” spec.

    -

    +
    @@ -1843,9 +1843,9 @@ defaults).

    (Appears on:Service)

    -

    +

    ServiceStatus represents the Status stanza of the Service resource.

    -

    +
    @@ -1910,9 +1910,9 @@ specific to RouteStatus.

    (Appears on:RouteSpec, RouteStatusFields)

    -

    +

    TrafficTarget holds a single entry of the routing table for a Route.

    -

    +
    @@ -2018,21 +2018,21 @@ a hostname, but may not contain anything else (e.g. basic auth, url path, etc.)<

    serving.knative.dev/v1alpha1

    -

    +

    Package v1alpha1 contains the v1alpha1 versions of the serving apis. Api versions allow the api contract for a resource to be changed while keeping backward compatibility by support multiple concurrent versions of the same resource

    -

    +
    Resource Types:

    DomainMapping

    -

    +

    DomainMapping is a mapping from a custom hostname to an Addressable.

    -

    +
    @@ -2132,9 +2132,9 @@ More info: CannotConvertError -

    +

    CannotConvertError is returned when a field cannot be converted.

    -

    +
    @@ -2170,9 +2170,9 @@ string

    (Appears on:DomainMapping)

    -

    +

    DomainMappingSpec describes the DomainMapping the user wishes to exist.

    -

    +
    @@ -2207,9 +2207,9 @@ Knative Routes, and by Kubernetes Services.

    (Appears on:DomainMapping)

    -

    +

    DomainMappingStatus describes the current state of the DomainMapping.

    -

    +
    @@ -2266,5 +2266,5 @@ knative.dev/pkg/apis/duck/v1.Addressable

    Generated with gen-crd-api-reference-docs -on git commit 813aa6596. +on git commit 35efb3108.

    diff --git a/docs/serving/README.md b/docs/serving/README.md index 0e8fd896962..4407ee5b0ad 100644 --- a/docs/serving/README.md +++ b/docs/serving/README.md @@ -15,7 +15,7 @@ The Knative Serving project provides middleware components that enable: - Rapid deployment of serverless containers. - Autoscaling including scaling pods down to zero. -- Support for multiple networking layers such as Ambassador, Courier, Gloo, Istio, and Kong, for integration into existing environments. +- Support for multiple networking layers such as Ambassador, Contour, Kourier, Gloo, Istio, and Kong, for integration into existing environments. - Point-in-time snapshots of deployed code and configurations. ## Serving resources diff --git a/docs/serving/samples/knative-routing-go/index.md b/docs/serving/samples/knative-routing-go/index.md index a49981520b7..0b09f7299cd 100644 --- a/docs/serving/samples/knative-routing-go/index.md +++ b/docs/serving/samples/knative-routing-go/index.md @@ -266,6 +266,41 @@ The Gateway proxy checks the updated host, and forwards it to `Search` or ![Object model](./images/knative-routing-sample-flow.png) +## Using internal services and `"httpProtocol": "Redirected"` + +Using the above approach, services will be available using two entrypoints into the cluster: +The original ones provided by Knative Serving (`search-service.default.example.com` and `login-service.default.example.com`), +as well as the additional entrypoints `example.com/search` and `example.com/login` +provided by the manually added VirtualService (`entry-route`). + +To make sure your service can only be reached via the manually created +VirtualService, you can add the label `networking.knative.dev/visibility: cluster-local` +to the Knative Service definitions, and route traffic over +`knative-local-gateway.istio-system.svc.cluster.local` with a destination address of an internal service, +instead of the public ingress one at `istio-ingressgateway.istio-system.svc.cluster.local` +with a destination address of an externally available service. + +Using + +``` +kubectl label kservice search-service login-service networking.knative.dev/visibility=cluster-local +``` + +you label the services as an cluster-local services, removing access via `search-service.default.example.com` +and `login-service.default.example.com`. After doing so, your previous routing rule will not be routable anymore. +Running + +``` +kubectl apply --filename docs/serving/samples/knative-routing-go/routing-internal.yaml +``` + +will replace the custom routing rule with one that uses the `knative-local-gateway`, enabling access +via `example.com/search` and `example.com/login` again. + +With these changes, you can also use [the `autoTLS` feature](../../using-auto-tls.md) in combination with the global setting +`"httpProtocol": "Redirected"`, which would otherwise try to redirect the `entry-route` +VirtualService requests from HTTP to HTTPS, failing the request. + ## Clean Up To clean up the sample resources: diff --git a/docs/serving/samples/knative-routing-go/routing-internal.yaml b/docs/serving/samples/knative-routing-go/routing-internal.yaml new file mode 100644 index 00000000000..c283fcbd267 --- /dev/null +++ b/docs/serving/samples/knative-routing-go/routing-internal.yaml @@ -0,0 +1,59 @@ +# Copyright 2018 The Knative Authors +# +# Licensed under the Apache License, Version 2.0 (the "License"); +# you may not use this file except in compliance with the License. +# You may obtain a copy of the License at +# +# https://www.apache.org/licenses/LICENSE-2.0 +# +# Unless required by applicable law or agreed to in writing, software +# distributed under the License is distributed on an "AS IS" BASIS, +# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +# See the License for the specific language governing permissions and +# limitations under the License. + +apiVersion: networking.istio.io/v1alpha3 +kind: VirtualService +metadata: + name: entry-route + namespace: default +spec: + # This is the gateway shared in knative service mesh. + gateways: + - knative-ingress-gateway.knative-serving.svc.cluster.local + # Set host to the domain name that you own. + hosts: + - example.com + http: + - match: + - uri: + prefix: "/search" + rewrite: + # Rewrite the original host header to the host header of Search service + # in order to redirect requests to Search service. + authority: search-service.default.svc.cluster.local + route: + # Basically here we redirect the request to the internal gateway with + # updated header "search-service.default.svc.cluster.local" so the request will + # eventually be directed to Search service. + - destination: + host: knative-local-gateway.istio-system.svc.cluster.local + port: + number: 80 + weight: 100 + - match: + - uri: + prefix: "/login" + rewrite: + # Rewrite the original host header to the host header of Search service + # in order to redirect requests to Search service. + authority: login-service.default.svc.cluster.local + route: + # Basically here we redirect the request to the internal gateway with + # updated header "login-service.default.svc.cluster.local" so the request will + # eventually be directed to Login service. + - destination: + host: knative-local-gateway.istio-system.svc.cluster.local + port: + number: 80 + weight: 100 diff --git a/docs/serving/samples/knative-routing-go/routing.yaml b/docs/serving/samples/knative-routing-go/routing.yaml index f4bbfef6af3..fb4eb5f4afd 100644 --- a/docs/serving/samples/knative-routing-go/routing.yaml +++ b/docs/serving/samples/knative-routing-go/routing.yaml @@ -45,13 +45,13 @@ spec: - uri: prefix: "/login" rewrite: - # Rewrite the original host header to the host header of Search service - # in order to redirect requests to Search service. + # Rewrite the original host header to the host header of Login service + # in order to redirect requests to Login service. authority: login-service.default.example.com route: # Basically here we redirect the request to the cluster entry again with # updated header "login-service.default.example.com" so the request will - # eventually be directed to LOgin service. + # eventually be directed to Login service. - destination: host: istio-ingressgateway.istio-system.svc.cluster.local port: