Skip to content

[Docs] Draft release notes for v0.1.0-alpha #48

Description

@NAME-ASHWANIYADAV

As requested by @illume on Slack - draft release notes for the first v0.1.0-alpha release (companion to #43). Feedback welcome before we cut the release.


Agones Headlamp Plugin v0.1.0-alpha

⚠️ This is an alpha release. The plugin is under active development as part of the LFX Mentorship programme - APIs and features may change between releases.

The first public release of the Agones Headlamp plugin: visualise and manage Agones game servers, fleets, and autoscalers directly from the Headlamp UI.

✨ Highlights

  • Overview Dashboard - at-a-glance summary of all Agones resources across the cluster, with game server counts grouped by lifecycle state.
  • Fleets - list and detail views with replica status (ready / allocated / reserved), scheduling strategy, and the game servers belonging to each fleet.
  • Game Servers - detail pages with colour-coded lifecycle state chips, node address and port tables, counters & lists, and a preview of the backing pod.
  • Fleet Autoscalers - every policy type (Buffer, Webhook, Counter, List, Schedule, Chain) rendered as readable tables, with a plain-English explainer of the current scaling status.
  • Allocations from the UI - create GameServerAllocation requests via a guided dialog: label selectors, scheduling, counter/list filters, mutations, and priorities.
  • Map View - visual graph of the relationships between Fleets, GameServers, and Pods.
  • Agones Detection Guard - clusters without Agones get a friendly install banner instead of empty views.
  • Allocated-Session Protection - a warning banner on Allocated game servers reminds operators that live player sessions may be connected.

🔧 Under the Hood

  • TypeScript resource models aligned with the upstream Agones Go structs (eviction, addresses, reservedUntil, allocationOverflow, priorities, counters/lists, Wasm autoscaling policy).
  • Unit test suite with Vitest, plus CI (GitHub Actions), Dependabot, and DCO enforcement.
  • Built on Headlamp's common components for consistent theming (light/dark) with the rest of the dashboard.

📦 Installation

Once published to ArtifactHub, install via the Headlamp Plugin Catalog (search for "Agones"). Manual installation instructions are in the README.

⚠️ Known Limitations

  • Alpha quality - expect rough edges; please file bugs!
  • Read-mostly UI for now: allocation is the main write operation. Delete actions, map icons, and pod detail injection are on the roadmap.

🙏 Thanks

Built as part of the LFX Mentorship programme with guidance from @markmandel, @illume, @lacroixthomas, and @ashu8912. Thanks also to @Fire-furo for the Fleet link navigation fix, and to @manumathon for the early CI groundwork.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions