Problem
The namespace-level default routes ConfigMap is named authproxy-routes, while per-agent routes ConfigMaps use the pattern authbridge-routes-<crName>. This naming inconsistency is confusing:
// Current naming:
AuthproxyRoutesConfigMapName = "authproxy-routes" // namespace default
"authbridge-routes-" + crName // per-agent
The name authproxy is legacy terminology from before the component was renamed to AuthBridge.
Proposed Solution
Rename to use consistent authbridge- prefix:
AuthBridgeRoutesConfigMapName = "authbridge-routes" // namespace default
"authbridge-routes-" + crName // per-agent (unchanged)
Breaking Change Considerations
This is a breaking change for any namespace that has a pre-existing authproxy-routes ConfigMap. Migration options:
Option A: Hard break (v1.0 boundary)
- Rename in one PR
- Document in release notes
- Users must manually rename their ConfigMap
Option B: Deprecation period
- Support both names (check both ConfigMaps, prefer new name)
- Log deprecation warning when old name is found
- Remove support after 2-3 releases
Option C: Automatic migration
- Webhook checks for
authproxy-routes, copies to authbridge-routes
- Annotates old ConfigMap with deprecation notice
- More complex, but smoothest UX
Scope
Files to update:
internal/webhook/injector/namespace_config.go - constant definition
internal/webhook/injector/volume_builder.go - volume name references
internal/webhook/injector/container_builder.go - volume mount name
- Documentation:
docs/authbridge/demos.md, docs/authbridge-webhook.md
- Test files
Related
Recommendation
Wait until v1.0 release boundary to make this breaking change. Use Option A (hard break) since the namespace-level authproxy-routes ConfigMap is rarely used in practice (most users rely on per-agent routes from AgentRuntime CRDs).
/cc @alantech
Problem
The namespace-level default routes ConfigMap is named
authproxy-routes, while per-agent routes ConfigMaps use the patternauthbridge-routes-<crName>. This naming inconsistency is confusing:The name
authproxyis legacy terminology from before the component was renamed to AuthBridge.Proposed Solution
Rename to use consistent
authbridge-prefix:Breaking Change Considerations
This is a breaking change for any namespace that has a pre-existing
authproxy-routesConfigMap. Migration options:Option A: Hard break (v1.0 boundary)
Option B: Deprecation period
Option C: Automatic migration
authproxy-routes, copies toauthbridge-routesScope
Files to update:
internal/webhook/injector/namespace_config.go- constant definitioninternal/webhook/injector/volume_builder.go- volume name referencesinternal/webhook/injector/container_builder.go- volume mount namedocs/authbridge/demos.md,docs/authbridge-webhook.mdRelated
authbridge-routes-<crName>ConfigMapsRecommendation
Wait until v1.0 release boundary to make this breaking change. Use Option A (hard break) since the namespace-level
authproxy-routesConfigMap is rarely used in practice (most users rely on per-agent routes from AgentRuntime CRDs)./cc @alantech