05-resources

name	05-resources
description	Resource taxonomy and processing — common processing flow, per-resource feature points / special handling / cross-resource relationships.

05 Resource Architecture

This directory describes the internal processing flow of each resource from Controller to Gateway: per-stage Handler logic, requeue relationships, source code locations. The external contract of each resource (YAML schema, field types and defaults) lives in 02-features/03-resources/ — the numbering on the two sides is aligned, and code changes typically need to look at both.

Each resource document follows a unified structure:

1. Common-flow reference — points to the common flow in 00-resource-flow.md
2. Resource-specific behavior — concrete behavior of each Handler stage (filter/validate/preparse/parse/on_change/on_delete/update_status)
3. Cross-resource relationships — references, cascading updates, and requeue relationships between this resource and others

File list

File	Topic	Recommended reading scenario
00-resource-flow.md	Common resource processing flow	Understanding how resources flow from Controller to Gateway
Core configuration
01-gateway.md	Gateway resource	Modifying Gateway/Listener logic
02-gateway-class.md	GatewayClass resource	Modifying GatewayClass handling
03-edgion-gateway-config.md	EdgionGatewayConfig resource	Modifying global configuration
Routes
04-http-route.md	HTTPRoute resource	Modifying HTTP routing
05-grpc-route.md	GRPCRoute resource	Modifying gRPC routing
06-tcp-route.md	TCPRoute resource	Modifying TCP routing
07-tls-route.md	TLSRoute resource	Modifying TLS routing
08-udp-route.md	UDPRoute resource	Modifying UDP routing
Security and policy
09-edgion-tls.md	EdgionTls resource	Modifying TLS certificate management
10-secret.md	Secret resource	Understanding Secret handling and security constraints
11-reference-grant.md	ReferenceGrant resource	Understanding cross-namespace references
12-backend-tls-policy.md	BackendTLSPolicy resource	Configuring backend TLS
Plugins and extensions
13-edgion-plugins.md	EdgionPlugins resource	Understanding plugin configuration
14-edgion-stream-plugins.md	EdgionStreamPlugins resource	Understanding Stream plugins
15-edgion-config-data.md	EdgionConfigData resource + overlay model	Understanding EdgionConfigData, base+overlay architecture, fail-to-base, variant taxonomy
Backends and services
16-service-endpoints.md	Service + EndpointSlice + Endpoint	Backend discovery
ACME
17-edgion-acme.md	EdgionAcme resource	Automatic certificates
Infrastructure
18-link-sys.md	LinkSys resource	External system connections
Relationships
19-resource-dependency.md	Inter-resource dependencies	Understanding cross-resource references, Store queries, and requeue cascades

Resource relationship overview

Spec-level reference relationships (simplified):

GatewayClass ──────► Gateway ◄────── EdgionGatewayConfig
                       │
            ┌──────────┼──────────┐
            ▼          ▼          ▼
       HTTPRoute   GRPCRoute   TCP/TLS/UDPRoute
            │          │          │
            ▼          ▼          ▼
         Service ──► EndpointSlice/Endpoint
            │
            ▼
     BackendTLSPolicy

Gateway ──► Secret (TLS certificates)
         ──► EdgionTls (extended TLS)
         ──► EdgionAcme (automatic certificates)

HTTPRoute/GRPCRoute ──► EdgionPlugins (HTTP plugins)
                    ──► EdgionStreamPlugins (Stream plugins)

EdgionPlugins/EdgionStreamPlugins ──► EdgionConfigData (overlay/data primitive via overrideRef)

Cross-namespace references ──► ReferenceGrant

AccessLog/Plugin data ──► LinkSys (external systems)

Controller-internal Store queries and requeue cascades are documented in 19-resource-dependency.md.