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 references, including the GameServer and Fleet reference materials.
  • Review the specifics of Health Checking.
  • See all the commands the Client SDK provides - we only show a few here!
  • If you aren’t familiar with the term Pod, this should provide a reference.

Last modified August 18, 2021: Create "Integration Patterns" section in docs (#2215) (a6de25c24)