ConfigAutomation is a web application that automates configuration management for software projects. It uses Angular and Spring Boot to provide a user-friendly interface for managing configurations.
To run ConfigAutomation application, you need the following software installed on your machine (Ubuntu 22.04.2 LTS):
- Ansible (core 2.15.2)
- Npm (version 8.19.4)
- Node (version 16.20.0)
- Angular CLI (version 15.0.2)
- Java Development Kit (JDK) (version 17)
- Maven (version 3.6.3)
- Docker (version 24.0.1)
- Docker compose (version 1.29.2)
- MySQL (version 8.0.33)
- OpenSSH (version 8.9)
- To get started, clone this repository to your local machine :
git clone https://gitlab.medianet.tn/pfe/2023-achraf-yaakoub/medianet.git-
Open a terminal and go to the "configAutomation" folder
-
Start the Docker container of BDD by running the following command:
docker-compose up-
Open a terminal and go to the "FRONTEND" folder and run
npm installto install the front-end dependencies. -
Run
ng serveto start the front-end development server. -
Open another terminal and go to the "BACKEND" folder and run
mvn spring-boot:runto start the back-end server. -
Add an admin to the application,you need to send a POST request to the http://localhost:8080/api/v1/auth/register URL using Postman or a similar tool. The request should include the admin's credentials in the request body as JSON format.
Here is an example JSON request body for adding an admin:
{
"username": "admin",
"password": "admin",
"firstname": "admin",
"lastname": "admin"
}
Replace the username, password, firstname and lastname values with the desired admin credentials.
Once you have sent the request, the admin will be created in the database and you can log in to the application using their credentials.
- Open a web browser and navigate to http://localhost:4200 to access the ConfigAutomation application.
Note:To use these application, you will need SSH access between the control node and the client server selected in the interface. For more information on configuring SSH access, see the Ansible documentation.
Contributions are welcome for the ConfigAutomation project. If you would like to contribute to the project, please create a branch from the main branch of the Git repository first. Then, make your modifications and submit a pull request to merge them into the main branch.
This application is created by YAAKOUB.