Prepare an application in Amazon GameLift Streams

Sign in to the AWS Management Console and open the Amazon GameLift Streams console. Choose the same AWS Region as the Amazon S3 bucket where you uploaded your set of files. For more information, refer to Choosing a Region in the AWS Management Console Getting Started Guide.

In the navigation bar, choose Applications and then choose Create application.

In Runtime settings, enter the following:

1. Runtime environment

   This is the runtime environment to run your application on. Amazon GameLift Streams can run on either Windows, Ubuntu 22.04 LTS, or Proton.

   You cannot edit this field after the creation workflow.

   Choose from one of the following runtime environments.

   • For Linux applications:

     • Ubuntu 22.04 (UBUNTU, 22_04_LTS)

   • For Windows applications:

     • Microsoft Windows Server 2022 Base (WINDOWS, 2022)

     • Proton 8.0-5 (PROTON, 20241007)

     • Proton 8.0-2c (PROTON, 20230704)

   Review the descriptions and use the comparison checklist to help you select the optimal runtime environment for your application.

In General settings, enter the following:

1. Description

   This is a human-readable label for your application. This value does not have to be unique. For best practice, use a meaningful description, name, or label for the application. You can edit this field at any time.

2. Base path

   This is the Amazon S3 URI to your application's root folder in the Amazon S3 bucket. The folder and any subfolders should contain your build executable and any supporting files.

   A valid URI is the bucket prefix that contains all the files needed to run and stream the application. For example, a bucket called mygamebuild contains three complete versions of the game build files, each in a separate folder. You want to stream the build in the folder mygamebuild-EN101. In this example, the URI is s3://amzn-s3-demo-bucket/mygamebuild-EN101.

   You cannot edit this field after the creation workflow.

3. Executable launch path

   This is the Amazon S3 URI to the executable file that Amazon GameLift Streams will stream. The file must be contained within the application's root folder.

   You cannot edit this field after the creation workflow.

(Optional) In Application log path, enter the following:

1. Application log path

   This is the path (or paths) to the application folder or file which contains logs that you want to save. Specify each log path relative to your application base path. If you use this feature, then at the end of every stream session, Amazon GameLift Streams will copy the file(s) that you specify to the Amazon S3 bucket that you name. The copy operation is not performed recursively in an application folder's subfolders.

   You can edit this field at any time.

2. Application log output

   This is the URI to the Amazon S3 bucket where Amazon GameLift Streams will copy application log files. This field is required if you specify an application log path.

   You can edit this field at any time.

   To save log files on your behalf, Amazon GameLift Streams must be given permission to your S3 bucket for saving. If you let Amazon GameLift Streams create the bucket for logging, the permission policy will be applied automatically upon creation. If you provide your own bucket, you will need to apply the permission policy, yourself.

   Bucket permission policy template

   Copy the following policy code and apply it to the bucket that you want to use for application logs. Be sure to replace amzn-s3-demo-bucket with the name of your existing S3 bucket.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Sid": "PutPolicy",
         "Effect": "Allow",
         "Principal": {
           "Service": [
             "gameliftstreams.amazonaws.com"
           ]
         },
         "Action": "s3:PutObject",
         "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/*"
       }
     ]
   }

(Optional) In Tags, assign tags to this application.

Tags are labels that can help you organize your AWS resources. For more information, refer to Tagging your AWS resources.

For example to track application versions, use a tag such as application-version : my-game-1121.

Choose Create application.

In the navigation bar, choose Applications to view a list of your existing applications. Choose the application you want to edit.

In the application details page, locate the section that contains the settings you want to change and choose Edit or Manage tags accordingly.

You can change the following settings:

Choose Save changes. The Amazon GameLift Streams console returns to the application details page, displaying the updated settings.

Sign in to the AWS Management Console and open the Amazon GameLift Streams console.

In the navigation bar, choose Applications to view a list of your existing applications. Choose the application you want to delete.

In the application detail page, choose Delete.

In the Delete dialog box, confirm the delete action.