View a markdown version of this page

Plugin for Unity: Set up an Amazon user profile - Amazon GameLift Servers
Bootstrap a user profile
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Plugin for Unity: Set up an Amazon user profile

After installing the plugin, set up a user profile with a valid Amazon account. You can maintain multiple profiles in the plugin, but you can have only one profile selected at a time. Whenever you work in the plugin, select a profile to use. Each workflow page displays the currently selected profile.

Maintaining multiple profiles gives you the ability to switch between different hosting deployments. For example, you might set up profiles that use the same Amazon account but deploy to different Amazon Regions. Or you might set up profiles with different Amazon accounts or users and permission sets.

Note

If you've installed the Amazon CLI on your workstation and have a profile already configured, the Amazon GameLift Servers plugin will detect it and 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.

All profiles must be bootstrapped to set up some required Amazon resources under your account user.

To manage your Amazon profiles

  1. In the Unity main toolbar, choose the Amazon GameLift Servers menu, and select Amazon Access Credentials. This action opens the Amazon GameLift Servers plugin to the page Set up your user profile.

  2. Use the buttons to create a new Amazon account or set up a user profile for an Amazon account that you already have.

  3. If you don't already have a user profile, you're prompted to enter profile details and create a new profile. Provide the following information:

    • An Amazon account. If you create a new Amazon account, use the link to the Amazon Web Services Management Console and follow the prompts. See Create an Amazon account for more details.

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

      Note

      The "Set up an IAM service role" step is optional for plugin users. You only need an IAM service role if your game server accesses other Amazon resources, such as Amazon S3 or DynamoDB.

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

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

  4. If the plugin detects existing profiles, it displays a list of available profiles. Select an existing profile from the list, or choose Add another profile to create a new one.

Bootstrap a user profile

All profiles must be bootstrapped to use with the Amazon GameLift Servers 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 Amazon resources and might incur costs.

To bootstrap your profile:

  1. On the Amazon Access Credentials page, check the bootstrap status of the user profile that you wan to use. If the profile's bootstrap status is "Inactive" and there's no S3 bucket listed, you need to bootstrap the profile.

  2. Select the profile you want to use and choose Bootstrap profile.

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