diff --git a/docs/reference/eventing/eventing-contrib-resources.md b/docs/reference/eventing/eventing-contrib-resources.md index 8a1fb6ccf..aab1f7532 100644 --- a/docs/reference/eventing/eventing-contrib-resources.md +++ b/docs/reference/eventing/eventing-contrib-resources.md @@ -3,6 +3,9 @@
  • sources.eventing.knative.dev/v1alpha1
  • +
  • +messaging.knative.dev/v1alpha1 +
  • sources.eventing.knative.dev/v1alpha1

    @@ -54,7 +57,7 @@ string metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -92,7 +95,7 @@ string awsCredsSecret
    - + Kubernetes core/v1.SecretKeySelector @@ -105,7 +108,7 @@ Kubernetes core/v1.SecretKeySelector sink
    - + Kubernetes core/v1.ObjectReference @@ -179,7 +182,7 @@ string metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -217,36 +220,9 @@ CamelSourceOriginSpec -serviceAccountName
    - -string - - - -(Optional) -

    DEPRECATED: moved inside the specific CamelSourceOriginSpec -ServiceAccountName is the name of the ServiceAccount to use to run this -source.

    - - - - -image
    - -string - - - -(Optional) -

    DEPRECATED: use the context field in CamelSourceOriginSpec -Image is an optional base image used to run the source.

    - - - - sink
    - + Kubernetes core/v1.ObjectReference @@ -307,7 +283,7 @@ string metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -334,7 +310,7 @@ GcpPubSubSourceSpec gcpCredsSecret
    - + Kubernetes core/v1.SecretKeySelector @@ -342,8 +318,8 @@ Kubernetes core/v1.SecretKeySelector

    GcpCredsSecret is the credential to use to poll the GCP PubSub Subscription. It is not used to create or delete the Subscription, only to poll it. The value of the secret entry must be -a service account key in the JSON format (see -https://cloud.google.com/iam/docs/creating-managing-service-account-keys.

    +a service account key in the JSON format +( see https://cloud.google.com/iam/docs/creating-managing-service-account-keys ).

    @@ -374,7 +350,7 @@ unique identifier within the project, not the entire name. E.g. it must be &lsqu sink
    - + Kubernetes core/v1.ObjectReference @@ -388,7 +364,7 @@ Kubernetes core/v1.ObjectReference transformer
    - + Kubernetes core/v1.ObjectReference @@ -461,7 +437,7 @@ string metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -561,7 +537,7 @@ secret token

    sink
    - + Kubernetes core/v1.ObjectReference @@ -647,7 +623,7 @@ string metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -719,7 +695,7 @@ KafkaSourceNetSpec sink
    - + Kubernetes core/v1.ObjectReference @@ -803,7 +779,7 @@ string awsCredsSecret
    - + Kubernetes core/v1.SecretKeySelector @@ -816,7 +792,7 @@ Kubernetes core/v1.SecretKeySelector sink
    - + Kubernetes core/v1.ObjectReference @@ -862,9 +838,7 @@ run the Receive Adapter Deployment.

    Status
    - -github.com/knative/pkg/apis/duck/v1alpha1.Status - +knative.dev/pkg/apis/duck/v1alpha1.Status @@ -980,7 +954,8 @@ CamelSourceOriginComponentSpec -

    Component is a kind of source that directly references a Camel component

    +

    Component is a kind of source that directly references a Camel component +DEPRECATED

    @@ -994,6 +969,17 @@ github.com/apache/camel-k/pkg/apis/camel/v1alpha1.IntegrationSpec

    Integration is a kind of source that contains a Camel K integration

    + + +flow
    + +string + + + +

    Flow is a kind of source that contains a single Camel YAML flow route

    + +

    CamelSourceSpec @@ -1028,36 +1014,9 @@ CamelSourceOriginSpec -serviceAccountName
    - -string - - - -(Optional) -

    DEPRECATED: moved inside the specific CamelSourceOriginSpec -ServiceAccountName is the name of the ServiceAccount to use to run this -source.

    - - - - -image
    - -string - - - -(Optional) -

    DEPRECATED: use the context field in CamelSourceOriginSpec -Image is an optional base image used to run the source.

    - - - - sink
    - + Kubernetes core/v1.ObjectReference @@ -1090,9 +1049,7 @@ Kubernetes core/v1.ObjectReference Status
    - -github.com/knative/pkg/apis/duck/v1alpha1.Status - +knative.dev/pkg/apis/duck/v1alpha1.Status @@ -1139,7 +1096,7 @@ string gcpCredsSecret
    - + Kubernetes core/v1.SecretKeySelector @@ -1147,8 +1104,8 @@ Kubernetes core/v1.SecretKeySelector

    GcpCredsSecret is the credential to use to poll the GCP PubSub Subscription. It is not used to create or delete the Subscription, only to poll it. The value of the secret entry must be -a service account key in the JSON format (see -https://cloud.google.com/iam/docs/creating-managing-service-account-keys).

    +a service account key in the JSON format +( see https://cloud.google.com/iam/docs/creating-managing-service-account-keys ).

    @@ -1179,7 +1136,7 @@ unique identifier within the project, not the entire name. E.g. it must be &lsqu sink
    - + Kubernetes core/v1.ObjectReference @@ -1193,7 +1150,7 @@ Kubernetes core/v1.ObjectReference transformer
    - + Kubernetes core/v1.ObjectReference @@ -1238,9 +1195,7 @@ Adapter Deployment.

    Status
    - -github.com/knative/pkg/apis/duck/v1alpha1.Status - +knative.dev/pkg/apis/duck/v1alpha1.Status @@ -1372,7 +1327,7 @@ secret token

    sink
    - + Kubernetes core/v1.ObjectReference @@ -1430,9 +1385,7 @@ bool Status
    - -github.com/knative/pkg/apis/duck/v1alpha1.Status - +knative.dev/pkg/apis/duck/v1alpha1.Status @@ -1752,7 +1705,7 @@ KafkaSourceNetSpec sink
    - + Kubernetes core/v1.ObjectReference @@ -1810,9 +1763,7 @@ KafkaResourceSpec Status
    - -github.com/knative/pkg/apis/duck/v1alpha1.Status - +knative.dev/pkg/apis/duck/v1alpha1.Status @@ -1912,6 +1863,38 @@ SecretValueFromSource

    (Appears on: +GitHubSourceSpec) +

    +

    +

    SecretValueFromSource represents the source of a secret value

    +

    + + + + + + + + + + + + + +
    FieldDescription
    +secretKeyRef
    + + +Kubernetes core/v1.SecretKeySelector + + +
    +

    The Secret key to select from.

    +
    +

    SecretValueFromSource +

    +

    +(Appears on: KafkaSourceSASLSpec, KafkaSourceTLSSpec)

    @@ -1930,39 +1913,7 @@ SecretValueFromSource secretKeyRef
    - -Kubernetes core/v1.SecretKeySelector - - - - -

    The Secret key to select from.

    - - - - -

    SecretValueFromSource -

    -

    -(Appears on: -GitHubSourceSpec) -

    -

    -

    SecretValueFromSource represents the source of a secret value

    -

    - - - - - - - - - -
    FieldDescription
    -secretKeyRef
    - - + Kubernetes core/v1.SecretKeySelector @@ -1974,7 +1925,246 @@ Kubernetes core/v1.SecretKeySelector

    +

    messaging.knative.dev/v1alpha1

    +

    +

    Package v1alpha1 is the v1alpha1 version of the API.

    +

    +Resource Types: + +

    KafkaChannel +

    +

    +

    KafkaChannel is a resource representing a Kafka Channel.

    +

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

    Spec defines the desired state of the Channel.

    +
    +
    + + + + + + + + + + + + + +
    +numPartitions
    + +int32 + +
    +

    NumPartitions is the number of partitions of a Kafka topic. By default, it is set to 1.

    +
    +replicationFactor
    + +int16 + +
    +

    ReplicationFactor is the replication factor of a Kafka topic. By default, it is set to 1.

    +
    +subscribable
    + +github.com/knative/eventing/pkg/apis/duck/v1alpha1.Subscribable + +
    +

    KafkaChannel conforms to Duck type Subscribable.

    +
    +
    +status
    + + +KafkaChannelStatus + + +
    +(Optional) +

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

    +
    +

    KafkaChannelSpec +

    +

    +(Appears on: +KafkaChannel) +

    +

    +

    KafkaChannelSpec defines the specification for a KafkaChannel.

    +

    + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +numPartitions
    + +int32 + +
    +

    NumPartitions is the number of partitions of a Kafka topic. By default, it is set to 1.

    +
    +replicationFactor
    + +int16 + +
    +

    ReplicationFactor is the replication factor of a Kafka topic. By default, it is set to 1.

    +
    +subscribable
    + +github.com/knative/eventing/pkg/apis/duck/v1alpha1.Subscribable + +
    +

    KafkaChannel conforms to Duck type Subscribable.

    +
    +

    KafkaChannelStatus +

    +

    +(Appears on: +KafkaChannel) +

    +

    +

    KafkaChannelStatus represents the current state of a KafkaChannel.

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

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

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

    +

    KafkaChannel is Addressable. It currently exposes the endpoint as a +fully-qualified DNS name which will distribute traffic over the +provided targets from inside the cluster.

    +

    It generally has the form {channel}.{namespace}.svc.{cluster domain name}

    +
    +SubscribableTypeStatus
    + +github.com/knative/eventing/pkg/apis/duck/v1alpha1.SubscribableTypeStatus + +
    +

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

    +

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

    +
    +

    Generated with gen-crd-api-reference-docs -on git commit 641f98fe. +on git commit 4bda4fca.

    diff --git a/docs/reference/eventing/eventing.md b/docs/reference/eventing/eventing.md index 72e5f5853..36f897a8d 100644 --- a/docs/reference/eventing/eventing.md +++ b/docs/reference/eventing/eventing.md @@ -1,34 +1,32 @@

    Packages:

    -

    duck.knative.dev/v1alpha1

    +

    messaging.knative.dev/v1alpha1

    Package v1alpha1 is the v1alpha1 version of the API.

    Resource Types: -

    Channelable +

    Channel

    -

    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.

    +

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

    @@ -44,712 +42,7 @@ Channelable ObjectReferences and access their subscription and address data. Th string - - - - - - - - - - - - - - - - - - -
    -duck.knative.dev/v1alpha1 - -
    -kind
    -string -
    Channelable
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -ChannelableSpec - - -
    -

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

    -
    -
    - - - - - -
    -SubscribableTypeSpec
    - - -SubscribableTypeSpec - - -
    -

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

    -
    -
    -status
    - - -ChannelableStatus - - -
    -
    -

    SubscribableType -

    -

    -

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

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -apiVersion
    -string
    - -duck.knative.dev/v1alpha1 - -
    -kind
    -string -
    SubscribableType
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - - -SubscribableTypeSpec - - -
    -

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

    -
    -
    - - - - - -
    -subscribable
    - - -Subscribable - - -
    -
    -
    -status
    - - -SubscribableTypeStatus - - -
    -

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

    -
    -

    ChannelableSpec -

    -

    -(Appears on: -Channelable) -

    -

    -

    ChannelableSpec contains Spec of the Channelable object

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -SubscribableTypeSpec
    - - -SubscribableTypeSpec - - -
    -

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

    -
    -

    ChannelableStatus -

    -

    -(Appears on: -Channelable) -

    -

    -

    ChannelableStatus contains the Status of a Channelable object.

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -Status
    - - -github.com/knative/pkg/apis/duck/v1beta1.Status - - -
    -

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

    -

    inherits duck/v1beta1 Status, which currently provides: -* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. -* Conditions - the latest available observations of a resource’s current state.

    -
    -AddressStatus
    - - -github.com/knative/pkg/apis/duck/v1alpha1.AddressStatus - - -
    -

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

    -

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

    -
    -SubscribableTypeStatus
    - - -SubscribableTypeStatus - - -
    -

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

    -

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

    -
    -

    Subscribable -

    -

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

    -

    -

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

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -subscribers
    - - -[]SubscriberSpec - - -
    -

    This is the list of subscriptions for this subscribable.

    -
    -

    SubscribableStatus -

    -

    -(Appears on: -SubscribableTypeStatus) -

    -

    -

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

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -subscribers
    - - -[]SubscriberStatus - - -
    -

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

    -
    -

    SubscribableTypeSpec -

    -

    -(Appears on: -SubscribableType, -ChannelableSpec) -

    -

    -

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

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -subscribable
    - - -Subscribable - - -
    -
    -

    SubscribableTypeStatus -

    -

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

    -

    -

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

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -subscribablestatus
    - - -SubscribableStatus - - -
    -
    -

    SubscriberSpec -

    -

    -(Appears on: -Subscribable) -

    -

    -

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

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -ref
    - - -Kubernetes core/v1.ObjectReference - - -
    -(Optional) -

    Deprecated: use UID.

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

    UID is used to understand the origin of the subscriber.

    -
    -generation
    - -int64 - -
    -(Optional) -

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

    -
    -subscriberURI
    - -string - -
    -(Optional) -
    -replyURI
    - -string - -
    -(Optional) -
    -

    SubscriberStatus -

    -

    -(Appears on: -SubscribableStatus) -

    -

    -

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

    -

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

    UID is used to understand the origin of the subscriber.

    -
    -observedGeneration
    - -int64 - -
    -(Optional) -

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

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

    Status of the subscriber.

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

    A human readable message indicating details of Ready status.

    -
    -
    -

    eventing.knative.dev/v1alpha1

    -

    -

    Package v1alpha1 is the v1alpha1 version of the API.

    -

    -Resource Types: - -

    Broker -

    -

    -

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

    -

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

    Spec defines the desired state of the Broker.

    -
    -
    - - - - - - - - - -
    -channelTemplate
    - - -ChannelSpec - - -
    -(Optional) -

    DeprecatedChannelTemplate, if specified will be used to create all the Channels used internally by the -Broker. Only Provisioner and Arguments may be specified. If left unspecified, the default -Channel for the namespace will be used.

    -
    -channelTemplateSpec
    - - -ChannelTemplateSpec - - -
    -

    ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the -Broker.

    -
    -
    -status
    - - -BrokerStatus - - -
    -(Optional) -

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

    -
    -

    Channel -

    -

    -

    Channel is an abstract resource that implements the Addressable contract. -The Provisioner provisions infrastructure to accepts events and -deliver to Subscriptions.

    -

    - - - - - - - - - - - @@ -764,7 +57,7 @@ string
    FieldDescription
    -apiVersion
    -string
    - -eventing.knative.dev/v1alpha1 +messaging.knative.dev/v1alpha1
    metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -779,7 +72,7 @@ Refer to the Kubernetes API documentation for the fields of the
    spec
    - + ChannelSpec @@ -791,43 +84,16 @@ ChannelSpec - - - - - - - - @@ -850,7 +116,7 @@ Subscribable
    -generation
    +channelTemplate
    -int64 - -
    -(Optional) -

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

    -

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

    -
    -provisioner
    - - -Kubernetes core/v1.ObjectReference + +ChannelTemplateSpec
    -

    Provisioner defines the name of the Provisioner backing this channel.

    -
    -arguments
    - -k8s.io/apimachinery/pkg/runtime.RawExtension - -
    -(Optional) -

    Arguments defines the arguments to pass to the Provisioner which -provisions this Channel.

    +

    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.

    status
    - + ChannelStatus @@ -863,1610 +129,6 @@ date.

    -

    ClusterChannelProvisioner -

    -

    -

    ClusterChannelProvisioner encapsulates a provisioning strategy for the -backing resources required to realize a particular resource type.

    -

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

    Spec defines the Types provisioned by this Provisioner.

    -
    -
    - - - - - -
    -generation
    - -int64 - -
    -(Optional) -

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

    -

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

    -
    -
    -status
    - - -ClusterChannelProvisionerStatus - - -
    -(Optional) -

    Status is the current status of the Provisioner.

    -
    -

    EventType -

    -

    -

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

    Spec defines the desired state of the EventType.

    -
    -
    - - - - - - - - - - - - - - - - - - - - - -
    -type
    - -string - -
    -

    Type represents the CloudEvents type. It is authoritative.

    -
    -source
    - -string - -
    -

    Source is a URI, it represents the CloudEvents source.

    -
    -schema
    - -string - -
    -(Optional) -

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

    -
    -broker
    - -string - -
    -

    Broker refers to the Broker that can provide the EventType.

    -
    -description
    - -string - -
    -(Optional) -

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

    -
    -
    -status
    - - -EventTypeStatus - - -
    -(Optional) -

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

    -
    -

    Subscription -

    -

    -

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

    -

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

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

    -

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

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

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

    -
    -subscriber
    - - -SubscriberSpec - - -
    -(Optional) -

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

    -
    -reply
    - - -ReplyStrategy - - -
    -(Optional) -

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

    -
    -
    -status
    - - -SubscriptionStatus - - -
    -
    -

    Trigger -

    -

    -

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

    -

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

    Spec defines the desired state of the Trigger.

    -
    -
    - - - - - - - - - - - - - -
    -broker
    - -string - -
    -

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

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

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

    -
    -subscriber
    - - -SubscriberSpec - - -
    -

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

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

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

    -
    -

    BrokerSpec -

    -

    -(Appears on: -Broker) -

    -

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -channelTemplate
    - - -ChannelSpec - - -
    -(Optional) -

    DeprecatedChannelTemplate, if specified will be used to create all the Channels used internally by the -Broker. Only Provisioner and Arguments may be specified. If left unspecified, the default -Channel for the namespace will be used.

    -
    -channelTemplateSpec
    - - -ChannelTemplateSpec - - -
    -

    ChannelTemplate specifies which Channel CRD to use to create all the Channels used internally by the -Broker.

    -
    -

    BrokerStatus -

    -

    -(Appears on: -Broker) -

    -

    -

    BrokerStatus represents the current state of a Broker.

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -Status
    - - -github.com/knative/pkg/apis/duck/v1beta1.Status - - -
    -

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

    -

    inherits duck/v1beta1 Status, which currently provides: -* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. -* Conditions - the latest available observations of a resource’s current state.

    -
    -address
    - - -github.com/knative/pkg/apis/duck/v1alpha1.Addressable - - -
    -

    Broker is Addressable. It currently exposes the endpoint as a -fully-qualified DNS name which will distribute traffic over the -provided targets from inside the cluster.

    -

    It generally has the form {broker}-router.{namespace}.svc.{cluster domain name}

    -
    -triggerChannel
    - - -Kubernetes core/v1.ObjectReference - - -
    -

    TriggerChannel is an objectref to the object for the TriggerChannel

    -
    -IngressChannel
    - - -Kubernetes core/v1.ObjectReference - - -
    -

    IngressChannel is an objectref to the object for the IngressChannel

    -
    -

    ChannelProvisionerDefaulter -

    -

    -

    ChannelProvisionerDefaulter sets the default Provisioner and Arguments on Channels that do not -specify any Provisioner.

    -

    -

    ChannelSpec -

    -

    -(Appears on: -Channel, -BrokerSpec) -

    -

    -

    ChannelSpec specifies the Provisioner backing a channel and the configuration -arguments for a Channel.

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -generation
    - -int64 - -
    -(Optional) -

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

    -

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

    -
    -provisioner
    - - -Kubernetes core/v1.ObjectReference - - -
    -

    Provisioner defines the name of the Provisioner backing this channel.

    -
    -arguments
    - -k8s.io/apimachinery/pkg/runtime.RawExtension - -
    -(Optional) -

    Arguments defines the arguments to pass to the Provisioner which -provisions this Channel.

    -
    -subscribable
    - - -Subscribable - - -
    -

    Channel conforms to Duck type Subscribable.

    -
    -

    ChannelStatus -

    -

    -(Appears on: -Channel) -

    -

    -

    ChannelStatus represents the current state of a Channel.

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -Status
    - - -github.com/knative/pkg/apis/duck/v1beta1.Status - - -
    -

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

    -

    inherits duck/v1beta1 Status, which currently provides: -* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. -* Conditions - the latest available observations of a resource’s current state.

    -
    -address
    - - -github.com/knative/pkg/apis/duck/v1alpha1.Addressable - - -
    -

    Channel is Addressable. It currently exposes the endpoint as a -fully-qualified DNS name which will distribute traffic over the -provided targets from inside the cluster.

    -

    It generally has the form {channel}.{namespace}.svc.{cluster domain name}

    -
    -internal
    - -k8s.io/apimachinery/pkg/runtime.RawExtension - -
    -(Optional) -

    Internal is status unique to each ClusterChannelProvisioner.

    -
    -SubscribableTypeStatus
    - - -SubscribableTypeStatus - - -
    -

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

    -
    -

    ChannelTemplateSpec -

    -

    -(Appears on: -BrokerSpec) -

    -

    -

    This should be duck so that Broker can also use this

    -

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

    -
    -
    - - - - - - - - - -
    -Raw
    - -[]byte - -
    -

    Raw is the underlying serialization of this object.

    -

    TODO: Determine how to detect ContentType and ContentEncoding of ‘Raw’ data.

    -
    --
    - -k8s.io/apimachinery/pkg/runtime.Object - -
    -

    Object can hold a representation of this extension - useful for working with versioned -structs.

    -
    -
    -

    ChannelTemplateSpecInternal -

    -

    -

    Internal version of ChannelTemplateSpec that includes ObjectMeta so that -we can easily create new Channels off of it.

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -metadata
    - - -Kubernetes meta/v1.ObjectMeta - - -
    -(Optional) -Refer to the Kubernetes API documentation for the fields of the -metadata field. -
    -spec
    - -k8s.io/apimachinery/pkg/runtime.RawExtension - -
    -(Optional) -

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

    -
    -
    - - - - - - - - - -
    -Raw
    - -[]byte - -
    -

    Raw is the underlying serialization of this object.

    -

    TODO: Determine how to detect ContentType and ContentEncoding of ‘Raw’ data.

    -
    --
    - -k8s.io/apimachinery/pkg/runtime.Object - -
    -

    Object can hold a representation of this extension - useful for working with versioned -structs.

    -
    -
    -

    ClusterChannelProvisionerSpec -

    -

    -(Appears on: -ClusterChannelProvisioner) -

    -

    -

    ClusterChannelProvisionerSpec is the spec for a ClusterChannelProvisioner resource.

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -generation
    - -int64 - -
    -(Optional) -

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

    -

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

    -
    -

    ClusterChannelProvisionerStatus -

    -

    -(Appears on: -ClusterChannelProvisioner) -

    -

    -

    ClusterChannelProvisionerStatus is the status for a ClusterChannelProvisioner resource

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -Status
    - - -github.com/knative/pkg/apis/duck/v1beta1.Status - - -
    -

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

    -

    inherits duck/v1beta1 Status, which currently provides: -* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. -* Conditions - the latest available observations of a resource’s current state.

    -
    -

    EventTypeSpec -

    -

    -(Appears on: -EventType) -

    -

    -

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

    Type represents the CloudEvents type. It is authoritative.

    -
    -source
    - -string - -
    -

    Source is a URI, it represents the CloudEvents source.

    -
    -schema
    - -string - -
    -(Optional) -

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

    -
    -broker
    - -string - -
    -

    Broker refers to the Broker that can provide the EventType.

    -
    -description
    - -string - -
    -(Optional) -

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

    -
    -

    EventTypeStatus -

    -

    -(Appears on: -EventType) -

    -

    -

    EventTypeStatus represents the current state of a EventType.

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -Status
    - - -github.com/knative/pkg/apis/duck/v1beta1.Status - - -
    -

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

    -

    inherits duck/v1beta1 Status, which currently provides: -* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. -* Conditions - the latest available observations of a resource’s current state.

    -
    -

    HasSpec -

    -

    -

    -

    ReplyStrategy -

    -

    -(Appears on: -SubscriptionSpec) -

    -

    -

    ReplyStrategy specifies the handling of the SubscriberSpec’s returned replies. -If no SubscriberSpec is specified, the identity function is assumed.

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -channel
    - - -Kubernetes core/v1.ObjectReference - - -
    -(Optional) -

    You can specify only the following fields of the ObjectReference: -- Kind -- APIVersion -- Name -The resource pointed by this ObjectReference must meet the Addressable contract -with a reference to the Addressable duck type. If the resource does not meet this contract, -it will be reflected in the Subscription’s status.

    -
    -

    SubscriberSpec -

    -

    -(Appears on: -SequenceSpec, -SubscriptionSpec, -TriggerSpec) -

    -

    -

    SubscriberSpec specifies the reference to an object that’s expected to -provide the resolved target of the action. -Currently we inspect the objects Status and see if there’s a predefined -Status field that we will then use to dispatch events to be processed by -the target. Currently must resolve to a k8s service. -Note that in the future we should try to utilize subresources (/resolve ?) to -make this cleaner, but CRDs do not support subresources yet, so we need -to rely on a specified Status field today. By relying on this behaviour -we can utilize a dynamic client instead of having to understand all -kinds of different types of objects. As long as they adhere to this -particular contract, they can be used as a Target.

    -

    This ensures that we can support external targets and for ease of use -we also allow for an URI to be specified. -There of course is also a requirement for the resolved SubscriberSpec to -behave properly at the data plane level. -TODO: Add a pointer to a real spec for this. -For now, this means: Receive an event payload, and respond with one of: -success and an optional response event, or failure. -Delivery failures may be retried by the channel

    -

    - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -ref
    - - -Kubernetes core/v1.ObjectReference - - -
    -(Optional) -

    Reference to an object that will be used to find the target -endpoint, which should implement the Addressable duck type. -For example, this could be a reference to a Route resource -or a Knative Service resource. -TODO: Specify the required fields the target object must -have in the status. -You can specify only the following fields of the ObjectReference: -- Kind -- APIVersion -- Name

    -
    -dnsName
    - -string - -
    -(Optional) -

    Deprecated: Use URI instead. -Reference to a ‘known’ endpoint where no resolving is done. -http://k8s-service for example -http://myexternalhandler.example.com/foo/bar

    -
    -uri
    - -string - -
    -(Optional) -

    Reference to a ‘known’ endpoint where no resolving is done. -http://k8s-service for example -http://myexternalhandler.example.com/foo/bar

    -
    -

    SubscriptionSpec -

    -

    -(Appears on: -Subscription) -

    -

    -

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

    -

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

    -

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    FieldDescription
    -generation
    - -int64 - -
    -(Optional) -

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

    -

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

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

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

    -
    -subscriber
    - - -SubscriberSpec - - -
    -(Optional) -

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

    -
    -reply
    - - -ReplyStrategy - - -
    -(Optional) -

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

    -
    -

    SubscriptionStatus -

    -

    -(Appears on: -Subscription) -

    -

    -

    SubscriptionStatus (computed) for a subscription

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -Status
    - - -github.com/knative/pkg/apis/duck/v1beta1.Status - - -
    -

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

    -

    inherits duck/v1beta1 Status, which currently provides: -* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. -* Conditions - the latest available observations of a resource’s current state.

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

    SubscriberURI is the fully resolved URI for spec.subscriber.

    -
    -replyURI
    - -string - -
    -

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

    -
    -

    TriggerFilter -

    -

    -(Appears on: -TriggerSpec) -

    -

    -

    - - - - - - - - - - - - - -
    FieldDescription
    -sourceAndType
    - - -TriggerFilterSourceAndType - - -
    -
    -

    TriggerFilterSourceAndType -

    -

    -(Appears on: -TriggerFilter) -

    -

    -

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

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -type
    - -string - -
    -
    -source
    - -string - -
    -
    -

    TriggerSpec -

    -

    -(Appears on: -Trigger) -

    -

    -

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

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

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

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

    -
    -subscriber
    - - -SubscriberSpec - - -
    -

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

    -
    -

    TriggerStatus -

    -

    -(Appears on: -Trigger) -

    -

    -

    TriggerStatus represents the current state of a Trigger.

    -

    - - - - - - - - - - - - - - - - - -
    FieldDescription
    -Status
    - - -github.com/knative/pkg/apis/duck/v1beta1.Status - - -
    -

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

    -

    inherits duck/v1beta1 Status, which currently provides: -* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. -* Conditions - the latest available observations of a resource’s current state.

    -
    -subscriberURI
    - -string - -
    -

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

    -
    -
    -

    messaging.knative.dev/v1alpha1

    -

    -

    Package v1alpha1 is the v1alpha1 version of the API.

    -

    -Resource Types: -

    InMemoryChannel

    @@ -2501,7 +163,7 @@ string

    metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -2559,14 +221,15 @@ date.

    -

    ChannelTemplateSpec +

    ChannelSpec

    (Appears on: -SequenceSpec) +Channel)

    -

    This should be duck so that Broker can also use this

    +

    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.

    @@ -2578,28 +241,119 @@ date.

    + + + +
    -spec
    +channelTemplate
    -k8s.io/apimachinery/pkg/runtime.RawExtension + +ChannelTemplateSpec +
    -(Optional) -

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

    -
    -
    - -
    +

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

    +
    +subscribable
    + + +Subscribable + + +
    +

    Channel conforms to Duck type Subscribable.

    -

    ChannelTemplateSpecInternal +

    ChannelStatus

    -

    Internal version of ChannelTemplateSpec that includes ObjectMeta so that -we can easily create new Channels off of it.

    +(Appears on: +Channel) +

    +

    +

    ChannelStatus represents the current state of a Channel.

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

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

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

    +

    Channel is Addressable. It currently exposes the endpoint as a +fully-qualified DNS name which will distribute traffic over the +provided targets from inside the cluster.

    +

    It generally has the form {channel}.{namespace}.svc.{cluster domain name}

    +
    +SubscribableTypeStatus
    + + +SubscribableTypeStatus + + +
    +

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

    +

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

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

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

    +
    +

    Choice +

    +

    +

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

    @@ -2613,7 +367,7 @@ we can easily create new Channels off of it.

    +
    metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -2628,19 +382,441 @@ Refer to the Kubernetes API documentation for the fields of the
    spec
    -k8s.io/apimachinery/pkg/runtime.RawExtension + +ChoiceSpec + + +
    +

    Spec defines the desired state of the Choice.

    +
    +
    + + + + + + + + + + + + +
    +cases
    + + +[]ChoiceCase + + +
    +

    Cases is the list of Filter/Subscribers pairs. Filters are evaluated in the order +provided, until one pass (returns true)

    +
    +channelTemplate
    + + +ChannelTemplateSpec +
    (Optional) -

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

    -
    -
    - +

    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
    + + +Kubernetes core/v1.ObjectReference + + +
    +(Optional) +

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

    +

    You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name

    +

    The resource pointed by this ObjectReference must meet the Addressable contract +with a reference to the Addressable duck type. If the resource does not meet this contract, +it will be reflected in the Subscription’s status.

    +
    +status
    + + +ChoiceStatus + + +
    +(Optional) +

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

    +
    +

    ChoiceCase +

    +

    +(Appears on: +ChoiceSpec) +

    +

    +

    + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +filter
    + + +SubscriberSpec + + +
    +

    Filter is the expression guarding the branch/case

    +
    +subscriber
    + + +SubscriberSpec + + +
    +

    Subscriber receiving the event when the filter passes

    +
    +reply
    + + +Kubernetes core/v1.ObjectReference + + +
    +(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 Choice Reply

    +

    You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name

    +

    The resource pointed by this ObjectReference must meet the Addressable contract +with a reference to the Addressable duck type. If the resource does not meet this contract, +it will be reflected in the Subscription’s status.

    +
    +

    ChoiceCaseStatus +

    +

    +(Appears on: +ChoiceStatus) +

    +

    +

    ChoiceCaseStatus represents the current state of a Choice case

    +

    + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +filterSubscriptionStatus
    + + +ChoiceSubscriptionStatus + + +
    +

    FilterSubscriptionStatus corresponds to the filter subscription status.

    +
    +filterChannelStatus
    + + +ChoiceChannelStatus + + +
    +

    FilterChannelStatus corresponds to the filter channel status.

    +
    +subscriberSubscriptionStatus
    + + +ChoiceSubscriptionStatus + + +
    +

    SubscriptionStatus corresponds to the subscriber subscription status.

    +
    +

    ChoiceChannelStatus +

    +

    +(Appears on: +ChoiceCaseStatus, +ChoiceStatus) +

    +

    +

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

    +
    +

    ChoiceSpec +

    +

    +(Appears on: +Choice) +

    +

    +

    + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +cases
    + + +[]ChoiceCase + + +
    +

    Cases is the list of Filter/Subscribers pairs. Filters are evaluated in the order +provided, until one pass (returns true)

    +
    +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
    + + +Kubernetes core/v1.ObjectReference + + +
    +(Optional) +

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

    +

    You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name

    +

    The resource pointed by this ObjectReference must meet the Addressable contract +with a reference to the Addressable duck type. If the resource does not meet this contract, +it will be reflected in the Subscription’s status.

    +
    +

    ChoiceStatus +

    +

    +(Appears on: +Choice) +

    +

    +

    ChoiceStatus represents the current state of a Choice.

    +

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

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

    +

    inherits duck/v1alpha1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

    +
    +ingressChannelStatus
    + + +ChoiceChannelStatus + + +
    +

    IngressChannelStatus corresponds to the ingress channel status.

    +
    +caseStatuses
    + + +[]ChoiceCaseStatus + + +
    +

    CaseStatuses is an array of corresponding to cases status. +Matches the Spec.Cases array in the order.

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

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

    +

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

    +
    +

    ChoiceSubscriptionStatus +

    +

    +(Appears on: +ChoiceCaseStatus) +

    +

    +

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

    +

    InMemoryChannelSpec @@ -2698,9 +874,7 @@ Subscribable

    Status
    - -github.com/knative/pkg/apis/duck/v1beta1.Status - +knative.dev/pkg/apis/duck/v1beta1.Status
    @@ -2716,9 +890,7 @@ github.com/knative/pkg/apis/duck/v1beta1.Status AddressStatus
    - -github.com/knative/pkg/apis/duck/v1alpha1.AddressStatus - +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus
    @@ -2767,7 +939,7 @@ series through Channels and Subscriptions.

    metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -2810,20 +982,22 @@ provided.

    channelTemplate
    - + ChannelTemplateSpec
    -

    ChannelTemplate specifies which Channel CRD to use

    +(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
    - + Kubernetes core/v1.ObjectReference @@ -2880,7 +1054,7 @@ date.

    channel
    - + Kubernetes core/v1.ObjectReference @@ -2893,7 +1067,7 @@ Kubernetes core/v1.ObjectReference
    ready
    -github.com/knative/pkg/apis.Condition +knative.dev/pkg/apis.Condition
    @@ -2936,20 +1110,22 @@ provided.

    channelTemplate
    - + ChannelTemplateSpec
    -

    ChannelTemplate specifies which Channel CRD to use

    +(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
    - + Kubernetes core/v1.ObjectReference @@ -2989,9 +1165,7 @@ it will be reflected in the Subscription’s status.

    Status
    - -github.com/knative/pkg/apis/duck/v1beta1.Status - +knative.dev/pkg/apis/duck/v1beta1.Status
    @@ -3005,7 +1179,7 @@ github.com/knative/pkg/apis/duck/v1beta1.Status
    -SubscriptionStatuses
    +subscriptionStatuses
    []SequenceSubscriptionStatus @@ -3019,7 +1193,7 @@ Matches the Spec.Steps array in the order.

    -ChannelStatuses
    +channelStatuses
    []SequenceChannelStatus @@ -3035,9 +1209,7 @@ Matches the Spec.Steps array in the order.

    AddressStatus
    - -github.com/knative/pkg/apis/duck/v1alpha1.AddressStatus - +knative.dev/pkg/apis/duck/v1alpha1.AddressStatus
    @@ -3071,7 +1243,7 @@ It generally has the form {channel}.{namespace}.svc.{cluster domain name}

    subscription
    - + Kubernetes core/v1.ObjectReference @@ -3084,7 +1256,7 @@ Kubernetes core/v1.ObjectReference
    ready
    -github.com/knative/pkg/apis.Condition +knative.dev/pkg/apis.Condition
    @@ -3140,7 +1312,7 @@ string metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -3193,7 +1365,7 @@ source.

    sink
    - + Kubernetes core/v1.ObjectReference @@ -3267,7 +1439,7 @@ string
    metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -3294,7 +1466,7 @@ ContainerSourceSpec
    template
    - + Kubernetes core/v1.PodTemplateSpec @@ -3334,7 +1506,7 @@ When Template is set, this field is ignored.

    env
    - + []Kubernetes core/v1.EnvVar @@ -3366,7 +1538,7 @@ When Template is set, this field is ignored.

    sink
    - + Kubernetes core/v1.ObjectReference @@ -3427,7 +1599,7 @@ string
    metadata
    - + Kubernetes meta/v1.ObjectMeta @@ -3476,7 +1648,7 @@ string
    sink
    - + Kubernetes core/v1.ObjectReference @@ -3628,7 +1800,7 @@ source.

    sink
    - + Kubernetes core/v1.ObjectReference @@ -3674,9 +1846,7 @@ string
    Status
    - -github.com/knative/pkg/apis/duck/v1beta1.Status - +knative.dev/pkg/apis/duck/v1beta1.Status
    @@ -3723,7 +1893,7 @@ string template
    - + Kubernetes core/v1.PodTemplateSpec @@ -3763,7 +1933,7 @@ When Template is set, this field is ignored.

    env
    - + []Kubernetes core/v1.EnvVar @@ -3795,7 +1965,7 @@ When Template is set, this field is ignored.

    sink
    - + Kubernetes core/v1.ObjectReference @@ -3828,9 +1998,7 @@ Kubernetes core/v1.ObjectReference
    Status
    - -github.com/knative/pkg/apis/duck/v1beta1.Status - +knative.dev/pkg/apis/duck/v1beta1.Status
    @@ -4017,7 +2185,7 @@ string sink
    - + Kubernetes core/v1.ObjectReference @@ -4075,9 +2243,7 @@ CronJobResourceSpec
    Status
    - -github.com/knative/pkg/apis/duck/v1beta1.Status - +knative.dev/pkg/apis/duck/v1beta1.Status
    @@ -4104,7 +2270,2482 @@ string

    +

    duck.knative.dev/v1alpha1

    +

    +

    Package v1alpha1 is the v1alpha1 version of the API.

    +

    +Resource Types: + +

    Channelable +

    +

    +

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

    +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +apiVersion
    +string
    + +duck.knative.dev/v1alpha1 + +
    +kind
    +string +
    Channelable
    +metadata
    + + +Kubernetes meta/v1.ObjectMeta + + +
    +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
    +spec
    + + +ChannelableSpec + + +
    +

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

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

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

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

    Resource +

    +

    +

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

    +

    + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +apiVersion
    +string
    + +duck.knative.dev/v1alpha1 + +
    +kind
    +string +
    Resource
    +metadata
    + + +Kubernetes meta/v1.ObjectMeta + + +
    +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
    +

    SubscribableType +

    +

    +

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

    +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +apiVersion
    +string
    + +duck.knative.dev/v1alpha1 + +
    +kind
    +string +
    SubscribableType
    +metadata
    + + +Kubernetes meta/v1.ObjectMeta + + +
    +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
    +spec
    + + +SubscribableTypeSpec + + +
    +

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

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

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

    +
    +

    ChannelDefaulter +

    +

    +

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

    +

    +

    ChannelTemplateSpec +

    +

    +(Appears on: +BrokerSpec, +ChannelSpec, +ChoiceSpec, +SequenceSpec) +

    +

    +

    + + + + + + + + + + + + + +
    FieldDescription
    +spec
    + +k8s.io/apimachinery/pkg/runtime.RawExtension + +
    +(Optional) +

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

    +
    +
    + +
    +
    +

    ChannelTemplateSpecInternal +

    +

    +

    ChannelTemplateSpecInternal is an internal only version that includes ObjectMeta so that +we can easily create new Channels off of it.

    +

    + + + + + + + + + + + + + + + + + +
    FieldDescription
    +metadata
    + + +Kubernetes meta/v1.ObjectMeta + + +
    +(Optional) +Refer to the Kubernetes API documentation for the fields of the +metadata field. +
    +spec
    + +k8s.io/apimachinery/pkg/runtime.RawExtension + +
    +(Optional) +

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

    +
    +
    + +
    +
    +

    ChannelableSpec +

    +

    +(Appears on: +Channelable) +

    +

    +

    ChannelableSpec contains Spec of the Channelable object

    +

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

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

    +
    +

    ChannelableStatus +

    +

    +(Appears on: +Channelable) +

    +

    +

    ChannelableStatus contains the Status of a Channelable object.

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

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

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

    +

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

    +
    +SubscribableTypeStatus
    + + +SubscribableTypeStatus + + +
    +

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

    +

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

    +
    +

    Subscribable +

    +

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

    +

    +

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

    +

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

    This is the list of subscriptions for this subscribable.

    +
    +

    SubscribableStatus +

    +

    +(Appears on: +SubscribableTypeStatus) +

    +

    +

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

    +

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

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

    +
    +

    SubscribableTypeSpec +

    +

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

    +

    +

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

    +

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

    SubscribableTypeStatus +

    +

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

    +

    +

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

    +

    + + + + + + + + + + + + + +
    FieldDescription
    +subscribablestatus
    + + +SubscribableStatus + + +
    +
    +

    SubscriberSpec +

    +

    +(Appears on: +Subscribable) +

    +

    +

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

    +

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +ref
    + + +Kubernetes core/v1.ObjectReference + + +
    +(Optional) +

    Deprecated: use UID.

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

    UID is used to understand the origin of the subscriber.

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

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

    +
    +subscriberURI
    + +string + +
    +(Optional) +
    +replyURI
    + +string + +
    +(Optional) +
    +

    SubscriberStatus +

    +

    +(Appears on: +SubscribableStatus) +

    +

    +

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

    +

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

    UID is used to understand the origin of the subscriber.

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

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

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

    Status of the subscriber.

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

    A human readable message indicating details of Ready status.

    +
    +
    +

    eventing.knative.dev/v1alpha1

    +

    +

    Package v1alpha1 is the v1alpha1 version of the API.

    +

    +Resource Types: + +

    Broker +

    +

    +

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

    +

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

    Spec defines the desired state of the Broker.

    +
    +
    + + + + + + + + + +
    +channelTemplate
    + + +ChannelSpec + + +
    +(Optional) +

    DeprecatedChannelTemplate, if specified will be used to create all the Channels used internally by the +Broker. Only Provisioner and Arguments may be specified. If left unspecified, the default +Channel CRD for the namespace will be used using the channelTemplateSpec attribute.

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

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

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

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

    +
    +

    Channel +

    +

    +

    Channel is an abstract resource that implements the Addressable contract. +The Provisioner provisions infrastructure to accepts events and +deliver to Subscriptions.

    +

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

    Spec defines the desired state of the Channel.

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

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

    +

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

    +
    +provisioner
    + + +Kubernetes core/v1.ObjectReference + + +
    +

    Provisioner defines the name of the Provisioner backing this channel.

    +
    +arguments
    + +k8s.io/apimachinery/pkg/runtime.RawExtension + +
    +(Optional) +

    Arguments defines the arguments to pass to the Provisioner which +provisions this Channel.

    +
    +subscribable
    + + +Subscribable + + +
    +

    Channel conforms to Duck type Subscribable.

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

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

    +
    +

    ClusterChannelProvisioner +

    +

    +

    ClusterChannelProvisioner encapsulates a provisioning strategy for the +backing resources required to realize a particular resource type.

    +

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

    Spec defines the Types provisioned by this Provisioner.

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

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

    +

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

    +
    +
    +status
    + + +ClusterChannelProvisionerStatus + + +
    +(Optional) +

    Status is the current status of the Provisioner.

    +
    +

    EventType +

    +

    +

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

    Spec defines the desired state of the EventType.

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

    Type represents the CloudEvents type. It is authoritative.

    +
    +source
    + +string + +
    +

    Source is a URI, it represents the CloudEvents source.

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

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

    +
    +broker
    + +string + +
    +

    Broker refers to the Broker that can provide the EventType.

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

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

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

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

    +
    +

    Subscription +

    +

    +

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

    +

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

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

    +

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

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

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

    +
    +subscriber
    + + +SubscriberSpec + + +
    +(Optional) +

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

    +
    +reply
    + + +ReplyStrategy + + +
    +(Optional) +

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

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

    Trigger +

    +

    +

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

    +

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

    Spec defines the desired state of the Trigger.

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

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

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

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

    +
    +subscriber
    + + +SubscriberSpec + + +
    +

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

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

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

    +
    +

    BrokerSpec +

    +

    +(Appears on: +Broker) +

    +

    +

    + + + + + + + + + + + + + + + + + +
    FieldDescription
    +channelTemplate
    + + +ChannelSpec + + +
    +(Optional) +

    DeprecatedChannelTemplate, if specified will be used to create all the Channels used internally by the +Broker. Only Provisioner and Arguments may be specified. If left unspecified, the default +Channel CRD for the namespace will be used using the channelTemplateSpec attribute.

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

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

    +
    +

    BrokerStatus +

    +

    +(Appears on: +Broker) +

    +

    +

    BrokerStatus represents the current state of a Broker.

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

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

    Broker is Addressable. It currently exposes the endpoint as a +fully-qualified DNS name which will distribute traffic over the +provided targets from inside the cluster.

    +

    It generally has the form {broker}-router.{namespace}.svc.{cluster domain name}

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

    TriggerChannel is an objectref to the object for the TriggerChannel

    +
    +IngressChannel
    + + +Kubernetes core/v1.ObjectReference + + +
    +

    IngressChannel is an objectref to the object for the IngressChannel

    +
    +

    ChannelProvisionerDefaulter +

    +

    +

    ChannelProvisionerDefaulter sets the default Provisioner and Arguments on Channels that do not +specify any Provisioner.

    +

    +

    ChannelSpec +

    +

    +(Appears on: +Channel, +BrokerSpec) +

    +

    +

    ChannelSpec specifies the Provisioner backing a channel and the configuration +arguments for a Channel.

    +

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

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

    +

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

    +
    +provisioner
    + + +Kubernetes core/v1.ObjectReference + + +
    +

    Provisioner defines the name of the Provisioner backing this channel.

    +
    +arguments
    + +k8s.io/apimachinery/pkg/runtime.RawExtension + +
    +(Optional) +

    Arguments defines the arguments to pass to the Provisioner which +provisions this Channel.

    +
    +subscribable
    + + +Subscribable + + +
    +

    Channel conforms to Duck type Subscribable.

    +
    +

    ChannelStatus +

    +

    +(Appears on: +Channel) +

    +

    +

    ChannelStatus represents the current state of a Channel.

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

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

    Channel is Addressable. It currently exposes the endpoint as a +fully-qualified DNS name which will distribute traffic over the +provided targets from inside the cluster.

    +

    It generally has the form {channel}.{namespace}.svc.{cluster domain name}

    +
    +internal
    + +k8s.io/apimachinery/pkg/runtime.RawExtension + +
    +(Optional) +

    Internal is status unique to each ClusterChannelProvisioner.

    +
    +SubscribableTypeStatus
    + + +SubscribableTypeStatus + + +
    +

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

    +
    +

    ClusterChannelProvisionerSpec +

    +

    +(Appears on: +ClusterChannelProvisioner) +

    +

    +

    ClusterChannelProvisionerSpec is the spec for a ClusterChannelProvisioner resource.

    +

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

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

    +

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

    +
    +

    ClusterChannelProvisionerStatus +

    +

    +(Appears on: +ClusterChannelProvisioner) +

    +

    +

    ClusterChannelProvisionerStatus is the status for a ClusterChannelProvisioner resource

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

    +
    +

    EventTypeSpec +

    +

    +(Appears on: +EventType) +

    +

    +

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

    Type represents the CloudEvents type. It is authoritative.

    +
    +source
    + +string + +
    +

    Source is a URI, it represents the CloudEvents source.

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

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

    +
    +broker
    + +string + +
    +

    Broker refers to the Broker that can provide the EventType.

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

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

    +
    +

    EventTypeStatus +

    +

    +(Appears on: +EventType) +

    +

    +

    EventTypeStatus represents the current state of a EventType.

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

    +
    +

    HasSpec +

    +

    +

    +

    ReplyStrategy +

    +

    +(Appears on: +SubscriptionSpec) +

    +

    +

    ReplyStrategy specifies the handling of the SubscriberSpec’s returned replies. +If no SubscriberSpec is specified, the identity function is assumed.

    +

    + + + + + + + + + + + + + +
    FieldDescription
    +channel
    + + +Kubernetes core/v1.ObjectReference + + +
    +(Optional) +

    You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name +The resource pointed by this ObjectReference must meet the Addressable contract +with a reference to the Addressable duck type. If the resource does not meet this contract, +it will be reflected in the Subscription’s status.

    +
    +

    SubscriberSpec +

    +

    +(Appears on: +ChoiceCase, +SequenceSpec, +SubscriptionSpec, +TriggerSpec) +

    +

    +

    SubscriberSpec specifies the reference to an object that’s expected to +provide the resolved target of the action. +Currently we inspect the objects Status and see if there’s a predefined +Status field that we will then use to dispatch events to be processed by +the target. Currently must resolve to a k8s service. +Note that in the future we should try to utilize subresources (/resolve ?) to +make this cleaner, but CRDs do not support subresources yet, so we need +to rely on a specified Status field today. By relying on this behaviour +we can utilize a dynamic client instead of having to understand all +kinds of different types of objects. As long as they adhere to this +particular contract, they can be used as a Target.

    +

    This ensures that we can support external targets and for ease of use +we also allow for an URI to be specified. +There of course is also a requirement for the resolved SubscriberSpec to +behave properly at the data plane level. +TODO: Add a pointer to a real spec for this. +For now, this means: Receive an event payload, and respond with one of: +success and an optional response event, or failure. +Delivery failures may be retried by the channel

    +

    + + + + + + + + + + + + + + + + + + + + + +
    FieldDescription
    +ref
    + + +Kubernetes core/v1.ObjectReference + + +
    +(Optional) +

    Reference to an object that will be used to find the target +endpoint, which should implement the Addressable duck type. +For example, this could be a reference to a Route resource +or a Knative Service resource. +TODO: Specify the required fields the target object must +have in the status. +You can specify only the following fields of the ObjectReference: +- Kind +- APIVersion +- Name

    +
    +dnsName
    + +string + +
    +(Optional) +

    Deprecated: Use URI instead. +Reference to a ‘known’ endpoint where no resolving is done. +http://k8s-service for example +http://myexternalhandler.example.com/foo/bar

    +
    +uri
    + +string + +
    +(Optional) +

    Reference to a ‘known’ endpoint where no resolving is done. +http://k8s-service for example +http://myexternalhandler.example.com/foo/bar

    +
    +

    SubscriptionSpec +

    +

    +(Appears on: +Subscription) +

    +

    +

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

    +

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

    +

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

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

    +

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

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

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

    +
    +subscriber
    + + +SubscriberSpec + + +
    +(Optional) +

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

    +
    +reply
    + + +ReplyStrategy + + +
    +(Optional) +

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

    +
    +

    SubscriptionStatus +

    +

    +(Appears on: +Subscription) +

    +

    +

    SubscriptionStatus (computed) for a subscription

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

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

    SubscriberURI is the fully resolved URI for spec.subscriber.

    +
    +replyURI
    + +string + +
    +

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

    +
    +

    TriggerFilter +

    +

    +(Appears on: +TriggerSpec) +

    +

    +

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

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

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

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

    +

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

    +
    +

    TriggerFilterAttributes +(map[string]string alias)

    +

    +(Appears on: +TriggerFilter) +

    +

    +

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

    +

    +

    TriggerFilterSourceAndType +

    +

    +(Appears on: +TriggerFilter) +

    +

    +

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

    +

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

    TriggerSpec +

    +

    +(Appears on: +Trigger) +

    +

    +

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

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

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

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

    +
    +subscriber
    + + +SubscriberSpec + + +
    +

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

    +
    +

    TriggerStatus +

    +

    +(Appears on: +Trigger) +

    +

    +

    TriggerStatus represents the current state of a Trigger.

    +

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

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

    +

    inherits duck/v1beta1 Status, which currently provides: +* ObservedGeneration - the ‘Generation’ of the Service that was last processed by the controller. +* Conditions - the latest available observations of a resource’s current state.

    +
    +subscriberURI
    + +string + +
    +

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

    +
    +

    Generated with gen-crd-api-reference-docs -on git commit ab260095. +on git commit a59dae6f.

    diff --git a/hack/gen-api-reference-docs.sh b/hack/gen-api-reference-docs.sh index b44197f14..ad8dbf1c1 100755 --- a/hack/gen-api-reference-docs.sh +++ b/hack/gen-api-reference-docs.sh @@ -33,9 +33,9 @@ KNATIVE_EVENTING_REPO="github.com/knative/eventing" KNATIVE_EVENTING_COMMIT="${KNATIVE_EVENTING_COMMIT:?specify the \$KNATIVE_EVENTING_COMMIT variable}" KNATIVE_EVENTING_OUT_FILE="eventing/eventing.md" -KNATIVE_EVENTING_SOURCES_REPO="github.com/knative/eventing-contrib" -KNATIVE_EVENTING_SOURCES_COMMIT="${KNATIVE_EVENTING_SOURCES_COMMIT:?specify the \$KNATIVE_EVENTING_SOURCES_COMMIT variable}" -KNATIVE_EVENTING_SOURCES_OUT_FILE="eventing/eventing-contrib-resources.md" +KNATIVE_EVENTING_RESOURCES_REPO="github.com/knative/eventing-contrib" +KNATIVE_EVENTING_RESOURCES_COMMIT="${KNATIVE_EVENTING_RESOURCES_COMMIT:?specify the \$KNATIVE_EVENTING_RESOURCES_COMMIT variable}" +KNATIVE_EVENTING_RESOURCES_OUT_FILE="eventing/eventing-contrib-resources.md" cleanup_refdocs_root= cleanup_repo_clone_root= @@ -163,12 +163,12 @@ main() { gen_refdocs "${refdocs_bin}" "${clone_root}" "${template_dir}" \ "${out_dir}/${KNATIVE_EVENTING_OUT_FILE}" "${knative_eventing_root}" "./pkg/apis" - local knative_eventing_sources_root - knative_eventing_sources_root="${clone_root}/src/${KNATIVE_EVENTING_SOURCES_REPO}" - clone_at_commit "https://${KNATIVE_EVENTING_SOURCES_REPO}.git" "${KNATIVE_EVENTING_SOURCES_COMMIT}" \ - "${knative_eventing_sources_root}" + local knative_eventing_resources_root + knative_eventing_resources_root="${clone_root}/src/${KNATIVE_EVENTING_RESOURCES_REPO}" + clone_at_commit "https://${KNATIVE_EVENTING_RESOURCES_REPO}.git" "${KNATIVE_EVENTING_RESOURCES_COMMIT}" \ + "${knative_eventing_resources_root}" gen_refdocs "${refdocs_bin}" "${clone_root}" "${template_dir}" \ - "${out_dir}/${KNATIVE_EVENTING_SOURCES_OUT_FILE}" "${knative_eventing_sources_root}" "." + "${out_dir}/${KNATIVE_EVENTING_RESOURCES_OUT_FILE}" "${knative_eventing_resources_root}" "." log "SUCCESS: Generated docs written to ${out_dir}/." log "Opening the ${out_dir}/ directory. You can now copy these API files" diff --git a/hack/reference-docs-gen-config.json b/hack/reference-docs-gen-config.json index e5fdbc706..ec74c2693 100644 --- a/hack/reference-docs-gen-config.json +++ b/hack/reference-docs-gen-config.json @@ -13,7 +13,7 @@ }, { "typeMatchPrefix": "^k8s\\.io/(api|apimachinery/pkg/apis)/", - "docsURLTemplate": "https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.13/#{{lower .TypeIdentifier}}-{{arrIndex .PackageSegments -1}}-{{arrIndex .PackageSegments -2}}" + "docsURLTemplate": "https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.14/#{{lower .TypeIdentifier}}-{{arrIndex .PackageSegments -1}}-{{arrIndex .PackageSegments -2}}" }, { "typeMatchPrefix": "^github\\.com/knative/pkg/apis/duck/",