metaplay deploy server ENVIRONMENT [IMAGE:]TAG [flags] [-- EXTRA_ARGS]

Deploy a game server into a cloud environment using the specified docker image version.

After deploying the server image, various checks are run against the deployment to help diagnose any potential issues:

• All expected pods are present, healthy, and ready.
• Client-facing domain name resolves correctly.
• Game server responds to client traffic.
• Admin domain name resolves correctly.
• Admin endpoint responds with a success code.

When a full docker image tag is specified (eg, 'mygame:364cff09'), the image is first pushed to the environment's registry. If only a tag is specified (eg, '364cff09'), the image is assumed to be present in the remote registry already.

Expected arguments:

• ENVIRONMENT (optional) -- Target environment name or id, eg, 'lovely-wombats-build-nimbly'.
• [IMAGE:]TAG (optional) -- Docker image name and tag, eg, 'mygame:364cff09' or '364cff09'.
• EXTRA_ARGS (optional) -- Passed as-is to Helm.

Related commands:

• 'metaplay build image ...' to build the docker image.
• 'metaplay image push ...' to push the built image to the environment.
• 'metaplay debug logs ...' to view logs from the deployed server.
• 'metaplay debug shell ...' to start a shell on a running server pod.

Examples

# Push the local image and deploy to the environment nimbly.
metaplay deploy server nimbly mygame:364cff09
# Deploy an image that has already been pushed into the environment.
metaplay deploy server nimbly 364cff09
# Deploy the latest locally built image for this project.
metaplay deploy server nimbly latest-local
# Pass extra arguments to Helm.
metaplay deploy server nimbly mygame:364cff09 -- --set-string config.image.pullPolicy=Always
# Use Helm chart from the local disk.
metaplay deploy server nimbly mygame:364cff09 --local-chart-path=/path/to/metaplay-gameserver
# Override the Helm chart repository and version.
metaplay deploy server nimbly mygame:364cff09 --helm-chart-repo=https://custom-repo.domain.com --helm-chart-version=0.7.0
# Override the Helm release name.
metaplay deploy server nimbly mygame:364cff09 --helm-release-name=my-release-name

Flags

• --dry-run: Show what would be deployed without actually performing the deployment
• --helm-chart-repo <string>: Override for Helm chart repository to use for the metaplay-gameserver chart
• --helm-chart-version <string>: Override for Helm chart version to use, eg, '0.7.0'
• --helm-release-name <string>: Helm release name to use for the game server deployment (default to '<environmentID>-gameserver')
• --local-chart-path <string>: Path to a local version of the metaplay-gameserver chart (repository and version are ignored if this is set)
• --values <string>: Override for path to the Helm values file, e.g., 'Backend/Deployments/develop-server.yaml'

Inherited Flags

• --color <string>: Should the output be colored (yes/no/auto)? [env: METAPLAYCLI_COLOR] (default: auto)
• --project <string>: Path to the to project directory (where metaplay-project.yaml is located)
• --skip-version-check: Skip the check for a new CLI version being available
• --verbose: Enable verbose logging, useful for troubleshooting [env: METAPLAYCLI_VERBOSE]