{"id":19260773,"url":"https://github.com/ashrawan/swa-proj3","last_synced_at":"2025-04-21T16:32:12.883Z","repository":{"id":71536748,"uuid":"540292112","full_name":"ashrawan/swa-proj3","owner":"ashrawan","description":"Microservice-based application development using Spring Boot, Kafka, Redis, MySQL, MongoDB, Elasticsearch, Docker and Kubernetes.","archived":false,"fork":false,"pushed_at":"2024-03-17T08:22:37.000Z","size":546,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-01T14:38:38.354Z","etag":null,"topics":["docker","elasticsearch","java","kafka","kubernetes","microservices","mongodb","mysql","redis","spring","spring-boot"],"latest_commit_sha":null,"homepage":"https://medium.com/handpro/mastering-microservices-a-practical-exploration-conquering-complexity-f4e5e450c1f5","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ashrawan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-09-23T05:28:04.000Z","updated_at":"2025-02-03T09:41:17.000Z","dependencies_parsed_at":"2023-02-27T19:45:22.598Z","dependency_job_id":null,"html_url":"https://github.com/ashrawan/swa-proj3","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashrawan%2Fswa-proj3","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashrawan%2Fswa-proj3/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashrawan%2Fswa-proj3/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ashrawan%2Fswa-proj3/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ashrawan","download_url":"https://codeload.github.com/ashrawan/swa-proj3/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250091031,"owners_count":21373304,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","elasticsearch","java","kafka","kubernetes","microservices","mongodb","mysql","redis","spring","spring-boot"],"created_at":"2024-11-09T19:22:51.732Z","updated_at":"2025-04-21T16:32:11.368Z","avatar_url":"https://github.com/ashrawan.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Introduction\n### Microservice-based application development using Spring Boot, Spring Security, Spring Cloud, Kafka, Redis, Zipkin, MySQL, MongoDB, Elasticsearch, Docker and Kubernetes.  \n#### Frontend (Angular): https://github.com/ashrawan/swa-proj3-ui  \n---\n\n## # How to run ? \n\n### __Development:__\n1. Running Single Service at a time:\n    - __If Using IDE__: Run each services by clicking their \"run\" icon\n    - __Using only CMD__ : On terminal of specific service, type `mvn spring-boot:run`\n    - __JAR file__: First, Create jar `mvn clean install` and run `java -jar target/service1.jar`\n\n2. Running the application using docker\n    - If cloned first time, In the root directory run `mvn clean install` or use IDE, maven -\u003e lifecycle -\u003e install (to create jar for all services)\n    - Then, In terminal type: `docker compose up`. (this will run mysql, and other services)\n\n    ```cmd \n   mvn clean install -DskipTests\n   docker compose up\n    ```\n  \n\u003e Check docs/dev folder README, to start the required services. \"MongoDB\", \"Kafka\", \"Redis\" ..  \n  \n### __Deployment K8S:__\n```cmd\nmvn clean install -DskipTests\n\n# If minkiube, also run -\u003e minikube docker-env\ndocker compose build\n\n# app-cores: All configs and DB, services: all services\nkubectl create -f k8s/app-cores\nkubectl create -f services\n\n# add \"192.168.49.2 jobapp.swa.local\" to /etc/host\nsudo nano /etc/hosts\n\n==========================\n127.0.0.1\tlocalhost\n192.168.49.2 jobapp.swa.local\n==========================\n```\n\n### __Testing Deployed Services__  \n```\n# FROM: \"auth-service\", This is for create user\n\ncurl --location --request POST 'http://jobapp.swa.local/auth/create-user' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"fullName\": \"Test user\",\n    \"email\": \"test1\",\n    \"password\": \"test1\"\n}'\n\n# FROM: \"auth-service\", This is for Login\n\ncurl --location --request POST 'http://jobapp.swa.local/auth/login' \\\n--header 'Content-Type: application/json' \\\n--data-raw '{\n    \"username\": \"test1\",\n    \"password\": \"test1\"\n}'\n```\n  \n\n## # How to create this project, and how to add new modules/services ?  \n__Steps: Creating multi-module project__  \n1. Create new project \"swa-2\", and select buildSystem maven.\n2. Then either Create new services or Add existing ones\n   - __Create (New Module):__ right click on project \"swa-2\" and create any module\n      - e.g click on: new -\u003e module -\u003e springInitializr\n   - __Add (Add Module):__ right click on \"swa-2\", open module settings\n     - then under that Settings -\u003e Modules -\u003e click on + -\u003e import module -\u003e Select .pom file or directory -\u003e then import module from external model -\u003e select maven -\u003e Apply\n   - After that go to pom.xml of root project \"swa-2\" and add to `\u003cmodules\u003e ... \u003cmodules\u003e`\n\n## # How to contribute to the project ?\n\n__INSTRUCTION:__\n1. Use _\"develop\"_ branch to make and commit changes.\n2. We will merge to __\"main\"__ on the day-end or when services are integrated and working fine.\n\n\u003e  __Want to know, What to contribute and how to do it ?__ \n\u003e \n\u003e Please, Check out [TODO.md](./TODO.md) , and discuss with the team\n\n--- \n\n## # Need Further help ?\n\n__Reach out team-mates to Discuss and do it together.__\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashrawan%2Fswa-proj3","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fashrawan%2Fswa-proj3","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fashrawan%2Fswa-proj3/lists"}