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:
  required:
    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 March 19, 2024: Update Supported Kubernetes to 1.27, 1.28, 1.29 (#3654) (ace51d6)