Skip to content

docs: document missing entity 'ingress' #25665

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

Merged

Conversation

mhofstetter
Copy link
Member

@mhofstetter mhofstetter commented May 25, 2023

The entity ingress is missing from the list of pre-defined entities which are available when defining policies which fromEntities and toEntities.

This PR documents the missing entity.

❗ backport info 1.12: note that the ingress entity only applies to cluster external traffic

@mhofstetter mhofstetter added area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. release-note/misc This PR makes changes that have no direct user impact. labels May 25, 2023
@mhofstetter mhofstetter requested a review from jrajahalme May 25, 2023 09:16
Copy link
Member

@jrajahalme jrajahalme left a comment

Choose a reason for hiding this comment

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

Also needs to be backported to v1.12, but noting that the ingress entity only applies to cluster external traffic in v1.12.

@mhofstetter mhofstetter marked this pull request as ready for review May 25, 2023 09:21
@mhofstetter mhofstetter requested review from a team as code owners May 25, 2023 09:21
@mhofstetter mhofstetter requested a review from zacharysarah May 25, 2023 09:21
Copy link
Contributor

@zacharysarah zacharysarah left a comment

Choose a reason for hiding this comment

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

@mhofstetter Good work. Some nits to fix, otherwise LGTM. I'm approving with the understanding that changes are required prior to merge.

Comment on lines 333 to 335
The ingress entity represents the Cilium Envoy instance which handles ingress
L7 traffic. Be aware that this also applies for pod-to-pod traffic within
the same cluster when using ingress endpoints (hairpinning).
Copy link
Contributor

Choose a reason for hiding this comment

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

Deep into the nitty weeds: s/which/that, some small clarification, italics when introducing a new term

Suggested change
The ingress entity represents the Cilium Envoy instance which handles ingress
L7 traffic. Be aware that this also applies for pod-to-pod traffic within
the same cluster when using ingress endpoints (hairpinning).
The ingress entity represents the Cilium Envoy instance that handles ingress
L7 traffic. Be aware that this also applies for pod-to-pod traffic within
the same cluster when using ingress endpoints (also known as *hairpinning*).

Copy link
Contributor

Choose a reason for hiding this comment

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

Handy guidance for "which" vs. "that":

If your sentence has a clause but does not need it, use “which”; if the sentence does need the clause, use “that.”

Copy link
Member Author

Choose a reason for hiding this comment

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

@zacharysarah thanks for your review - i adapted your recommendations. special thanks for the which/that guidance - definitely an important one for me. will try to remember next time! 🧠

The entity `ingress` is missing from the list of pre-defined entities
which are available when defining policies which `fromEntities` and
`toEntities`.

This commits fixes this.

Signed-off-by: Marco Hofstetter <marco.hofstetter@isovalent.com>
@mhofstetter mhofstetter force-pushed the pr/mhofstetter/docs-ingress-entity branch from 255d98f to 2130a57 Compare May 26, 2023 06:28
@mhofstetter mhofstetter requested a review from jrajahalme May 26, 2023 06:33
@mhofstetter
Copy link
Member Author

change in the documentation doesn't require running the full ci test suite -> adding label ready-to-merge

@mhofstetter mhofstetter added the ready-to-merge This PR has passed all tests and received consensus from code owners to merge. label May 26, 2023
@jrajahalme jrajahalme merged commit a0bfd5d into cilium:main May 26, 2023
@mhofstetter mhofstetter deleted the pr/mhofstetter/docs-ingress-entity branch May 26, 2023 07:45
@sayboras sayboras mentioned this pull request May 28, 2023
10 tasks
@sayboras sayboras mentioned this pull request May 28, 2023
5 tasks
@sayboras sayboras added backport-pending/1.12 backport-done/1.13 The backport for Cilium 1.13.x for this PR is done. and removed needs-backport/1.12 labels May 28, 2023
@julianwiedmann julianwiedmann added backport-done/1.12 The backport for Cilium 1.12.x for this PR is done. and removed backport-pending/1.12 labels Jul 10, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. backport-done/1.12 The backport for Cilium 1.12.x for this PR is done. backport-done/1.13 The backport for Cilium 1.13.x for this PR is done. ready-to-merge This PR has passed all tests and received consensus from code owners to merge. release-note/misc This PR makes changes that have no direct user impact.
Projects
No open projects
Status: Released
Development

Successfully merging this pull request may close these issues.

5 participants