https://github.com/gtiwari333/spring-boot-keycloak-angular-quote-app

Spring Boot + Keycloak Backend / Angular Web App
https://github.com/gtiwari333/spring-boot-keycloak-angular-quote-app

angular heroku java jsoup keycloak spring-boot web-crawler web-scraper

Last synced: 2 months ago
JSON representation

Spring Boot + Keycloak Backend / Angular Web App

• Host: GitHub
• URL: https://github.com/gtiwari333/spring-boot-keycloak-angular-quote-app
• Owner: gtiwari333
• Created: 2018-08-06T02:15:03.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-03-04T16:28:27.000Z (almost 2 years ago)
• Last Synced: 2024-10-13T02:18:58.991Z (3 months ago)
• Topics: angular, heroku, java, jsoup, keycloak, spring-boot, web-crawler, web-scraper
• Language: TypeScript
• Homepage: http://ganeshtiwaridotcomdotnp.blogspot.com/
• Size: 7.22 MB
• Stars: 5
• Watchers: 3
• Forks: 3
• Open Issues: 27
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# Spring Boot REST API + Keycloak and Angular Web App

#### Web Scrapping using JSoup blog: https://ganeshtiwaridotcomdotnp.blogspot.com/2018/12/web-scrapping-in-java-using-jsoup.html

## Overview

- A sample app to demonstrate Spring Boot - Angular Web App

- The server scraps the websites (uses JSoup) to read Quotes and store into db.

    - see `WebScraper` interface

    - see also `GoodReadsScrapper`

- The client (web app) has option to subscribe to receive random quotes daily

- The logged in user can manage the quotes, view all    

- The client (mobile app in branch `mobile-ionic-app`) also pulls and displays the quotes

# Keycloak Setup

- Run using docker

    - $cd _config

    - $docker-compose up

    - note that two users will be already loaded from realm-export.json

        - username/passwords are: user1/pass, user2/pass

- Or run manually:

    - Create a realm named 'quote-app'

    - Manually create users with role = 'user'

# How to run Locally?

- Start Server : 

    - Import project into your IDE and run QuoteApplication inside server module

    - OR navigate to server module and run 'mvnw or ./mvnw'. The default goal is spring-boot:run which starts the app automatically

- Start client : Navigate to web module and run  'npm install' for one time to install dependencies and then `npm start` afterwards to run the ap

- Start keycloak docker. Run ``docker run -p 8082:8080 -e KEYCLOAK_USER=admin -e KEYCLOAK_PASSWORD=admin quay.io/keycloak/keycloak:15.0.2``

- Open http://localhost:4200

### Server: Spring Boot

- Uses JSoup to parse the quote websites and stores into H2 database at startup

- Quotes can be retrieved by REST apis `HOST/quotes` 

- Deploy to Heroku 

- Did below updates for Heroku. Since its a multi module Maven app: 

    - Added file: Procfile `web: java -jar server/target/server-0.0.1-SNAPSHOT.jar -Dserver.port=$PORT`

    - Added server.port entry on application.yml   ` server: port: ${PORT:8080}`

# Angular Web App

- Install Dependencies: `npm install`

- Start locally:  `npm start`.

- Proxy is configured to handle cors request. Review 'start' scripts at  `web/package.json` 

- Prod build : `ng build --prod`

- Run in production: using express/node : `node server.js`

- Note the following dependencies

```

    "cors": "^2.8.5",

    "express-http-proxy": "^1.6.0",

    "port": "^0.8.1",

```