Skip to content

docs: New concept page for load balancing#5874

Closed
melsal13 wants to merge 37 commits intoenvoyproxy:mainfrom
melsal13:docs-load-balancing-conceptual
Closed

docs: New concept page for load balancing#5874
melsal13 wants to merge 37 commits intoenvoyproxy:mainfrom
melsal13:docs-load-balancing-conceptual

Conversation

@melsal13
Copy link
Contributor

What type of PR is this?
Conceptual docs addition for load balancing in latest and v1.3.

Note: Will move this doc to concepts/introduction once pr#5739 is merged to main.

What this PR does / why we need it:
Helps explain the concept of load balancing for new users.

Which issue(s) this PR fixes:
Fixes #5873

Release Notes: No

@codecov
Copy link

codecov bot commented Apr 30, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 65.21%. Comparing base (410da88) to head (6f87cdc).

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #5874      +/-   ##
==========================================
- Coverage   65.22%   65.21%   -0.01%     
==========================================
  Files         224      224              
  Lines       35857    35857              
==========================================
- Hits        23386    23385       -1     
  Misses      11030    11030              
- Partials     1441     1442       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@melsal13 melsal13 changed the title docs: conceptual page for load balancing docs: New concept page for load balancing May 1, 2025
arkodg and others added 27 commits May 7, 2025 15:06
Not enough space on the GHA runner, blocking the release
can be triaged later

