/cloud_station_deployment

Scripts, conf. files and instructions to deploy CloudStation. A complete description is given about how we deployed using AWS services.

Primary LanguageShell

cloud_station_deployment

The instructions describe our setup process on an EC2 instance running Ubuntu 18.04 LTS. The steps should be similar if you use a server with Linux Distributions.

Source code of the CloudStation web app

Deployment Instructions:

  1. Launch an EC2 instance on AWS with Ubuntu 18.04 LTS
    • t2.micro (free-tier eligible) is good enough to test the deployment.
    • Step 6: Configure Security Group (AWS EC2 Console)
      • SSH (TCP) Port:22 Source:My IP
      • HTTP(TCP) Port:80 Source:Anywhere
      • Custom UDP Rule Port:14550 Source:Anywhere
        • MAVLink(vehilce messages) is routed to 14550 via UDP in the current configuration. Any available port can be used instead of 14550.
    • Create or use existing key pairs. This is used for SSH.
  2. Associate an Elastic IP to the EC2
    • "An Elastic IP address is a static IPv4 address". It is a public address we use so the IP address of the deployed CloudStation will stay the same.

    Learn more about it here: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/elastic-ip-addresses-eip.html?icmpid=docs_ec2_console

    • This is only a temporary solution but it serves our testing purpose well.
  3. Connect to Linux instance using an SSH client
  4. Set up EC2 (run only once)
    run bash setup_server.sh
    The script does the following：
    1. Update Ubuntu
    2. Install NGINX and docker
    3. Clone cloud_station_web source code
    4. Set up Python virtual environment (install dependencies)
  5. Modify cloud_station_web/webgms/settings.py
    • Add EC2 IP address to ALLOWED_HOST
    • Set DEBUG to False
  6. Configure NGINX, Daphne and Django (run only once)
    run bash configure_web_server.sh
    The script does the following:
    1. Write database migrations
    2. Collect staticfiles to ~cloud_station_web/static
    3. Configure NGINX with nginx.conf
    4. Configure systemctl to automatically run Daphne as a service(daphne.service)
    5. Download redis and start running redis in a docker container
  7. Reload server (after a code update)
    run bash reload_server.sh
    The script does the following:
    1. Write database migrations
    2. Collect staticfiles
    3. Reload NGINX and Daphne
    4. Run django_background_tasks

CI/CD

Authors

  • Lyuyang Hu
  • Omkar Pathak

Troubleshooting