Development roadmap for Amazon GameLift managed containers - Amazon GameLift

Development roadmap for Amazon GameLift managed containers

This roadmap guides you through how to develop an Amazon GameLift managed hosting solution for your containerized game servers. Managed containers is just one hosting solution that is offered by Amazon GameLift. For more information on hosting options, see Amazon GameLift solutions.

A managed container solution with Amazon GameLift has the following components:

  • One or more container fleets, which use Amazon Elastic Compute Cloud (Amazon EC2) instances that are optimized for multiplayer game hosting.

  • A container image with your game server build, uploaded to Amazon Elastic Container Registry (Amazon ECR) private repository. The game server build is integrated with the Amazon GameLift server SDK and built to run on Linux.

  • A backend service that interacts with the Amazon GameLift service on behalf of your game clients. The backend service uses functionality in the Amazon GameLift service API, which is part of the AWS SDK,

  • An Amazon GameLift game session queue that processes requests for new game sessions, searches for available game servers across all fleets, and prompts a game server to start a game session.

  • (Optional) A FlexMatch matchmaker to create multi-player matches and set up game sessions for them.

This roadmap presents a streamlined path to getting your containerized game servers up and running successfully with Amazon GameLift managed containers. After you have the necessary components in place, you can continue to iterate on game development and customize your hosting solution. As you get closer to launch, see these Preparing your game for launch with Amazon GameLift hosting for help with preparing your hosting solution for production-level usage.

Add functionality to your game server so that it can communicate with the Amazon GameLift service when it's deployed for hosting.

  • Get the Amazon GameLift server SDK (version 5.2 or greater) for your game project. The server SDK is available in C++, C#, and Go. Download the Amazon GameLift server SDK. The server SDK is available in C++, C#, and Go.

  • Modify your game server code to add server SDK functionality. For guidance, see Integrate games with custom game servers. At a minimum, do the following:

    • Add code to initialize the Amazon GameLift SDK and establish a WebSocket connection with the Amazon GameLift service. Use the server SDK action InitSdk().

    • Add code to report to the Amazon GameLift service when the server process is ready to host game sessions. Use the server SDK action ProcessReady().

    • Implement the required callback functions OnStartGameSession(), OnProcessTerminate(), and OnRefreshConnection(). With these functions, game server processes can maintain a connection with the Amazon GameLift service, initiate a game session when prompted by Amazon GameLift, and respond to a request to end the game server process.

    • Add code to report to the Amazon GameLift service when the server process is ending a game session. Use the server SDK action ProcessEnding().

  • Package your game server build. Build your game server to run on Linux. Prepare the build and other files that are needed to run the game server. If you’re developing on Windows, this step might involve setting up a separate Linux workspace or using a tool such as Windows subsystem for Linux (WSL). You'll need a Linux environment to test your game server build, and also to build and test your container images.

  • Test your game server integration. Verify that your integrated game server can connect to the Amazon GameLift service and respond to prompts. We recommend setting up a simple Amazon GameLift Anywhere fleet with a local workstation as a test host, as described in Set up local testing with Amazon GameLift Anywhere. Install your game server build onto the test host and start a server process. Use the AWS CLI to request a new game session, and verify that the Amazon GameLift service successfully prompts your server process to start a game session.

Create a way for your game client to request to join a game session, get connection info, and then connect directly to a hosted game session. The most common approach is to set up backend service functionality that serves as a middleman between your game client and the Amazon GameLift service. This approach protects your hosting resources and gives you greater control over how players are placed into game sessions.

  • Build backend service functionality for hosting. The backend service communicates with the Amazon GameLift service and delivers connection information to a game client. This functionality includes starting game sessions, placing players into games, and retrieving game session information. For guidance, see Integrate games with custom game servers. At a minimum, do the following:

  • Add functionality to your game client that lets players join a hosted game session. The game client makes requests to your backend service, not directly to Amazon GameLift. After the backend service provides game session connection information, the game client connects directly with the game session to play the game.

  • Test your game client integration. You can use your existing Amazon GameLift Anywhere fleet with a local workstation for testing. Use the new backend service to request a new game session, and verify that: (1) the Amazon GameLift service successfully prompts your server process to start a game session, and (2) a game client can connect to the game session.