Relates to https://github.com/envoyproxy/gateway/actions/runs/14765129938/job/41457946081

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
…s (#5822)

docs(grpc): add note on using  for GPRC timeouts

Signed-off-by: antvirf <antti.viitala@icloud.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Relates to envoyproxy/gateway#5878

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* increase liveness probe failureThresold for shutdown manager

* the `envoy` container's `failureThreshold` is 3, and the
  `shutdown-manager`'s `failureThreshold` is now 10, so any
  transient network issues will make sure `envoy` restarts before
  `shutdown-manager`

  Relates to envoyproxy/gateway#5832

Signed-off-by: Arko Dasgupta <arko@tetrate.io>

* add missing testdata

Signed-off-by: Arko Dasgupta <arko@tetrate.io>

---------

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* fix: remove sanposhiho from reviewers

Signed-off-by: Kensei Nakada <handbomusic@gmail.com>

* fix: add sanposhiho to `emeritus-reviewers`

Signed-off-by: Kensei Nakada <handbomusic@gmail.com>

---------

Signed-off-by: Kensei Nakada <handbomusic@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* fix: make topology injector best effort

* allow pods even if there is an internal error
in the webhook processing the request

Relates to envoyproxy/gateway#5890

Signed-off-by: Arko Dasgupta <arko@tetrate.io>

* fix build

Signed-off-by: Arko Dasgupta <arko@tetrate.io>

---------

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
slight change in subtitle of concept template to make section clearer

Signed-off-by: melsal13 <mmvsal13@gmail.com>
…… (#5889)

Revert "increase liveness probe failureThreshold for shutdown manager (#5877)"

This reverts commit 93f3d1c.

This commit may introduce other subtle issues where the licenses probes for envoy kicks in
but not shutdown manager which will block envoy from restarting, so prefer to not make this change atm.

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: shawnh2 <shawnhxh@outlook.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* chore/ci: add lint.gofumpt target

Signed-off-by: Karol Szwaj <karol.szwaj@gmail.com>

* update review

Signed-off-by: Karol Szwaj <karol.szwaj@gmail.com>

* Add extra flag to gofumpt, move local golanglint fmt target to golang makefile

Signed-off-by: Karol Szwaj <karol.szwaj@gmail.com>

* add build tags

Signed-off-by: Karol Szwaj <karol.szwaj@gmail.com>

* fix lint

Signed-off-by: Karol Szwaj <karol.szwaj@gmail.com>

---------

Signed-off-by: Karol Szwaj <karol.szwaj@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* fix(QF1008): Omit embedded fields from selector expression

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>

* fix(QF1001): Apply De Morgan’s law

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>

* fix(QF1002): Convert untagged switch to tagged switch

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>

* fix(QF1003): Convert if/else-if chain to tagged switch

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>

* fix(QF1007): Merge conditional assignment into variable declaration

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>

* fix(QF1009): Use time.Time.Equal instead of == operator

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>

---------

Signed-off-by: Matthieu MOREL <matthieu.morel35@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
docs for local jwks

Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* disable settings by default in gateway-crds-helm

* These settings dont work by default in the way `helm` works
and this helm chart is now mainly used as a package artifact
to be consumed by CI tools like Argo, so changed the default settings to
disable by default, so users are opting into specific CRDs they want.

Relates to envoyproxy/gateway#5616 (comment)

Signed-off-by: Arko Dasgupta <arko@tetrate.io>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
…… (#5904)

* Add seed corpus to guide the fuzzer to generate combinations of gateway resources.

Signed-off-by: sudipto baral <sudiptobaral.me@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* chore: passing root context to template

Signed-off-by: hansselvig <34341538+hansselvig@users.noreply.github.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
*  fix precedence to use number of exact matches

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: zirain <zirain2009@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
…(#5912)

Signed-off-by: Tomas Rojo <tomasrojo21@hotmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Bumps [google/osv-scanner-action](https://github.com/google/osv-scanner-action) from 2.0.1 to 2.0.2.
- [Release notes](https://github.com/google/osv-scanner-action/releases)
- [Commits](google/osv-scanner-action@6fc7144...e69cc6c)

---
updated-dependencies:
- dependency-name: google/osv-scanner-action
  dependency-version: 2.0.2
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Bumps [github/codeql-action](https://github.com/github/codeql-action) from 3.28.16 to 3.28.17.
- [Release notes](https://github.com/github/codeql-action/releases)
- [Changelog](https://github.com/github/codeql-action/blob/main/CHANGELOG.md)
- [Commits](github/codeql-action@28deaed...60168ef)

---
updated-dependencies:
- dependency-name: github/codeql-action
  dependency-version: 3.28.17
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
…n /examples/preserve-case-backend in the github.com group across 1 directory (#5921)

build(deps): bump github.com/valyala/fasthttp

Bumps the github.com group with 1 update in the /examples/preserve-case-backend directory: [github.com/valyala/fasthttp](https://github.com/valyala/fasthttp).

Updates `github.com/valyala/fasthttp` from 1.60.0 to 1.61.0
- [Release notes](https://github.com/valyala/fasthttp/releases)
- [Commits](valyala/fasthttp@v1.60.0...v1.61.0)

---
updated-dependencies:
- dependency-name: github.com/valyala/fasthttp
  dependency-version: 1.61.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: github.com
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* docs: fix example for http redirects page

Signed-off-by: Marcel Czaplinski <24626912+mczaplinski@users.noreply.github.com>

* chore: copy documentation patch for http redirects from v1.3 to latest

Signed-off-by: Marcel Czaplinski <24626912+mczaplinski@users.noreply.github.com>

---------

Signed-off-by: Marcel Czaplinski <24626912+mczaplinski@users.noreply.github.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* add docs for request buffering

Signed-off-by: mark winter <mark.winter@thetradedesk.com>

* add missing change

Signed-off-by: mark winter <mark.winter@thetradedesk.com>

---------

Signed-off-by: mark winter <mark.winter@thetradedesk.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
zhaohuabing and others added 9 commits May 7, 2025 15:06
* support configuring tls for dynamic resolver backend

Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* fix webhook

Signed-off-by: Jukie <10012479+Jukie@users.noreply.github.com>

* lint and test fixes

Signed-off-by: Jukie <10012479+Jukie@users.noreply.github.com>

---------

Signed-off-by: Jukie <10012479+Jukie@users.noreply.github.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* feat: allow merge rate limit rule in BTP

Signed-off-by: zirain <zirain2009@gmail.com>

* fix gen

Signed-off-by: zirain <zirain2009@gmail.com>

---------

Signed-off-by: zirain <zirain2009@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* install EG via Argo CD

Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
clean up BTP status

Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
e2e test for dynamic resolver backend using system ca for TLS

Signed-off-by: Huabing (Robin) Zhao <zhaohuabing@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
* fix: SecurityPolicy reference grant

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

* add: release note

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

* update: func name

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

* revert func name

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

* update: use processBackendRef to handle route backends

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

* fix: use not pointer type for extAuth backendRef

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

* Add: testcase for ExtAuth

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

* fix: add jwt backendref to backendSecurityPolicyIndexFunc

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>

---------

Signed-off-by: kkk777-7 <kota.kimura0725@gmail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
Signed-off-by: Gavin Lam <gavin.oss@tutamail.com>
Signed-off-by: melsal13 <mmvsal13@gmail.com>
@melsal13
Copy link
Contributor Author

Closing this pr and replacing with the following:
#6088

@melsal13 melsal13 closed this May 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: conceptual doc for Load Balancing