AWS gamelift documentation change
Summary
Updated documentation to reflect product name changes from 'Amazon GameLift' to 'Amazon GameLift Servers' throughout the document. Changed section titles, service references, console/API tool mentions, and plugin links to align with new naming conventions.
Security assessment
The changes are primarily branding/naming updates without any mention of security vulnerabilities, patches, or new security features. While there is a reference to security in port mapping ('protecting your game servers from direct access'), this is existing security documentation being carried forward with updated product names rather than new security content.
Diff
diff --git a/gamelift/latest/developerguide/containers-howitworks.md index f9cc01043..8365ce3e5 100644 --- a/gamelift/latest/developerguide/containers-howitworks.md +++ b/gamelift/latest/developerguide/containers-howitworks.md @@ -3 +3 @@ -[Documentation](/index.html)[Amazon GameLift](/gamelift/index.html)[Developer Guide](gamelift-intro.html) +[Documentation](/index.html)[Amazon GameLift](/gamelift/index.html)[Hosting Guide](gamelift-intro.html) @@ -7 +7 @@ Container fleet componentsCommon architecturesCore features -# How containers work in Amazon GameLift +# How containers work in Amazon GameLift Servers @@ -9 +9 @@ Container fleet componentsCommon architecturesCore features -Amazon GameLift container fleets are designed to give you flexibility in how you deploy and scale your containerized applications. It uses the Amazon Elastic Container Service (Amazon ECS) to manage task deployment and execution for your Amazon GameLift fleets. This topic describes the basic structural elements for running containers on an Amazon GameLift managed fleet, illustrates common architectures, and outlines some core concepts. +Amazon GameLift Servers container fleets are designed to give you flexibility in how you deploy and scale your containerized applications. It uses the Amazon Elastic Container Service (Amazon ECS) to manage task deployment and execution for your Amazon GameLift Servers fleets. This topic describes the basic structural elements for running containers on an Amazon GameLift Servers managed fleet, illustrates common architectures, and outlines some core concepts. @@ -13 +13 @@ Amazon GameLift container fleets are designed to give you flexibility in how you - * The [containers starter kit](https://github.com/aws/amazon-gamelift-toolkit/tree/main/containers-starter-kit) streamlines integration and fleet setup. It adds essential game session management features to your game server, and uses pre-configured templates to build a container fleet and an automated deployment pipeline for your game server. After deployment, use the Amazon GameLift console and API tools to monitor fleet performance, manage game sessions, and analyze metrics. + * The [containers starter kit](https://github.com/aws/amazon-gamelift-toolkit/tree/main/containers-starter-kit) streamlines integration and fleet setup. It adds essential game session management features to your game server, and uses pre-configured templates to build a container fleet and an automated deployment pipeline for your game server. After deployment, use the Amazon GameLift Servers console and API tools to monitor fleet performance, manage game sessions, and analyze metrics. @@ -15 +15 @@ Amazon GameLift container fleets are designed to give you flexibility in how you - * For Unreal Engine or Unity developers, use the [Amazon GameLift plugins](https://aws.amazon.com/gamelift/getting-started/) to integrate your game server and build a container fleet from inside your game engine's development environment. The plugin's guided workflows help you create a fast, simple solution with cloud-based hosting using managed containers. Then build on this foundation to create a custom hosting solution for your game. + * For Unreal Engine or Unity developers, use the [Amazon GameLift Servers plugins](https://aws.amazon.com/gamelift/servers/getting-started/) to integrate your game server and build a container fleet from inside your game engine's development environment. The plugin's guided workflows help you create a fast, simple solution with cloud-based hosting using managed containers. Then build on this foundation to create a custom hosting solution for your game. @@ -25 +25 @@ Amazon GameLift container fleets are designed to give you flexibility in how you -A container fleet is a collection of Amazon EC2 instances to host your containerized game servers. These instances are managed by Amazon GameLift on your behalf. When you create a fleet, you configure how the container architecture with your game server software is deployed to each fleet instance. You can create a container fleet with instances in one or multiple geographic locations. You can use Amazon GameLift scaling tools to automatically scale a container fleet's capacity to host game sessions and players. +A container fleet is a collection of Amazon EC2 instances to host your containerized game servers. These instances are managed by Amazon GameLift Servers on your behalf. When you create a fleet, you configure how the container architecture with your game server software is deployed to each fleet instance. You can create a container fleet with instances in one or multiple geographic locations. You can use Amazon GameLift Servers scaling tools to automatically scale a container fleet's capacity to host game sessions and players. @@ -30 +30 @@ A container fleet is a collection of Amazon EC2 instances to host your container -An Amazon EC2 instance is the virtual server that provides compute capacity for game hosting. With Amazon GameLift, you can choose from a range of instance types. Each instance type offers a different combination of CPU, memory, storage, and networking capacity. +An Amazon EC2 instance is the virtual server that provides compute capacity for game hosting. With Amazon GameLift Servers, you can choose from a range of instance types. Each instance type offers a different combination of CPU, memory, storage, and networking capacity. @@ -32 +32 @@ An Amazon EC2 instance is the virtual server that provides compute capacity for -When you create a container fleet, Amazon GameLift deploys your containers based on the instance type you choose and your fleet configuration. Each deployed fleet instance is identical and runs your containerized game server software in the same way. The number of instances in a fleet determines the fleet's size and game hosting capacity. +When you create a container fleet, Amazon GameLift Servers deploys your containers based on the instance type you choose and your fleet configuration. Each deployed fleet instance is identical and runs your containerized game server software in the same way. The number of instances in a fleet determines the fleet's size and game hosting capacity. @@ -37 +37 @@ When you create a container fleet, Amazon GameLift deploys your containers based -Amazon GameLift uses the concept of a container group to describe and manage a set of containers. A container group is similar to a container "task" or "pod". Within each container group, you can define how containers behave, set up dependencies, and share available CPU and memory resources. +Amazon GameLift Servers uses the concept of a container group to describe and manage a set of containers. A container group is similar to a container "task" or "pod". Within each container group, you can define how containers behave, set up dependencies, and share available CPU and memory resources. @@ -53 +53 @@ Each container group in a container fleet has one container that's designated "e -The container is the most basic element of a container-based architecture. It includes a container image with software executables and dependent files. Define a container to configure how the software runs and interacts with Amazon GameLift. +The container is the most basic element of a container-based architecture. It includes a container image with software executables and dependent files. Define a container to configure how the software runs and interacts with Amazon GameLift Servers. @@ -55 +55 @@ The container is the most basic element of a container-based architecture. It in -Amazon GameLift defines two types of containers: +Amazon GameLift Servers defines two types of containers: @@ -81 +81 @@ This second diagram illustrates a more complex container fleet architecture. In -This section summarizes how Amazon GameLift implements some basic container concepts. For instructions on how to work with container fleets, see the relevant topics in this guide. +This section summarizes how Amazon GameLift Servers implements some basic container concepts. For instructions on how to work with container fleets, see the relevant topics in this guide. @@ -87 +87 @@ Managed containers provides advanced support to help you manage the life cycle o - * Manage container group definition updates and versioning. You can update nearly all properties of a container group definition, including container images and configuration settings. Whenever you update a container, Amazon GameLift automatically assigns a version number to the update and by default maintains all versions. You can access any specific version, and you can delete versions as desired. When creating a container fleet, you can specify the container group definition and version to deploy. + * Manage container group definition updates and versioning. You can update nearly all properties of a container group definition, including container images and configuration settings. Whenever you update a container, Amazon GameLift Servers automatically assigns a version number to the update and by default maintains all versions. You can access any specific version, and you can delete versions as desired. When creating a container fleet, you can specify the container group definition and version to deploy. @@ -102 +102 @@ Managed containers provides advanced support to help you manage the life cycle o -The ability to update active fleets is highly useful when you want to deploy an update to your game server software. After you've built a new container image for your game server, deploying it is a two-step process: first, update the container group definition with the new image, and second, update the container fleet. Amazon GameLift handles all other tasks as needed. +The ability to update active fleets is highly useful when you want to deploy an update to your game server software. After you've built a new container image for your game server, deploying it is a two-step process: first, update the container group definition with the new image, and second, update the container fleet. Amazon GameLift Servers handles all other tasks as needed. @@ -108 +108 @@ When developing your container structure for deployment in a container fleet, a -Amazon GameLift helps you do this by calculating the maximum game server container groups per instance, based on the following information: +Amazon GameLift Servers helps you do this by calculating the maximum game server container groups per instance, based on the following information: @@ -127 +127 @@ A container fleet is configured to run a specific number of concurrent game serv -With container fleets, you can use any of the capacity scaling methods provided by Amazon GameLift. These include: +With container fleets, you can use any of the capacity scaling methods provided by Amazon GameLift Servers. These include: @@ -140 +140 @@ With container fleets, you can use any of the capacity scaling methods provided -With Amazon GameLift managed fleets, game clients connect directly to your cloud-hosted game servers. When a game client asks to join a game, Amazon GameLift finds a game session and provides connection information (IP and port) to the game client. You can control external access to fleet instances by opening certain port ranges (inbound permissions) for the fleet. Inbound permissions determine which ports are open to incoming traffic. You can quickly shut down all ports, limit to a few, or open all ports. +With Amazon GameLift Servers managed fleets, game clients connect directly to your cloud-hosted game servers. When a game client asks to join a game, Amazon GameLift Servers finds a game session and provides connection information (IP and port) to the game client. You can control external access to fleet instances by opening certain port ranges (inbound permissions) for the fleet. Inbound permissions determine which ports are open to incoming traffic. You can quickly shut down all ports, limit to a few, or open all ports. @@ -151 +151 @@ Managed container fleets require an additional setting that allows access to pro -When you set the internal-facing container port settings, Amazon GameLift uses them to calculate the external-facing inbound permissions that game clients and other applications can connect to. Amazon GameLift also manages the mapping between inbound permissions and individual container ports that gives players access to an game session in a container. This internal mapping provides a layer of security by protecting your game servers from direct access to the container ports. You have the option to customize a fleet's external-facing port settings as needed. For more information about manually setting container fleet ports, see [Configure network connections](./containers-design-fleet.html#containers-custom-network). +When you set the internal-facing container port settings, Amazon GameLift Servers uses them to calculate the external-facing inbound permissions that game clients and other applications can connect to. Amazon GameLift Servers also manages the mapping between inbound permissions and individual container ports that gives players access to an game session in a container. This internal mapping provides a layer of security by protecting your game servers from direct access to the container ports. You have the option to customize a fleet's external-facing port settings as needed. For more information about manually setting container fleet ports, see [Configure network connections](./containers-design-fleet.html#containers-custom-network). @@ -155 +155 @@ You can modify a container fleet's port settings at any time. This change requir -The following diagram illustrates the role of port connections across a container fleet. As shown, you set ports on individual containers, and Amazon GameLift uses this information to configure enough ports on the fleet instance to map to each container port. Both the external-facing instance inbound permissions and the internal-facing connection ports are calculated by Amazon GameLift for your fleet, unless you choose to set them manually. +The following diagram illustrates the role of port connections across a container fleet. As shown, you set ports on individual containers, and Amazon GameLift Servers uses this information to configure enough ports on the fleet instance to map to each container port. Both the external-facing instance inbound permissions and the internal-facing connection ports are calculated by Amazon GameLift Servers for your fleet, unless you choose to set them manually. @@ -172 +172 @@ In managed container fleets, the standard output (and standard error) streams ar -Amazon GameLift sends log data from managed container fleets to the CloudWatch or Amazon S3 services in your AWS account. To view your data, use the AWS Management Console or other tools by signing in to your AWS account and working with the individual services. You extend limited access to Amazon GameLift to take these actions by creating a service role for your container fleets. +Amazon GameLift Servers sends log data from managed container fleets to the CloudWatch or Amazon S3 services in your AWS account. To view your data, use the AWS Management Console or other tools by signing in to your AWS account and working with the individual services. You extend limited access to Amazon GameLift Servers to take these actions by creating a service role for your container fleets. @@ -176 +176 @@ You can modify a container fleet's logging configuration at any time. This chang -### Container fleets and the Amazon GameLift Agent +### Container fleets and the Amazon GameLift Servers Agent @@ -178 +178 @@ You can modify a container fleet's logging configuration at any time. This chang -A commonly used container architecture runs a single process in each container. In an Amazon GameLift container fleet, the game server container group has one game server container, which runs one game server process. With this architecture, Amazon GameLift manages the lifecycle of the single game server process in each game server container group on a fleet instance. +A commonly used container architecture runs a single process in each container. In an Amazon GameLift Servers container fleet, the game server container group has one game server container, which runs one game server process. With this architecture, Amazon GameLift Servers manages the lifecycle of the single game server process in each game server container group on a fleet instance. @@ -182 +182 @@ If you opt to build a container architecture that runs multiple game server proc -You can choose to use the Amazon GameLift Agent for these tasks. For a container fleet, the Agent implements runtime instructions that specify which executables to run (and how many), provide launch parameters, and set rules around game server activation. For example, runtime instructions might tell the Agent to maintain ten game server processes for production use, and one game server process with special launch parameters for testing. +You can choose to use the Amazon GameLift Servers Agent for these tasks. For a container fleet, the Agent implements runtime instructions that specify which executables to run (and how many), provide launch parameters, and set rules around game server activation. For example, runtime instructions might tell the Agent to maintain ten game server processes for production use, and one game server process with special launch parameters for testing. @@ -184 +184 @@ You can choose to use the Amazon GameLift Agent for these tasks. For a container -To use the Agent with your container fleets, add the Agent to your container image and include a set of runtime instructions. For more information about the Agent, see [Work with the Amazon GameLift Agent](./integration-dev-iteration-agent.html). +To use the Agent with your container fleets, add the Agent to your container image and include a set of runtime instructions. For more information about the Agent, see [Work with the Amazon GameLift Servers Agent](./integration-dev-iteration-agent.html). @@ -192 +192 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -How Amazon GameLift works +How Amazon GameLift Servers works