opendefensecloud / solution-arsenal / 34198528216

80%

Build Type

push

github

Committed by web-flow

Commit Message

docs: adr for solar-agent architecture, pocs for deployment options (#702)

## What
Closes #665
Reworks solar-agent PoC / Design around render-time delivery and a
SolAr-owned OIDC
issuer, and finishes the status collector against both Flux objects.

## Why
The architecture is designed around an agent delivered by SolAr's own
render pipeline, so the Target always exists
first and the credential can be rendered alongside the workload

## Testing
- `make test testargs="./pkg/agent/..."`
- `make test testargs="./pkg/controller/..."`
- Manual, end to end on the `solar-dev` kind cluster: discovery transfer
→
release render → bootstrap render → Flux installs the bootstrap chart →
  agent reports the resulting pair

## Checklist
- [x] Tests added/updated
- [x] No breaking changes (or upgrade path documented above)
- [x] Readable commit history (squashed and cleaned up as desired)
- [x] AI code review considered and comments resolved

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Added the Solar Agent command, which monitors cluster capacity and
release health and periodically reports updates.
- Added support for resolving the agent’s assigned Target and handling
graceful shutdown.
- Added release lifecycle reporting, including pending, progressing,
ready, degraded, and failed states.
- Added Kubernetes permissions and setup tooling for local and
cross-namespace deployments.

- **Documentation**
- Documented the Solar Agent architecture and development-cluster setup
process, including configuration and monitoring guidance.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Coverage Stats

167 of 244 new or added lines in 4 files covered. (68.44%)

4 existing lines in 2 files now uncovered.

5813 of 7291 relevant lines covered (79.73%)

31.47 hits per line