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

Update docs for Eventing TLS Beta #5967

Merged
merged 6 commits into from
May 14, 2024

Conversation

pierDipi
Copy link
Member

@pierDipi pierDipi commented May 13, 2024

Proposed Changes

  • Rename experimental features to just features
  • Add CA trust bundle configuration guide
  • Add setup selfsigned issuer guide for getting started

@knative-prow knative-prow bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label May 13, 2024
@knative-prow knative-prow bot requested review from nainaz and skonto May 13, 2024 10:09
@knative-prow knative-prow bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label May 13, 2024
Copy link

netlify bot commented May 13, 2024

Deploy Preview for knative ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit aae6858
🔍 Latest deploy log https://app.netlify.com/sites/knative/deploys/664388024887ea0008f97608
😎 Deploy Preview https://deploy-preview-5967--knative.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@pierDipi pierDipi force-pushed the transport-encryption-beta-docs branch 3 times, most recently from 8875b7b to 7919e4e Compare May 13, 2024 10:50
@pierDipi pierDipi changed the title [WIP] Update docs for Eventing TLS Beta Update docs for Eventing TLS Beta May 13, 2024
@knative-prow knative-prow bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label May 13, 2024
@pierDipi
Copy link
Member Author

/cc @creydr @Cali0707

@knative-prow knative-prow bot requested review from Cali0707 and creydr May 13, 2024 13:09
Comment on lines 159 to 161
!!! important
The `strict` is only enforced on the Broker and Channel receiver/ingress. Senders can still send
events over plaintext HTTP.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@pierDipi could we reword this? I find it a little confusing. To me, Senders can still send events over plaintext HTTP sounds like I can still send my events over http to a broker. But, my understanding is that we are trying to say that when a broker or channel sends events to a subscriber, if that subscriber only has a HTTP address, the broker or channel will send the event with HTTP instead of HTTPS.

Comment on lines 176 to 182
## Configure additional CA trust bundles

By default, Eventing clients trusts the system root CA (public CA).

If you need to add additional CA bundles for Eventing, you can do so by creating ConfigMaps in the
`knative-eventing` namespace with label `networking.knative.dev/trust-bundle: true`:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we can mention trust-manager here as a good way to do this?

@@ -208,7 +208,7 @@ Alternatively, if you are using a GitOps approach, you can add the `consumers` k

### Automatic Scaling with KEDA

Kafka Sources have experimental (Alpha) support for serverless scaling with KEDA, including scale to zero. If you want Knative and KEDA to scale your Kafka source for you,
Kafka Sources have (Alpha) support for serverless scaling with KEDA, including scale to zero. If you want Knative and KEDA to scale your Kafka source for you,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Kafka Sources have (Alpha) support for serverless scaling with KEDA, including scale to zero. If you want Knative and KEDA to scale your Kafka source for you,
Kafka Sources and Brokers have (Alpha) support for serverless scaling with KEDA, including scale to zero. If you want Knative and KEDA to scale your Kafka source for you,

@knative-prow-robot knative-prow-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 13, 2024
pierDipi added 4 commits May 14, 2024 17:38
Signed-off-by: Pierangelo Di Pilato <pierdipi@redhat.com>
Signed-off-by: Pierangelo Di Pilato <pierdipi@redhat.com>
Signed-off-by: Pierangelo Di Pilato <pierdipi@redhat.com>
Signed-off-by: Pierangelo Di Pilato <pierdipi@redhat.com>
@pierDipi pierDipi force-pushed the transport-encryption-beta-docs branch from 7919e4e to 0499d92 Compare May 14, 2024 15:39
@knative-prow-robot knative-prow-robot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 14, 2024
@pierDipi
Copy link
Member Author

@Cali0707 thanks, see latest commits!

Signed-off-by: Pierangelo Di Pilato <pierdipi@redhat.com>
Signed-off-by: Pierangelo Di Pilato <pierdipi@redhat.com>
@pierDipi pierDipi requested a review from Cali0707 May 14, 2024 15:53
Copy link
Member

@Cali0707 Cali0707 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

The eventing features looks a lot clearer now, thanks @pierDipi !

@knative-prow knative-prow bot added the lgtm Indicates that a PR is ready to be merged. label May 14, 2024
Copy link

knative-prow bot commented May 14, 2024

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: Cali0707, pierDipi

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@knative-prow knative-prow bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label May 14, 2024
@knative-prow knative-prow bot merged commit 76df699 into knative:main May 14, 2024
19 checks passed
@pierDipi pierDipi deleted the transport-encryption-beta-docs branch May 15, 2024 07:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. lgtm Indicates that a PR is ready to be merged. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants