diff --git a/.gitignore b/.gitignore index e5f7cfe..cfbc25f 100644 --- a/.gitignore +++ b/.gitignore @@ -1,4 +1,4 @@ -HELP.md + .gradle build/ !gradle/wrapper/gradle-wrapper.jar diff --git a/HELP.md b/HELP.md new file mode 100644 index 0000000..7f9f0f5 --- /dev/null +++ b/HELP.md @@ -0,0 +1,129 @@ + +# How to run the application + +To run the application, follow these steps: + +1. **Build the Project**: + - Ensure you have Java 24, Gradle, and Node.js installed. + - Run the following command to build the project: + ```bash + ./gradlew build + ``` + + 2. **Prepare Frontend Resources**: + - Build the Angular frontend by navigating to the `jambotron-ui` directory and running + ```bash + cd jambotron-ui + ``` + - next: + ```bash + npm install + ``` + - next: + ```bash + npm run build + ``` + - This will generate the frontend files in the `jambotron-ui/dist/jambotron-ui/browser` directory. + + +3. **Copy Frontend Resources**: + - Use the Gradle task to copy the frontend resources to the `jumbotron/src/main/resources/public` directory: + ```bash + cd .. + ``` + - next: + ```bash + ./gradlew copyResources + ``` + then +4. **Create postgres server and database**: + - Create a PostgreSQL database + - named `jambotronDB` with the + - user `admin` and + - password `postgrespw`. + + - You can use a PostgreSQL client or run the following command in your terminal: + ```sql + CREATE DATABASE jambotronDB; + CREATE USER admin WITH PASSWORD 'postgrespw'; + GRANT ALL PRIVILEGES ON DATABASE jambotronDB TO admin; + ``` + - If you are using Docker, you can run PostgreSQL using the following command: + ```bash + docker run --name postgresDB -p 5432:5432 -e POSTGRES_USER=admin -e POSTGRES_PASSWORD=postgrespw -e POSTGRES_DB=jambotronDB -d postgres + ``` + - if you are wont to use pgadmin + ```bash + docker run --name pgadmin -e "PGADMIN_DEFAULT_EMAIL=name@example.com" -e "PGADMIN_DEFAULT_PASSWORD=admin" -p 5050:80 -d dpage/pgadmin4 + ``` + then + - create a network for the containers to communicate: + ```bash + docker network create --driver bridge pgnetwork + ``` + - Show list of networks: + ```bash + docker network ls + ``` + - Connect pgadmin to the network: + ```bash + docker network connect pgnetwork pgadmin + ``` + - Connect postgresDB to the network (postgresDB must by running): + ```bash + docker network connect pgnetwork postgresDB + ``` + - Inspect the network to ensure both containers are connected: + ```bash + docker network inspect pgnetwork + ``` + + + +5. **Run the Application**: + - Start the Spring Boot application: + ```bash + ./gradlew bootRun + ``` + +6. **Access the Application**: + - Open your browser and navigate to `http://localhost:8080`. + +Make sure all dependencies and configurations are correctly set up before running these steps. + + + + +# How to run the application in Docker + +To run the application in Docker, follow these steps: + +- build jar file +```bash +./gradlew bootJar + ``` +- Run docker compose to start the application and PostgreSQL: +```bash +docker-compose -f src/Docker/docker-compose.yml up -d +``` +### Reference Documentation +For further reference, please consider the following sections: + +* [Official Gradle documentation](https://docs.gradle.org) +* [Spring Boot Gradle Plugin Reference Guide](https://docs.spring.io/spring-boot/3.5.0/gradle-plugin) +* [Create an OCI image](https://docs.spring.io/spring-boot/3.5.0/gradle-plugin/packaging-oci-image.html) + +### Additional Links +These additional references should also help you: + +* [Gradle Build Scans – insights for your project's build](https://scans.gradle.com#gradle) + + + +For docker-compose db connect with pgAdmin used +host.docker.internal + + + + + diff --git a/jambotron-ui/angular.json b/jambotron-ui/angular.json index 6260ea7..07de4b3 100644 --- a/jambotron-ui/angular.json +++ b/jambotron-ui/angular.json @@ -44,7 +44,7 @@ { "type": "initial", "maximumWarning": "500kB", - "maximumError": "1MB" + "maximumError": "5MB" }, { "type": "anyComponentStyle", @@ -105,4 +105,4 @@ } } } -} \ No newline at end of file +} diff --git a/jambotron-ui/public/Firefly_jambo-tron-118290.ico b/jambotron-ui/public/Firefly_jambo-tron-118290.ico new file mode 100644 index 0000000..7a97d40 Binary files /dev/null and b/jambotron-ui/public/Firefly_jambo-tron-118290.ico differ diff --git a/jambotron-ui/src/index.html b/jambotron-ui/src/index.html index 44d8f23..702379c 100644 --- a/jambotron-ui/src/index.html +++ b/jambotron-ui/src/index.html @@ -5,7 +5,9 @@