ciceron/atlas repository overview

⁠Atlas the AWA demonstrator

Atlas is an online application that provides a blogging system, a question & answer area, a wiki space and a document storage space. It shows the different plugins and features provided by the Ada Web Application⁠ framework. The goal of Atlas is to show you some interesting features provided by Ada Web Application so that you can try them, look at their implementation and learn how you may use and extend Ada Web Application⁠ for your own needs.

To build Atlas you will need the following projects:

• AWA (https://github.com/stcarrez/ada-awa⁠)
• ASF (https://github.com/stcarrez/ada-asf⁠)
• Ada Servlet (https://github.com/stcarrez/ada-servlet⁠)
• ADO (https://github.com/stcarrez/ada-ado⁠)
• Ada Util (https://github.com/stcarrez/ada-util⁠)
• Ada Wiki (https://github.com/stcarrez/ada-wiki⁠)
• Ada EL (https://github.com/stcarrez/ada-el⁠)
• Ada Security (https://github.com/stcarrez/ada-security⁠)
• Ada Keystore (https://github.com/stcarrez/ada-keystore⁠)
• Dynamo (https://github.com/stcarrez/dynamo⁠)

Atlas relies on the following external projects:

• AWS (https://libre.adacore.com/libre/tools/aws/⁠)
• XMLAda (https://libre.adacore.com/libre/tools/xmlada/⁠)

Before building and configuring Atlas, you should have configured, built and installed all of the above projects.

⁠Building Atlas

To configure Atlas, use the following command:

   ./configure

Then, build the application:

   make generate build

⁠Running Atlas

You will then start the application as follows:

   bin/atlas-server setup --upload=upload

and point your browser to http://localhost:8080/atlas/index.html⁠ On your browser, you will first enter in the setup phase to configure the database and the application.

⁠Docker

A docker container is available for those who want to try Atlas without installing and building all required packages. To use the Atlas docker container you can run the following commands:

   sudo docker pull ciceron/atlas
   sudo docker run --name atlas -p 8080:8080 ciceron/atlas

and then point your browser to http://localhost:8080/atlas/index.html⁠

To stop the running application you will use:

   sudo docker stop atlas
   sudo docker rm atlas

⁠Tutorial

You may read the following tutorials to lean more about the technical details about setting up and building an Ada Web Application:

• Step 1: Ada Web Application: Setting up the project⁠
• Step 2: Ada Web Application: Building the UML model⁠
• Step 3: Review Web Application: Creating a review⁠
• Step 4: Review Web Application: Listing the reviews⁠