Matchmaker requests a GameServer from a Fleet

This is the preferred workflow for a GameServer, in which an external matchmaker requests an allocation from one or more Fleets using a GameServerAllocation.

Allocated Lifecycle Sequence Diagram

Sample GameServerAllocation

Since Agones will automatically add the label agones.dev/fleet to a GameServer of a given Fleet, we can use that label selector to target a specific Fleet by name. In this instance, we are targeting the Fleet xonotic.

apiVersion: "allocation.agones.dev/v1"
kind: GameServerAllocation
spec:
  selectors:
    - matchLabels:
        agones.dev/fleet: xonotic

Next Steps:

  • Read the various specification references.
  • Review the specifics of Health Checking.
  • See all the commands the Client SDK provides - we only show a few here!
  • Check out the Allocator Service as a richer alternative to GameServerAllocation.
  • If you aren’t familiar with the term Pod, this should provide a reference.

Last modified November 5, 2024: Update Supported Kubernetes to 1.29, 1.30, 1.31 (#4024) (a0d1614)