Uploading a Build - Simpl

What goes in the ZIP

A build is a ZIP file containing your server binary and a simpl-server.sh startup script. Simpl wraps the contents in a container and stores it in a private registry.

simpl-server.sh

simpl-server.sh must be executable and must start your server process. Simpl passes match context through environment variables:

Variable	Description
`SIMPL_SERVER_ID`	The unique ID of this server instance
`SIMPL_REGION`	The region the server is running in
`SIMPL_UDP_BIND_ADDRESS`	The address your process must bind UDP listeners to
`SIMPL_TCP_BIND_ADDRESS`	The address your process must bind TCP listeners to

#!/bin/bash
set -e

exec ./game_server \
  --server-id "$SIMPL_SERVER_ID" \
  --region "$SIMPL_REGION" \
  --udp-bind "$SIMPL_UDP_BIND_ADDRESS" \
  --tcp-bind "$SIMPL_TCP_BIND_ADDRESS"

Uploading

From the dashboard: click Upload build, select your ZIP, and give it a name. From the API: request a presigned upload URL, then upload directly to it.

curl -X POST https://api.simpl.gg/v1/builds/upload-url \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{"name": "0.1.0"}'

curl -X PUT "$PRESIGNED_URL" \
  -H "Content-Type: application/zip" \
  --data-binary @build.zip

Build statuses

Status	Meaning
`uploading`	The ZIP is being transferred
`processing`	Simpl is building the container image
`ready`	The build can be referenced by servers and queues
`failed`	The build could not be processed

Version tags

The build name you give it becomes its version_tag. Reference this tag when booting a server directly or when configuring a queue.