Skip to content

Update Envoy examples to the v3 API#391

Open
v0lkan wants to merge 3 commits into
masterfrom
fix/issue-218
Open

Update Envoy examples to the v3 API#391
v0lkan wants to merge 3 commits into
masterfrom
fix/issue-218

Conversation

@v0lkan

@v0lkan v0lkan commented Jul 4, 2026

Copy link
Copy Markdown
Member

The inline Envoy config snippets still used the v2 API, which was removed from Envoy in 1.17 and no longer works on any current release. Convert all three snippets to v3, mirroring the maintained configs in spiffe/spire-tutorials (k8s/envoy-x509):

  • SPIRE Agent cluster: replace the deprecated hosts/pipe syntax with load_assignment and a pipe endpoint address.
  • TLS certificates: replace tls_context with a transport_socket using envoy.transport_sockets.tls and a typed DownstreamTlsContext, and set resource_api_version/transport_api_version to V3 in sds_config.
  • Validation context: use combined_validation_context so SPIRE supplies the trust bundle over SDS while a static default_validation_context can match peer SPIFFE IDs via match_typed_subject_alt_names.

Adjust the surrounding prose to name the v3 constructs and note the Envoy versions the examples apply to.

Fixes #218

@v0lkan v0lkan self-assigned this Jul 4, 2026
@v0lkan v0lkan requested review from a team as code owners July 4, 2026 17:33
@netlify

netlify Bot commented Jul 4, 2026

Copy link
Copy Markdown

Deploy Preview for spiffe ready!

Name Link
🔨 Latest commit 7f0eec0
🔍 Latest deploy log https://app.netlify.com/projects/spiffe/deploys/6a54fdd478e487000788d36d
😎 Deploy Preview https://deploy-preview-391--spiffe.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 project configuration.

The inline Envoy config snippets still used the v2 API, which was
removed from Envoy in 1.17 and no longer works on any current
release. Convert all three snippets to v3, mirroring the maintained
configs in spiffe/spire-tutorials (k8s/envoy-x509):

- SPIRE Agent cluster: replace the deprecated hosts/pipe syntax with
  load_assignment and a pipe endpoint address.
- TLS certificates: replace tls_context with a transport_socket using
  envoy.transport_sockets.tls and a typed DownstreamTlsContext, and
  set resource_api_version/transport_api_version to V3 in sds_config.
- Validation context: use combined_validation_context so SPIRE
  supplies the trust bundle over SDS while a static
  default_validation_context can match peer SPIFFE IDs via
  match_typed_subject_alt_names.

Adjust the surrounding prose to name the v3 constructs and note the
Envoy versions the examples apply to.

Fixes #218

Signed-off-by: Volkan Özçelik <volkan.ozcelik@broadcom.com>

@sorindumitru sorindumitru left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM, one small comment

Comment thread content/docs/latest/microservices/envoy.md Outdated
@v0lkan

v0lkan commented Jul 13, 2026

Copy link
Copy Markdown
Member Author

Landing this after CI passes.

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.

Update Envoy examples to V3 API?

2 participants