Run a Open Simulator grid server in a AWS EC2 instance.
In order to successfully deploy your application you must have set-up your AWS Config and have created an IAM user with the following policies:
WARNING: The policies above are provided to ensure a successful EC2 deployment. It is recommended that you adjust these policies to meet the security requirements of your grid server. They should NOT be used in a Production environment.
$ aws ec2 run-instances --image-id ami-05fa00d4c63e32376 --instance-type t2.small --region us-east-1a --block-device-mappings file://block-device-mapping.json --user-data file://user-data.sh --associate-public-ip-address
As part of the installation process an SSM Agent is added which allows you to access your server using the Amazon EC2 Console. No SSH keys, port 22 routing necessary.
$ docker exec -it <container-id> /bin/bash
The following command can be executed within the Docker container:
$ service grid-server {start|stop|restart}
In cases where you have an existing server set-up (e.g. configuration) follow the steps below:
$ docker cp OpenSim.ini <container-id>:/usr/games/OpenSim.ini
$ docker cp Region.ini <container-id>:/usr/games/Regions/Region.ini
..
$ docker -it <container-id> /usr/sbin/service grid-server restart
If you have an existing database (MySQL backup *.sql) that you want to use, thereby overriding the installation default, you will need to manually run the server launch operations using the following workflow:
$ docker run -d --network host --restart always --env EXTERNAL_IP=<ip-address> marcsbrooks/docker-opensimulator-server:latest sleep infinity
$ docker cp <filename>.sql <container-id>:/tmp/opensim.sql
$ docker exec -d <container-id> /usr/games/launch.sh
Please note the configured OpenSim release version since older databases may introduce backwards compatibility issues.
If you fix a bug, or have a code you want to contribute, please send a pull-request with your changes.
This package is maintained under the Semantic Versioning guidelines.
This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.
aws-ec2-opensimulator is provided under the terms of the MIT license
AWS is a registered trademark of Amazon Web Services, Inc.