Update configuration files and add package-lock.json
Fix HELP.md
This commit is contained in:
@@ -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 build
|
||||
```
|
||||
- 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
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user