8. Upute za pustanje u pogon

1. Instalacija lokalno

• za frontend aplikacije potrebna najnovija verzija Node.js

nvm install --lts
# Potvrdi instalaciju
node -v
npm -v
#instalacija ovisnosti
npm install
#pokretanje
npm run dev

• za backend potrebna najnovija verzija Dockera

npm run build-docker
npm run run-docker

• za preuzimanje izvornog koda se klonira Git repozitorij pomoću poveznice https://github.com/en765/DisasterMaster. Git repozitorij najlakse je klonirati korištenjem GitHub Desktopa.

2. Postavke

• ukoliko se želi koristiti vlastiti Google Client Secret za autentifikaciju, u .env datoteci se on može promijeniti:

• isto vrijedi i za bazu, ako se želi koristiti vlastita baza podataka na nekom drugom serveru, trebaju se napraviti promjene u datoteci application.properties u mapi IzvorniKod\dm-be\src\main\resources :

3. Pokretanje aplikacije

• frontend: postaviti se u direktorij IzvorniKod\dm-fe (pomoću naredbe cd IzvorniKod/dm-fe) u terminalu uređivača, zatim pokrenuti aplikaciju pomoću npm run dev nakon čega se na web pregledniku, na adresi http://localhost:3000/, može koristiti aplikacija.
• backend: u mapi IzvorniKod\dm-be\src\main\java\dm_be je potrebno pokrenuti program DmBeApplication.java kojim se pokreće server lokalno kod korisnika.

• za pravilan lokalni rad aplikacije potrebno je obaviti oba postupka

4. Primjer za Render platformu (Cloud Deploy) Frontend i backend je potrebno deployati na zasebnim servisima.

• Frontend:

  • Prijaviti se na Render
  • Kreirati novi Web Service i povezati ga s GitHub Repozitorijem https://github.com/en765/DisasterMaster
  • Odabrati Language Node
  • Konfiguriraju se postavke:
  • Branch: main
  • Root Directory: ./IzvorniKod/dm-fe/src
  • Build Command: npm install
  • Start Command: npm run dev

• Backend:

  • Prijaviti se na Render
  • Kreirati novi Web Service i povezati ga s GitHub Repozitorijem https://github.com/en765/DisasterMaster
  • Odabrati Language Docker
  • Konfiguriraju se postavke:
  • Root directory: ./IzvorniKod/dm-be (s obzirom da se Dockerfile nalazi u tom direktoriju neće biti potrebno ručno unijeti gdje se on nalazi u repozitoriju)
  • Pod Advanced -> Secret Files -> Add Secret File je potrebno dodati secret GOOGLE_CLIENT_SECRET te vaš google secret kako bi se mogla provoditi autentifikacija

• Pokretanje aplikacije:

  • Render će automatski generirati URL za pristup aplikaciji te će to biti npr. disastermaster.onrender.com