Customize how you want Amazon GameLift to process requests for new game session and locate available game servers to host them. Amazon GameLift automatically tracks the availability of all game servers on all fleets. When a game client sends a request to join a game session, Amazon GameLift looks for the "best possible" placement based on a set of defined priorities such as minimum latency, cost, and availability.

  • Create a game session queue for placing new game session with available game servers. Queues are the primary mechanism for game session placement. For guidance, see Create a game session queue.

    • At minimum, add your Anywhere fleets as destinations in your queue. All other settings are optional customizations.

  • In your backend service code, convert the CreateGameSession() call to StartGameSessionPlacement(). See Create a game session in a multi-location queue.

  • Create a mechanism to notify a game client when a game session is ready to join. While in development, you can poll for game session status using a call to DescribeGameSessionPlacement. Before using a queue to process high volumes, however, you'll need to enable event notifications. See Set up event notification for game session placement.

  • Add FlexMatch matchmaking (optional). Build a matchmaking rule set and create a matchmaking configuration to work with your game session queue. For guidance on setting up a matchmaking system, see the Amazon GameLift FlexMatch developer guide.

  • Test the placement system. You can use your existing Amazon GameLift Anywhere fleet with a local workstation for testing. Use the backend service to request a new game session, and verify that the Amazon GameLift service successfully prompts your server process to start a game session.

After you've successfully integrated your game server, create a container image with your game server executable. Store it in an Amazon Elastic Container Registry (Amazon ECR) repository for use with Amazon GameLift. For detailed instructions, see Build a container image for Amazon GameLift.

  • Get the Dockerfile template for a game server container (provided by Amazon GameLift). Modify the file for your game server build files.

  • Build a game server container image. Working in a Linux environment, use the Docker tool to create your image.

  • Push your container image to Amazon ECR. Create a public or private repository in Amazon ECR, using the same AWS account and AWS Region where you plan to deploy your container fleet. Push your container image to it.

  • Test your container images using your Anywhere fleet (optional). You might want to test your container images locally before deploying them to a cloud-hosted container fleet. You can use your existing Amazon GameLift Anywhere fleet with a local workstation for testing. Install and run the game server container and verify that: (1) the Amazon GameLift service successfully prompts your server process to start a game session, and (2) a game client can connect to the game session.

Up to this point you've worked with a self-managed Anywhere fleet to test and iterate on your game components. The final piece of your solution is to set up the cloud-based hosting resources that you'll need for a production system. To start planning and configuring for production, you want to set up a Amazon GameLift managed container fleet and customize it for production.

  • Create container group definitions. Container group definitions describe the container architecture for a fleet. and identify which container images to deploy. See Create a container group definition for an Amazon GameLift container fleet. Create your container group definition in the same AWS Region where the container images are stored. For more on choosing a fleet location, see Fleet location. At a minimum, do the following:

    • Create a game server container group definition.

    • Add a container definition with a container image with your game server build.

    • Configure a port range for the container's game server processes.

  • Create a managed container fleet. When you create a fleet, Amazon GameLift immediately begins deploying your game server build for hosting. You can configure many aspects of a managed fleet. For guidance, see Create an Amazon GameLift managed container fleet. At minimum, do the following:

    • Set up an AWS Identity and Access Management (IAM) service role for the container fleet. See Set up an IAM service role for Amazon GameLift.

    • Specify the game server container group definition to deploy to fleet instances.

    • Use default values where available for all other parameters. Amazon GameLift calculates some parameters for optimal configuration.

  • Add the container fleets to your queue. In your game session queue, replace the Anywhere test fleet with your managed container fleet.

  • Test game hosting with your container fleets. At this point you should be able to test the entire solution. Start a game client and request a game session through the backend service. Get connection info and connect to a game session on the container fleet.

  • Iterate on your fleet deployments. You can update container group definitions and fleet configurations, and then deploy updates to existing fleets.

As you prepare for game launch, you'll need to fine-tune your managed hosting resources. Some of the decisions to consider include: