Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README and npm file from main #51

Merged
merged 3 commits into from
May 7, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 23 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

# Building Information Enhancer (AMOS SS 2024)

This is an official repository for the `CODE.ING` group, developing a open-source `Building Information Enhancer` software for the `BUILD.ING` partner and the `AMOS 2024` project.
This is an official repository for the `CODE.ING` group, developing an open-source `Building Information Enhancer` software for the `BUILD.ING` partner and the `AMOS 2024` project.

Project Team:

Expand All @@ -16,10 +16,28 @@ Project Team:
- **Lucas Nandico** (SD)
- **Celine Pöhl** (SD)

# Setup
# System Architecture

Before deploying the project be sure you have `npm` installed and a running `Docker Engine`.
To see and read about the architecture of our system visit our GitHub [wiki](https://github.com/Corgam/SS23_ADSP_TCF/wiki) documentation.

# Project Deployment
# Setup & Deployment

To deploy the project on your local machine using Docker Engine run the `npm run deploy` command.
This project is integrated with a full CI/CD pipeline, thus deployed automatically on the web. However, it is possible to deploy a production-ready system on a local machine using Docker or deploy each part of the system separately for further development. For further information on the `CI/CD` pipeline visit our GitHub [wiki](https://github.com/Corgam/SS23_ADSP_TCF/wiki) documentation.

## Deployment using Docker

To deploy the project on your local machine using Docker Engine, follow the instructions below:

1. Clone this repository (https://github.com/amosproj/amos2024ss04-building-information-enhancer).
2. Before deploying the project be sure you have installed the [Node.js](https://nodejs.org/en) ( >= 20.12.2) and a running [Docker Deamon](https://docs.docker.com/engine/install/).
3. Run the `npm run deploy` command in the root folder of the repository.
4. Connect to the Frontend located at port 80, usually `localhost:80`.

## Developement Deployment

To deploy one or more services of the system separately, follow the instructions below:

1. Clone this repository (https://github.com/amosproj/amos2024ss04-building-information-enhancer).
2. Before deploying the project be sure you have installed the [Node.js](https://nodejs.org/en) ( >= 20.12.2) and a running [Docker Deamon](https://docs.docker.com/engine/install/).
3. Run the `npm run setup` command to install all necessary packages.
4. To deploy the frontend use the `npm run deploy:dev:frontend` command, or to deploy the backend use the `npm run deploy:dev:backend` command.
7 changes: 4 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,10 @@
"author": "See repository README",
"scripts": {
"setup": "npm run setup:frontend && npm run setup:backend",
"setup:frontend": "cd frontend/",
"setup:backend": "cd backend/public-api",
"setup:frontend": "cd frontend/ && npm ci",
"setup:backend": "cd backend/",
"deploy": "docker compose up --build -d",
"push": "docker compose push"
"deploy:dev:frontend": "cd frontend/ && npm run dev",
"deploy:dev:backend": "cd backend/"
}
}
Loading