メニュー
Use when looking up configuration schemas, resource field definitions, binary deployment options, observability settings, or edgion.io/* annotation references.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Conventions shared by the in-repo binaries (edgion-controller, edgion-gateway, edgion-cli) — project overview, command line / directory / config-path conventions, Core layering conventions, resource system.
KubernetesCenter implementation — K8s Reflector watching, leader election, HA mode, ResourceController lifecycle, status writeback.
ConfigCenter subsystem — ConfCenter trait abstraction, FileSystemCenter and KubernetesCenter implementations, unified Workqueue + ResourceProcessor pipeline.
edgion-controller control plane architecture — overall design, startup/shutdown, Admin API, ConfigCenter, Workqueue, ResourceProcessor, Requeue, CacheServer, ACME service.
Route matching overview — multi-stage pipeline (Listener→Domain→Path→DeepMatch), per-listener isolation, registration flow, atomic swap.
TLS subsystem overview — TLS Store, SNI matching, certificate management, BoringSSL/OpenSSL backend selection.
| name | features |
| description | Use when looking up configuration schemas, resource field definitions, binary deployment options, observability settings, or edgion.io/* annotation references. |
Deep documentation of each Edgion feature module, written for users and operators. See
../01-architecture/SKILL.mdfor architecture implementation details, and../03-coding/SKILL.mdfor coding conventions.
03-resources/ numbering corresponds one-to-one with 01-architecture/05-resources/| # | 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 |
| You want to… | Start here |
|---|---|
| Learn how to start Controller/Gateway | 01-binary-and-deployment/ |
| Modify YAML configuration files | 02-config/ |
| Configure a Gateway Listener | 03-resources/01-gateway.md |
| Configure HTTP routing rules | 03-resources/04-httproute.md |
| Configure gRPC routing | 03-resources/05-grpcroute.md |
| Configure TLS certificates/mTLS | 03-resources/09-edgion-tls.md |
| Use automatic certificates (ACME) | 03-resources/17-acme.md |
| Look up the configuration of a plugin | 03-resources/13-edgion-plugins.md |
| Configure health checks/load balancing | 03-resources/16-service-backends.md |
| Configure Access Log output | 04-observability/00-logging.md |
| Integrate with Redis/ES and other external systems | 03-resources/18-link-sys.md |
| Look up the meaning of an annotation | 05-annotations/ |
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 |