Use build configurations with development fleets

id: using-build-configs title: Use build configurations with development fleets description: Create and manage build configurations and associate them with development fleets ​ab_authors: Scott Van Woudenberg, Bjorn Hansen ab_contacts: Eric Lin, Scott Van Woudenberg ab_version: 3.40.0

ab_notes:​

Introduction​

Development fleets work in conjunction with Development Dedicated Server Build Configurations, referred to as Build Configurations for brevity here and in the AccelByte Gaming Services (AGS) Admin Portal. This article walks you through creating Build Configurations and how to associate them with development fleets in the dedicated server claim flow.

To learn how to create a development fleet, see Create fleets to deploy dedicated servers. To learn more about development fleets, see the Fleet types.

注記

Claiming a dedicated server from a development fleet will take longer than with a production fleet. This is because development fleets do not maintain a buffer of READY dedicated servers by default. Instead, a development fleet starts each dedicated server on demand at the time a match ticket or session tries to claim one. Since there are no dedicated servers running, the first claim request will fail, even as it triggers the launch of a matching dedicated server. The session will automatically retry the claim after 60 seconds and will then successfully claim the newly launched dedicated server.

Create a Build Configuration​

To create a Build Configuration, follow these steps:

  1. Go to your game namespace in the AGS Admin Portal.

  2. On the sidebar, open the AccelByte Multiplayer Servers menu, expand Development Servers, and select Build Configurations. The Build Configurations page will appear.

  3. Click the Create Config button and select Create New. The Create Config form will appear.

  4. In the Name & Image section, do the following:

    • Type in a name for your Build Configuration. It must be unique within the namespace.

      ヒント

      We recommend naming your Build Configuration using the same string your game client puts in the client_version attribute when it submits a matchmaking ticket or directly creates a game session. This lets you take advantage of the implicit game client version claim key that is automatically added to your claim requests so you do not have to add each Build Configuration name as an explicit claim key to your session template.

    • Choose the dedicated server image you want to run with this Build Configuration. The fleet will start dedicated servers based on this image. You can search for an image by using its image ID or image name.

  5. Click Next to go to the Command Line section.

    • In the Command box, add your dedicated server command line arguments and ensure that you specify any additional parameters required for your dedicated server to run in the desired configuration.

      The command line arguments for your Build Configuration are appended with the associated development fleet's command line arguments. If the required flags are not specified in either the development fleet command line or the Build Configuration command line, no dedicated servers will successfully launch for the fleet.

  6. Click Next to go to the Summary section.

  7. Review your Build Configuration, then click the Create button to finish creating your Build Configuration.

Use Build Configurations with development fleets​

Just like with production fleets, you need to configure your session template to have claim keys that match the claim keys configured on your development fleet. To learn how to create a session template that claims dedicated servers from AccelByte Multiplayer Servers (AMS), see Configure Session service to claim dedicated servers from AMS. To learn how to set claim keys on a fleet, see Assign claim keys to a fleet.

When submitting a matchmaking ticket or directly creating a game session, the game client will use the name of the desired Build Configuration as the client_version attribute in the request, which triggers the matching development fleet to launch a dedicated server using that build configuration. To learn how to add the client_version to a match ticket, see Add version number to match ticket. Remember, the first attempt to claim a dedicated server from a development fleet will fail. AGS Session will automatically retry, but if you are writing your own dedicated server claim flow in your game client, you must build in retries.

As described in the Claim dedicated servers from AMS fleets article, the dedicated server claim request finds the desired fleet by searching for a fleet with a claim key matching any of the claim keys in the request. If the matching fleet is a development fleet, AMS looks for a dedicated server from that fleet that was launched using a Build Configuration with a name matching one of the claim keys from the request. If no dedicated servers are found, AMS will look for a Build Configuration with a name matching one of the claim keys, and launch a new dedicated server using that Build Configuration, so that one will be available to claim when the claim request is retried.

Example​

As an example, assume you have created a development fleet which you want to use for your developers and QA to test dedicated server builds with. You could use the following setup:

  1. Add a test claim key to your development fleet.

  2. Add test as a claim key to the preferred (or fallback) claim keys in the session template, which is configured in the match pool that your game client will use.

    With this setup, your game sessions will try to claim a dedicated server from your development fleet. Now, assume you have a dedicated server build and matching client build, 240506.2.main, which you would like to test using your development fleet.

  3. Create a Build Configuration named "240506.2.main" and choose the uploaded dedicated server image that corresponds to build 240506.2.main.

  4. Make sure that your 240506.2.main game client is using the build version "240506.2.main" as the client_version in the match ticket.

    Your 240506.2.main game clients will matchmake into sessions that will try to claim a dedicated server from your development fleet. This will trigger a dedicated server launch using your "240506.2.main" Build Configuration, and then claim that dedicated server for the session.

    You can then repeat the above two steps to create a Build Configuration for each build that you want to test using this Development fleet.

What's next​

Now that you have your build configuration for your development fleet, you are ready to configure a Play Session to claim dedicated servers from your fleet.

You can also explore different dedicated server claim scenarios.

に最終更新

On this page