Set up the SimSpace Weaver distribution package for Amazon Linux 2 (AL2) in Docker - AWS SimSpace Weaver

Set up the SimSpace Weaver distribution package for Amazon Linux 2 (AL2) in Docker

This section provides instructions for setting up your local SimSpace Weaver distribution zip with an AL2 environment in Docker. For instructions to set up with AL2 in Windows Subsystem for Linux (WSL), see Set up the SimSpace Weaver distribution package for Amazon Linux 2 (AL2) in Windows Subsystem for Linux (WSL).

Requirements
To set up the SimSpace Weaver distribution zip with AL2 in Docker
  1. If you have not already configured your AWS credentials for the AWS CLI, follow these instructions: Configuring the AWS CLI.

  2. Download the SimSpace Weaver app SDK distributable package. It contains the following:

    • Binaries and libraries for SimSpace Weaver app development

    • Helper scripts that automate parts of the development workflow

    • Sample applications that demonstrate SimSpace Weaver concepts

  3. Unzip the file to an sdk-folder of your choice.

  4. Go to the sdk-folder.

  5. Enter the following command to install the required Python packages:

    pip install -r PackagingTools/python_requirements.txt
  6. Enter the following command to setup the SimSpace Weaver distribution with a Docker image.

    python setup.py

    This command does the following:

    • Creates an AL2 docker image with all the requirements for building SimSpace Weaver projects installed.

    • Creates the CloudFormation resources required to launch a simulation.

      • The sample CloudFormation stack template can be found in sdk-folder/PackagingTools/sample-stack-template.yaml

    • Configures the provided sample projects with the correct paths for your local system.

Troubleshooting

  • Docker appears stuck

    • If the console output appears to be stuck after Docker commands are called, try restarting the Docker engine. If that doesn't work, restart your computer.