IN THIS ARTICLE
Getting Started with AWS Gems
To get started using AWS Gems with AWS services in your O3DE project, complete the following steps.
Create an AWS account if you don’t have one.
Configure AWS credentials following the instructions in Configuring AWS Credentials for O3DE .
a. Confirm you have credentials using the command
aws configure list
.Install the AWS Cloud Development Kit (CDK) .
a. Confirm the CDK is setup using the command
cdk --version
.Build your O3DE project with the AWS Core Gem (and other AWS Gems you need) enabled.
Deploy the CDK applications for the AWS Gems you have enabled. See Deploying the CDK Application for instructions.
Configure a resource mapping file using the Resource Mapping Tool .
Associate the resource mapping file with the project. See the next section entitled Project Settings .
You should now be able to utilize AWS functions in Lua script, Script Canvas, or C++ to communicate with your AWS resources. See Scripting with AWS Core for scripting examples.
Project settings
On start up the AWS Core Gem will look for the awscoreconfiguration.setreg
file in the project’s registry directory: <ProjectName>\Registry
.
You will need to create this file if you want to set any of the following options. Use the format shown in the example.
Setting | Description |
---|---|
ProfileName | [Optional] The project will use your default profile in ./aws/credentials (on macOS and Linux) or %USERPROFILE%\.aws\credentials (on Windows). Override the default profile or any environment variable setting by using this variable. Must be a named profile in your credentials file. |
ResourceMappingConfigFileName | [Optional] The name of the resource mapping file to load while starting up. Resource mapping files are expected to be located in <ProjectName>\Config . See
Resource Mapping Files
for more information. |
Note:If you make changes to this file, you will need to restart the O3DE Editor.
Example registry settings file:
{
"Amazon":
{
"AWSCore": {
"ProfileName": "testprofile",
"ResourceMappingConfigFileName": "default_aws_resource_mappings.json"
}
}
}