3cf3e45b38
* Enable and fix AWS Resource Mapping Tool on Linux - Enable the trait AWSCORE_EDITOR_RESOURCE_MAPPING_TOOL_ENABLED for Linux - Add additional traits to handle launching o3de local python on Linux - Update the resource_mapping_tool.py to support preloading the shared libraries for Pyside (like the QtForPython gem) in order to resolve the local pyside2 libraries Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * Update pyside2 to a RUNTIME dependency Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * Update special linux preloading comments for clarity Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * Add CR at the end of traits files Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * - Remove unnecessary extra argument '--executable-path' and use '--binaries-path' instead - Add linux only loading of pyside modules to 'setup_qt_environment' instead - Update README.md Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * Updated unit tests for test_environment_utils.py Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * Fix indentation for Linux specific logic in environment_utils.py Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * Fix (more) indentation for Linux specific logic in environment_utils.py Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> * Replace exit with return in setup_qt_environment Signed-off-by: Steve Pham <82231385+spham-amzn@users.noreply.github.com> |
4 years ago | |
|---|---|---|
| .. | ||
| controller | 4 years ago | |
| manager | 4 years ago | |
| model | 4 years ago | |
| multithread | 5 years ago | |
| style | 4 years ago | |
| tests | 4 years ago | |
| utils | 4 years ago | |
| view | 4 years ago | |
| README.md | 4 years ago | |
| requirements.txt | 5 years ago | |
| resource_mapping_tool.py | 4 years ago | |
README.md
Welcome to the AWS Core Resource Mapping Tool project!
Setup aws config and credential
Resource mapping tool is using boto3 to interact with aws services:
- Read boto3 Configuration to setup default aws region.
- Read boto3 Credentials to setup default profile or credential keys.
Or follow AWS CLI configuration which can be reused by boto3 lib:
Python Environment Setup Options
1. Engine python environment (Including Editor)
-
In order to use engine python environment, it requires to link Qt binaries for this tool. Follow cmake instructions to configure your project, for example:
$ cmake -B <BUILD_FOLDER> -S . -G "Visual Studio 16 2019" -DLY_3RDPARTY_PATH=<PATH_TO_3RDPARTY> -DLY_PROJECTS=<PROJECT_NAME> -
At this point, double check engine python environment gets setup under <ENGINE_ROOT_PATH>/python/runtime directory
-
Build project with AWSCore.Editor (or AWSCore.ResourceMappintTool, or Editor) target to generate required Qt binaries.
$ cmake --build <BUILD_FOLDER> --target AWSCore.Editor --config <CONFIG> -j <NUM_JOBS> -
At this point, double check Qt binaries gets generated under <BUILD_FOLDER>/bin/<CONFIG_FOLDER>/AWSCoreEditorQtBin directory
-
Launch resource mapping tool under engine root folder:
- Windows
- release mode
$ python\python.cmd Gems\AWSCore\Code\Tools\ResourceMappingTool\resource_mapping_tool.py --binaries_path <PATH_TO_BUILD_FOLDER>\bin\profile\AWSCoreEditorQtBin- debug mode
$ python\python.cmd debug Gems\AWSCore\Code\Tools\ResourceMappingTool\resource_mapping_tool.py --binaries_path <PATH_TO_BUILD_FOLDER>\bin\debug\AWSCoreEditorQtBin - Linux
- release mode
$ python/python.sh Gems/AWSCore/Code/Tools/ResourceMappingTool/resource_mapping_tool.py --binaries_path <PATH_TO_BUILD_FOLDER>/bin/profile/AWSCoreEditorQtBin- debug mode
$ python/python.sh Gems/AWSCore/Code/Tools/ResourceMappingTool/resource_mapping_tool.py --binaries_path <PATH_TO_BUILD_FOLDER>/bin/debug/AWSCoreEditorQtBin
- Windows
- Note - Editor is integrated with the same engine python environment to launch Resource Mapping Tool. If it is failed to launch the tool in Editor, please follow above steps to make sure expected scripts/binaries are present.
2. Python virtual environment
This project is set up like a standard Python project. The initialization
process also creates a virtualenv within this project, stored under the .env
directory. To create the virtualenv it assumes that there is a python3
(or python for Windows) executable in your path with access to the venv
package. If for any reason the automatic creation of the virtualenv fails,
you can create the virtualenv manually.
-
To manually create a virtualenv:
- Windows
$ python -m venv .env- Mac or Linux
$ python3 -m venv .env -
Once the virtualenv is created, you can use the following step to activate your virtualenv:
- Windows
% .env\Scripts\activate.bat- Mac or Linux
$ source .env/bin/activate -
Once the virtualenv is activated, you can install the required dependencies:
- Windows
$ pip install -r requirements.txt- Mac or Linux
$ pip3 install -r requirements.txt -
At this point you can launch tool like other standard python project.
- Windows
$ python resource_mapping_tool.py- Mac or Linux
$ python3 resource_mapping_tool.py
Tool Arguments
--binaries-path[Optional] Path to QT Binaries necessary for PySide, required if launching tool with engine python environment.--config-path[Optional] Path to resource mapping config directory, if not provided tool will use current directory.--debug[Optional] Execute on debug mode to enable DEBUG logging level.--log-path[Optional] Path to resource mapping tool logging directory, if not provided tool will store logging under tool source code directory.--profile[Optional] Named AWS profile to use for querying AWS resources, if not provided tool will usedefaultaws profile.