Release Notes — v0.5¶
Stack version v0.5 is the first public umbrella release of the b'nerd cloud platform documentation. It captures the current production state of all consumer-facing components and their compatibility with the HQ API contract.
Version compatibility matrix¶
| Component | Version | Notes |
|---|---|---|
| HQ API | v1 (OpenAPI 3.0.1) | Rails 8.0.3, Ruby 3.2.0. Single API version; no /v2 path exists yet. |
CLI (bnerd) | 0.1.0 | Go 1.24. Full docs: cli.docs.bnerd.com. |
| Terraform Provider | dev build | Go 1.24. Registry: registry.terraform.io/bnerd-cloud/bnerd. Versioned releases will follow semver. |
| Dashboard | Nuxt 4.2 | Node 20.19. Requires a valid JWT or static token against HQ API v1. |
| S3 Operator | 0.1.0 (chart) | Kopf-based. Manages RGW users via the HQ API control plane. |
Public endpoints¶
| Service | Host |
|---|---|
| API | https://api.bnerd.cloud |
| Dashboard | https://app.bnerd.cloud |
| Object storage (S3 / RGW) | https://storage.muc1.de.bnerd.com (region de-muc1) |
What v0.5 means¶
v0.5 is the umbrella documentation stack version — it does not gate any single component. All components listed above are compatible with each other at the versions shown, as of the date of this release. The HQ API contract (quota, locked, renew_key, purge_objects, audit) is the integration point all consumers depend on.
The intent is that any consumer (CLI, dashboard, Terraform, operators) using HQ API v1 at the versions above will interoperate without breaking changes. The next bump (v0.6 or v1.0) will be issued when a breaking API change, a major CLI release, or a provider registry publication makes a coordinated version statement necessary.
RGW control-plane contract (v0.5 baseline)¶
These are the stable operations in the RGW control plane at v0.5:
| Operation | Endpoint | Authz |
|---|---|---|
| Set quota | PATCH /rgw/users/{id} — quota.max_size_kb, quota.enabled | Platform-admin only |
| Lock / unlock user | PATCH /rgw/users/{id} — locked | Platform-admin only |
| Renew access key | POST /rgw/users/{id}/renew_key | Member with rgw:update |
| Purge objects & delete | DELETE /rgw/users/{id}?purge_objects=true | Platform-admin; irreversible, audited |
| Delete (no purge) | DELETE /rgw/users/{id} | Member with rgw:delete |
quota.max_objects is not part of the API contract and is not exposed by any endpoint. Only max_size_kb and enabled are configurable through this interface.
Known limitations at v0.5¶
- No formal deprecation policy has been issued yet; one will accompany v1.0.
- The Terraform provider has not been published to the Terraform Registry; it is consumed from source or a private mirror.
- Dashboard automated test coverage is absent; e2e (Playwright) layer is planned for v0.6.