Set up an AWS user profile - Amazon GameLift

Set up an AWS user profile

After installing the plugin, set up a profile and link it to a valid AWS account user. You can maintain multiple profiles, but you can only have one profile active at a time. Whenever you work in the plugin, select a profile to use.

Maintaining multiple profiles gives you the ability to switch between different hosting scenarios. For example, you might set up profiles with the same AWS credentials but different AWS Regions. Or you might set up profiles with different AWS accounts or with different users/permission sets.

Note

If you've installed the AWS CLI on your workstation and have a profile already configured, the Amazon GameLift plugin can detect it and will list it as an existing profile. The plugin automatically selects any profile named [default]. You can use an existing profile or create a new one.

To manage your AWS profiles

  1. In the Unreal editor main toolbar, choose the Amazon GameLift menu, and select Set AWS User Profiles. This action opens Project Settings for the plugin. Expand the section AWS User Profiles.

  2. If the plugin doesn't detect an existing profile, it prompts you to create one. You can create a new profile using either a new or existing AWS account.

    Note

    You need to use the AWS Management Console to create a new AWS account and create or update a user with the proper permission set.

    When setting up a profile, you need the following information:

    • An AWS account. If you need to create a new AWS account, follow the prompts to create the account. See Create an AWS account for more details.

    • An AWS user with permissions to use Amazon GameLift and other required AWS services. See Set up an AWS account for instructions on setting up an AWS Identity and Access Management (IAM) user with Amazon GameLift permissions and programmatic access with long-term credentials.

    • Credentials for your AWS user. These credentials consist of an AWS access key ID and AWS secret key. See Get your access keys for more details.

    • AWS region. This is a geographic location where you want to create your AWS resources for hosting. During development, we recommend using a region close to your physical location. See the list of supported AWS regions.

  3. If the plugin detects an existing profile, you aren't prompted to create one. If you want to update a profile or create a new one, choose Manage your profile.

To bootstrap your profile:

All profiles must be bootstrapped to use with the Amazon GameLift plugin. Bootstrapping creates an Amazon S3 bucket specific to the profile. It's used to store project configurations, build artifacts, and other dependencies. Buckets are not shared between other profiles.

Bootstrapping involves creating new AWS resources and might incur costs.

  1. In the Unreal editor main toolbar, choose the Amazon GameLift icon, and select Set AWS User Profiles. This action opens Project Settings for the plugin. Expand the section AWS User Profiles.

  2. In the Bootstrap your profile section, select a profile from the dropdown list and check the bootstrap status. If the status indicates that no bucket exists, choose the button Bootstrap and create profile to create an Amazon S3 bucket for the selected profile.

  3. Wait for bootstrap status to change to "Active". This can take a few minutes.