Clanforge web interface
Documentation for Clanforge web interface
읽는 시간 4분최근 업데이트: 4일 전
There are two primary methods for updating your game image binary (build): though the Clanforge API, or through the Clanforge web interface. This topic details the process for updating through the Clanforge web interface.
Prerequisites
- You have completed the Clanforge Integration Process.
- You have access to your build machine.
- You have an updated game image that you’re ready to deploy to your fleet.
- You have your service identifier document.
Step 1: Deploy the update to your build machine
When your updated game build is ready, the next step is to deploy the updated game image to your build machine.- In a browser window, navigate to https://clanforge.multiplay.co.uk/<ASID>, where <ASID> is your account service ID.
- In the Dev Tools panel, select Game Updates.
- On the Game Image Updates page, select Update Game Image.
-
Complete the fields in the Update Game Image dialog:
- Game: Select the game you want to update.
- Image: Select the image version you want to update.
- Machine: Select your jump machine. This list is highly configurable and can contain multiple jump machines or regular machines from which you can generate an update.
- URL: Enter the URL of your game image repository (for example, Steam, S3, Google Cloud) that you generated to use with Clanforge. Refer to Image Update Create URL parameters.
- Description: Enter a short description of the update.
- Select Update Game Image. This installs the image from your game repository URL to your jump machine.
Step 2: Test the update on your build machine
After you have installed the latest version of your game build to your jump machine, you’ll want to create a test game server to ensure that everything works as expected. You must create the game server with a profile that's linked to the game image version that you updated.- From your Clanforge panel, navigate to your build machine.
- Select Add Server to create a game server instance. This starts a game server separate from the rest of your fleet that you can use specifically for testing.
- Ensure that the server starts up correctly and doesn’t generate any errors.
- Test the server to ensure that the update works correctly.
Step 3: Create a difference analysis
After you successfully test the update on your build machine, the next step is to create a difference analysis (diff analysis) from the changes you just made to the game image on your jump machine. The diff analysis allows you to create a patch with only the required (changed) files, which results in a smaller image size that installs to the rest of your fleet faster than a full image. After you have generated a diff analysis, you can opt to create a full or partial (patch) update to push out to the rest of your machines.- In a browser window, navigate to https://clanforge.multiplay.co.uk/<ASID>, where <ASID> is your account service ID.
- In the Dev Tools panel, select Diff Analysis.
-
Complete the fields in the Game Image Difference Analysis dialog:
- Game: Select the game that you created the update for in the previous section.
- Image: Select the image version that you created the update for in the previous section.
- Machine: Select your jump machine (the machine to which you installed the latest version of your game build in the previous section).
- Select View Differences.
- Review the differences and ensure that there aren’t any unexpected changes. If everything looks correct, select Accept Diff.
Step 4: Deploy the update to your fleet machines
After you have accepted the differences from the diff analysis by using the Clanforge GUI, the Create New Image Version dialog appears. This is where you have the option to roll out a full image (by enabling the Make this image a full image checkbox) or to roll out the differences between this update and the previous one.- If you want to create a full image, enable the checkbox to the right of Make this image a full image. Otherwise, leave this checkbox disabled. It’s recommended that you make a full image for your update every third update because it decreases the size of the game image that’s installed on your machines.
-
Select what you want the servers to do after installing the update by selecting one option from the After creating the image: select form.
- Install it and restart affected servers: Select this option to push the game update to the mirroring network globally, install the files onto each machine, and then restart each game server instance to apply the changes. Note that this option disrupts players unless you’re using the zero downtime patching implementation.
- Install it without restarting: Select this option to push the game update to the mirroring network globally, and then install the files onto each machine without restarting any of the game server instances. This option works well if the update only has changes to asset files. If the update has any changes to files that the current game server is actively using, then the update fails due to these files being locked by an active process.
- Do nothing: Select this option to push the update out to the mirroring network globally without installing it to any of your machines. This option is useful when you want to manually push an update to machines at a later time.
- Select Create Image Version.
- After Clanforge has finished creating the image update, the Installations view appears, which shows the current installation status of the image on each machine. Note that the Installations view doesn't list successfully completed installs.