Skip to main content

Builds

A build is a versioned artifact of your game server. GameFlow stores every upload so you can promote, roll back, or pin specific versions of your server.

You manage builds from the Builds page of a game in the dashboard: Home / Games / <Your Game> / Builds.

Build states​

Each build is in one of these states:

  • Current, the build new servers will run by default.
  • Previous, the build that was current before the latest promotion. Used for one-click rollback.
  • Other, uploaded builds that are neither current nor previous.

If no build has been promoted, the latest upload is used as the current build by default. Promote one to lock it in.

Uploading a new build​

Click Upload New Build to upload a new artifact. The new build appears in the list immediately but is not promoted to current until you explicitly do so (unless it's your first upload).

Promoting a build​

Click Set as Current on any non-current build to promote it. The existing current build is demoted to previous.

What happens after promotion depends on the game's scaling strategy:

Standalone servers (on-demand)​

  • New servers launch with the current build.
  • You can override on a per-server basis by passing a specific build id when starting a server.
  • Already-running servers keep their original build until they shut down. No interruption.

Fleet of servers​

  • The fleet rolls out the new build using the game's rollout strategy (e.g. RollingUpdate).
  • Players already in a live match stay on the old build until the match ends. No one gets kicked.
  • New allocations from the warm pool serve the new build as it rolls out.

Rolling back​

If a previous build exists, Rollback to Previous is available. It promotes the previous build back to current in one click.

warning

After a rollback, running standalone servers may need to be restarted to pick up the rolled-back build. Fleets follow the configured rollout strategy.

Deleting a build​

Delete removes the artifact and its record. This is permanent:

  • You cannot roll back to a deleted build.
  • You cannot allocate new servers from a deleted build.

You cannot delete the current build.

Targeting a specific build​

For standalone servers, you can launch a server on any non-deleted build by passing its build id when starting the server, bypassing the current/previous flags. Useful for QA, hotfix verification, or pinning a known-good version.