zeuz Multiplayer Operations documentation

Welcome to the zeuz Multiplayer Operations documentation. Here, you'll find the zuez User Manual and API reference. You can also check out the Helpdesk and Knowledge Base.

User Manual    API Reference

Orchestration introduction

The zeuz orchestration is a set of modules that allows you to manage the automated, region-based allocating and deallocating of bare-metal and cloud machines, as well as the initial provisioning, upscaling and downscaling of containerized services.

Using zeuz services like Lobby or Matchmaking in addition to the pure orchestration can drastically increase performance and reduce waiting time for your players.

Images

As an image, we describe the collection of files needed to run your game server. After uploading and pushing your files, our services are creating a Docker image to easily deploy your payload to machines all over the world.

You can manage your images with our zeuztool CLI or by Image Manager API.

Payload

A payload is a uniquely identifiable instance of a game server session currently running or previously running as a containerized service.
Our APIs payload endpoint allows spawning, updating, shutdown, reserving and unreserving payloads.

Free payload capacity

In your allocation, you configure a free payload capacity. This is the desired amount of free resources to spawn payloads instantly.

Unreserved payloads

In your allocation, you configure a desired amount of unreserved payloads. These payloads are already running and ready for users to connect.

Allocation

An allocation is a set of data and rules that describe how hardware resources and payloads should be managed by our scaler:

  • Basic information (free text name, regions, …)

  • Payload definition (which payload to use, how to start it up)

  • Payload quota (needed resources for one running payload like CPU, RAM, storage or network connectivity)

  • Scaling rules (how we should scale, so there are enough spare resources for you, but not too many lying around unused)

Allocations can be completely managed using our API or with the user interface in the zeuz control panel. You can dig deeper into how to create allocations.

Scaler

Our scaler is the heart of the orchestration service. With an allocation you set up, it scales to bare-metal, bare-metal on demand and common cloud providers (AWS, Azure, GCP). We call this feature Hybrid Cloud.

Hybrid Cloud

Hybrid Cloud gives your games the best value for your money. Depending on your current load different types of machine sources are used.

Learn more about Hybrid Cloud

Bare-metal machines

Bare-metal machines are concrete machines bound to one customer. They are highly optimized to run games. Hardware can be tailored to your needs.

These machines can be booked for at least one month.

To set up bare-metal machines just contact your customer success manager or our sales team via [email protected] or +49 (0) 69 380766676.

Bare-metal on demand

zeuz has a pool of machines in every region, that is available to retort high loads. You can configure access to these machines by setting the max amount of bare-metal machines in your allocations scaling rules.

Machines used as bare-metal on demand are paid per hour or part thereof.

To set up bare-metal on demand quota just contact your customer success manager or our sales team via [email protected] or +49 (0) 69 380766676.

Cloud connection

In peak times, when your bare-metal contingent and bare-metal on demand exceeds its capacity, we manage scaling into the cloud using your existing cloud setup with AWS, Azure or GCP.

Tutorials

Comparison sheet

Type

Min. duration

Optimized for games

Availability

Customers per machine

Price

Bare-metal

1 month

Maximally

Fix
As booked in advance

1

Efficient

Bare-metal on demand

1 hour

Highly

Dynamic
As zeuz pool has capacity and agreed quota in advance

1

Reasonable

Cloud

Depends on Cloud provider (often minute-based)

No

Dynamic
As quota agreement with cloud provider

Decided by provider. Mostly more than 1

Expensive

Integration into zeuz matchmaker

Our matchmaking service is able to communicate with the scaler to automatically adjust allocations temporarily based on your real needs in the near future. Therefore using the combination of the orchestration and matchmaking is more than the sum of its parts.

You can easily set up zeuz matchmaking to talk to the orchestration

Updated 4 days ago


Orchestration introduction


The zeuz orchestration is a set of modules that allows you to manage the automated, region-based allocating and deallocating of bare-metal and cloud machines, as well as the initial provisioning, upscaling and downscaling of containerized services.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.