Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation for DeliverySpec.Timeout #3793

Merged
merged 4 commits into from
Jun 24, 2021
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 34 additions & 1 deletion docs/eventing/experimental-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ data:

## Features list

### `KReference.Group` field
### KReference.Group field

**Flag name**: `kreference-group`

Expand Down Expand Up @@ -85,3 +85,36 @@ With this feature you can allow Knative to resolve the full `APIVersion` and fur

!!! note
At the moment this feature is implemented only for `Subscription.Spec.Subscriber.Ref`.

### DeliverySpec.Timeout field

**Flag name**: `delivery-timeout`

**Stage**: Alpha, disabled by default

**Tracking issue**: https://github.com/knative/eventing/issues/5148

When using the `delivery` spec to configure event delivery parameters, you can use `timeout` field to specify the timeout for each sent HTTP request. The duration of the `timeout` parameter is specified using the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#Times) format.

The following example shows a Subscription that retries sending an event 3 times, and on each retry the request timeout is going to be 5 seconds:

```yaml
apiVersion: messaging.knative.dev/v1
kind: Subscription
metadata:
name: example-subscription
namespace: example-namespace
spec:
subscriber:
ref:
apiVersion: serving.knative.dev/v1
kind: Service
name: example-sink
delivery:
backoffDelay: PT2S
backoffPolicy: linear
retry: 3
timeout: PT5S
```

You can specify a `delivery` spec for Channels, Subscriptions, Brokers, Triggers, and any other resource spec that accepts the `delivery` field.