Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/kolman-freecss/kolman-freecss-server

Microservices | Hexagonal | NodeJs & Express & NATS | Java & SpringBoot | Kafka | Python & FastAPI | Terraform | Docker | K8s | Skaffold | AWS
https://github.com/kolman-freecss/kolman-freecss-server

Last synced: 1 day ago
JSON representation

Microservices | Hexagonal | NodeJs & Express & NATS | Java & SpringBoot | Kafka | Python & FastAPI | Terraform | Docker | K8s | Skaffold | AWS

Awesome Lists containing this project

README

        

# Kolman Freecss Server

As **principal purpose** is to deploy a local server to provide different features for my Web ShowCase **Kolman-Freecss-About**.

Check the related repositories:

- #### Client side: [kolman-freecss-about](https://github.com/Kolman-Freecss/Kolman-Freecss-About)
- #### Another client built with ReactJs: [kolman-freecss-stuff](https://github.com/Kolman-Freecss/Kolman-Freecss-Stuff)

___

**Kolman Freecss** is my alias. I'm a software engineer who loves to code and learn new things.

This repository is a personal project where I'm building different stuff as showcase.

## Index

- [Getting Started](#getting-started)
- [Tech stacks](#tech-stacks)
- [Architecture](#architecture)
- [Infrastructure](#infrastructure)
- [Troubleshoting](#troubleshoting)

## Getting Started

How to run the project:

1. Clone the repository.
2. Run `docker-compose up` in the `infra` folder. (This will start the NATS streaming server).

## Tech stacks

#### Back:

(Every microservice has its own README.md that explains the tech stack used)

- Java & Springboot
- Python & FastAPI
- Node.js & Express & Jest

#### DDBB:

- Firebase
- MongoDB
- H2

#### Streaming server:

- NATS & Kafka

### CI/CD

- Check the section below `Infrastructure`.

## Architecture

- Microservices.
- Hexagonal.
- Event-driven.

Check the `server` folder.

## Infrastructure

- Docker
- Docker-compose
- Kubernetes
- Skaffold
- Terraform
- AWS
- Github Actions

## Troubleshoting

- Connect Kafka between Docker local containers.
- Check `KAFKA_ADVERTISED_LISTENERS` in the `docker-compose.yml` file that matches with `host.docker.internal` (This is only for local purposes because you need 'host.docker.internal' in bootstrap-server Kafka connection).

---

Shield: [![CC-BY-NC-ND 4.0][CC-BY-NC-ND-shield]][CC-BY-NC-ND]

This work is licensed under a [Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.][CC-BY-NC-ND]

[![CC-BY-NC-ND 4.0][CC-BY-NC-ND-image]][CC-BY-NC-ND]

[CC-BY-NC-ND-shield]: https://img.shields.io/badge/License-CC--BY--NC--ND--4.0-lightgrey
[CC-BY-NC-ND]: http://creativecommons.org/licenses/by-nc-nd/4.0/
[CC-BY-NC-ND-image]: https://i.creativecommons.org/l/by-nc-nd/4.0/88x31.png