Plugin for Unity: Set up an AWS user profile - Amazon GameLift

Plugin for Unity: 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 set up your AWS profile

  1. In the Unity editor main menu, choose Amazon GameLift and select Set AWS Account Profiles. This action opens the plugin window. Open the page AWS User Profiles.

  2. If the plugin detects an existing profile, you won’t be prompted to create one. Select an existing profile or choose Add another profile to create a new one.

  3. 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 account 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.

    • Credentials for your AWS user. This user also needs programmatic access with long-term credentials. 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 to minimize latency. See the list of supported AWS regions.

  4. When you selected or created a profile, check the profile’s bootstrap status and take action as needed. All profiles must be bootstrapped to use Amazon GameLift plugin functionality.

To bootstrap your profile:

Bootstrapping designates an Amazon S3 bucket for use with the selected user profile. Amazon S3 is a core AWS service for data and object storage. The bucket used to store project configurations, build artifacts, and other dependencies. Buckets are not shared between other profiles.

Note

Bootstrapping creates new AWS resources and might incur costs.

  1. When viewing your profiles in the plugin window AWS User Profiles, select the profile you want to use. A warning message is displayed if the profile hasn’t been bootstrapped yet.

  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 profile. You can set the bucket name to a new bucket name, enter an existing bucket that you have access to, or keep the auto-generated name.

  3. Wait for bootstrap status to change to "Active". This can take a few minutes. When the status is “Active”, you can use the profile to work with plugin features