| name | features |
| description | Use when looking up configuration schemas, resource field definitions, binary deployment options, observability settings, or edgion.io/* annotation references. |
02 Features and Configuration Reference
Deep documentation of each Edgion feature module, written for users and operators.
See ../01-architecture/SKILL.md for architecture implementation details, and ../03-coding/SKILL.md for coding conventions.
Design Principles
- Schema-driven: every resource and every configuration has a complete field definition and type description
- Gateway API v1.5 aligned: Gateway API standard resources follow the v1.5.0 specification, with Edgion extension points called out
- Aligned with architecture numbering:
03-resources/ numbering corresponds one-to-one with 01-architecture/05-resources/
- User perspective: focuses on "how to use" and "how to configure", not "how it is implemented internally"
Directory Overview
| # | Directory | Purpose |
|---|
| 01 | binary-and-deployment/ | Startup of the in-repo binaries, CLI arguments, deployment patterns, Feature Flags |
| 02 | config/ | Controller (YAML) and Gateway (YAML) configuration schemas, EdgionGatewayConfig CRD schema |
| 03 | resources/ | All resource feature schemas: Gateway, Route, TLS, Plugin, Backend, LinkSys |
| 04 | observability/ | Observability features: Access Log configuration, Metrics endpoints, protocol logs |
| 05 | annotations/ | Annotations and Options reference: complete list of all edgion.io/* keys |
Quick Lookup
Gateway API Version
Edgion is based on Gateway API v1.5.0, with the following support scope:
| Resource | API Version | Support Status |
|---|
| Gateway | gateway.networking.k8s.io/v1 | Core |
| GatewayClass | gateway.networking.k8s.io/v1 | Core |
| HTTPRoute | gateway.networking.k8s.io/v1 | Core |
| GRPCRoute | gateway.networking.k8s.io/v1 | Core |
| ReferenceGrant | gateway.networking.k8s.io/v1 (v1beta1 compatible) | Core |
| TCPRoute | gateway.networking.k8s.io/v1alpha2 | Experimental |
| TLSRoute | gateway.networking.k8s.io/v1 | Standard (compatibility with the older alpha version depends on the install manifest) |
| UDPRoute | gateway.networking.k8s.io/v1alpha2 | Experimental |
| BackendTLSPolicy | gateway.networking.k8s.io/v1 (v1alpha3 compatible) | Standard / multi-version compatible |
Edgion extension resources (API group: edgion.io):
| Resource | API Version | Purpose |
|---|
| EdgionGatewayConfig | edgion.io/v1alpha1 | GatewayClass-level runtime configuration |
| EdgionTls | edgion.io/v1 | Extended TLS configuration (mTLS, versions, cipher suites) |
| EdgionPlugins | edgion.io/v1 | HTTP plugin configuration |
| EdgionStreamPlugins | edgion.io/v1 | TCP/TLS layer plugin configuration |
| EdgionAcme | edgion.io/v1 | ACME automatic certificate management |
| LinkSys | edgion.io/v1 | External system connector |
| EdgionConfigData | edgion.io/v1 | Plugin metadata |
