Volumes

How to add a game Part 4 (Volumes)

Containers don't have persistent storage volumes or drives, therefore, volumes must be configured. There are two types: Persistent and Ephemeral.

PVCs

Persistent Volume Claims (PVCs henceforth) need to be defined through the menu. PVCs must be created so servers from your game can have storage.

Creating a PVC

  • PVC Name: There are three name types: Data (primary game data storage), Shared (shared files across instances) or Custom. It's shown as suffix, for example: server-{serverId}-data or server-{serverId}-shared. Whatever is set to custom will be used as a suffix (eg. server-{serverId}-backup)

  • Scope: Whether the PVC is limited to be uniquely assigned to a server or a shared cluster. If it's Per-Server, the PVC will be only available and unique to a specific server. If it's Shared (Cluster), the storage will be shared across all servers in your billing cluster. Soulmask/Ark: Survival Evolved use this system, for example. For games using this, the controller will ensure servers using this PVC are scheduled on the same node.

  • Storage Size: Specifies the size of the storage in Gi(gigabytes) or Mi(megabytes). Eg: 10Gi (10 GBs) while 800Mi (800 MBs).

  • Description: Simple written description of the purpose of the PVC.

Ephemeral Volumes

Another type of volumes for containers. Unlike PVCs, Ephemeral (emptyDir), as their name implies, are not persistent. In this section, temporary storage volumes shared between containers within a pod can be defined.

Data in Ephemeral volumes is erased when the pod is terminated.

  • Use Case: Share tokens, temporary files, or cache between init containers and main containers. Init containers run and complete their tasks before the main application container starts.

  • Storage Medium: Disk uses node storage, Memory (in tmpfs) uses RAM which is faster but limited.

  • Size Limit: Optional, but recommended for Memory medium to prevent out-of-memory issues.