Creating a deployment

This page explains how to create, list, and describe Game Servers deployments. A deployment manages one or more software versions that you can deploy to any or all realms.

Before you begin

Before you start, we recommend you familiarize yourself with key concepts in the Game Servers Overview. Make sure you have also performed the following tasks:

  • Ensure that you have enabled the Game Services API.
  • Enable Game Services API
  • Choose a shell with Cloud SDK installed:
  • Cloud Shell

    To launch Cloud Shell, perform the following steps:

    1. Go to Google Cloud Console.

      Google Cloud Console

    2. From the upper-right corner of the console, click the Activate Cloud Shell button:

    A Cloud Shell session opens inside a frame lower on the console. You use this shell to run gcloud commands.

    Local shell

    To install gcloud, install the Cloud SDK, which includes the gcloud command-line tool.

    Verify that you have set desired default project for gcloud command-line tool (otherwise you need to specify flag --project explicitly for each command later):

    gcloud config list project
    

    If not you can run the following command to set a default project, replacing project-id with your desired project ID :

    gcloud config set project project-id
    

    Verify that you are running "Google Cloud SDK" at minimum version 281.0.0:

    gcloud version
    

    If not you can run the following command to update it:

    gcloud components update
    

Creating a deployment

You can create a deployment using the gcloud command-line tool.

To create a deployment, run the following command and replace the deploymentID, with an appropriate value:

gcloud beta game servers deployments create deploymentID

Listing deployments

You can list deployments using the gcloud command-line tool.

To list deployments, run the following command:

gcloud beta game servers deployments list

Describing a deployment

You can obtain details about a deployment, such as the creation time or update time, using the gcloud command-line tool.

To describe a deployment, run the following command and replace deploymentID with the identifier for a deployment you have previously created:

gcloud beta game servers deployments describe deploymentID

What's next