Skip to content

Now available! Cloud-based open source software (OSS) that enables infrastructure cooperation with automated driving technology through Transportation Systems Management and Operations (TSMO).

Notifications You must be signed in to change notification settings

ashdwilson/carma-cloud

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

86 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CARMA Cloud

Documentation

CARMA Cloud provides some of the infrastructure components for CARMA. It enables users to define geofences, rules of practice, replay storms to test weather-related rules of practice, as well as monitor CARMA-enabled vehicles and the messages and controls exchanged with them.

Deployment

CARMA Cloud can be deployed using docker-compose. Ensure that you have a publicly-accessible Linux server with ports 80 and 443 inbound from the Internet permitted in the firewall rules, and with a DNS name pointed to the server's public IP address.

Clone this repository onto the Linux server using git. Copy the .env.example file to .env and populate the environment variables as follows:

Variable name Purpose
DNS_NAME This is the DNS name of the Linux server.
CARMA_ADMIN_USER This will be the administrative username for the application.
CARMA_ADMIN_PASSWORD This is the password for the administrative user.
MAPBOX_ACCESS_TOKEN This is the API token for Mapbox.
IMPLEMENTER_EMAIL This is your email address, used in the process of getting Letsencrypt certificates.

Once the .env file is populated, run sudo docker-compose up -d. You can monitor your logs with sudo docker-compose logs -f

Errors

The most likely error you'll encouter will occur when a new patch release for Tomcat happens. This may cause the build to fail. To quickly align to the correct version, adjust the TOMCAT_VERSION environment variable in the carma-cloud service dockerfile at dockerfiles/carma-cloud.dockerfile

Contribution

Welcome to the CARMA contributing guide. Please read this guide to learn about our development process, how to propose pull requests and improvements, and how to build and test your changes to this project. CARMA Contributing Guide

Code of Conduct

Please read our CARMA Code of Conduct which outlines our expectations for participants within the CARMA community, as well as steps to reporting unacceptable behavior. We are committed to providing a welcoming and inspiring community for all and expect our code of conduct to be honored. Anyone who violates this code of conduct may be banned from the community.

Attribution

The development team would like to acknowledge the people who have made direct contributions to the design and code in this repository. CARMA Attribution

License

By contributing to the Federal Highway Administration (FHWA) Connected Automated Research Mobility Applications (CARMA), you agree that your contributions will be licensed under its Apache License 2.0 license. CARMA License

Contact

Please click on the CARMA logo below to visit the Federal Highway Adminstration(FHWA) CARMA website. For more information, contact CARMA@dot.gov.

CARMA Image

About

Now available! Cloud-based open source software (OSS) that enables infrastructure cooperation with automated driving technology through Transportation Systems Management and Operations (TSMO).

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Java 54.2%
  • JavaScript 33.6%
  • CSS 9.9%
  • HTML 1.8%
  • Dockerfile 0.2%
  • C 0.2%
  • Shell 0.1%