yas

YAS: Noch ein weiterer Shop

YAS ist ein Lieblingsprojekt mit dem Ziel, das Erstellen einer typischen Microservice-Anwendung in Java zu üben

Vorläufige Technologien und Frameworks

• Java 21
• Springboot 3.2
• Testcontainer
• Next.js
• Schlüsselmantel
• Kafka
• Elasticsearch
• K8s
• GitHub-Aktionen
• SonarCloud
• OpenTelemetry
• Grafana, Loki, Prometheus, Tempo

Lokale Entwicklungsarchitektur

Erste Schritte mit Docker Compose

1. Holen Sie sich den neuesten Quellcode
2. Fügen Sie Ihrer Hostdatei die folgenden Datensätze hinzu:

 127.0.0.1 identity
127.0.0.1 api.yas.local
127.0.0.1 pgadmin.yas.local
127.0.0.1 storefront
127.0.0.1 backoffice
127.0.0.1 loki
127.0.0.1 tempo
127.0.0.1 grafana
127.0.0.1 elasticsearch
127.0.0.1 kafka

3. Öffnen Sie das Terminal Ihrer Wahl, gehen Sie zum Verzeichnis yas , führen Sie docker compose up aus und warten Sie, bis alle Container betriebsbereit sind

Warnung: Um alle Container auszuführen, benötigen Sie mindestens 16 GB RAM. Andernfalls können Sie die Kerndienste nur mit diesem Befehl docker compose -f docker-compose.yml up ausführen

4. Alle Container sind betriebsbereit, dann starten wir die Quellkonnektoren per Ausführungsskript, öffnen ein beliebiges Terminalfenster ... gehen zum YAS-Stammordner und geben Folgendes ein: ./start-source-connectors.sh
5. Öffnen Sie Ihren Browser, nun können Sie über http://storefront/ auf die Websites zugreifen; http://backoffice/ anmelden mit admin/passwort

Hinweis: Bei der ersten Ausführung funktionieren die Storefront und das Backoffice möglicherweise nicht wie erwartet. Stoppen Sie alle Container (Strg + C) und führen Sie Docker Compose erneut aus.

Vielleicht möchten Sie auch Folgendes erkunden:

1. http://pgadmin.yas.local/ . Kontoanmeldung: [email protected] / admin. Registrieren Sie einen Server: Postgres, Port 5432, Benutzername Admin, Passwort Admin. Der Postgresql-Server ist auch dem Host-Computer zugänglich: Servername: localhost, Port: 5432, Benutzername: admin, Passwort: admin
2. http://api.yas.local/swagger-ui/ für das gesamte REST-API-Dokument aller Dienste
3. http://identity/ für die Keycloak-Konsole, Konto admin/admin
4. http://grafana/ für Beobachtbarkeit: Log, Trace, Matrix
5. http://elasticsearch/ zum Aufrufen von Elasticsearch-APIs

Über Docker-Compose-Dateien

1. docker-compose.yml für alle Kerndienste
2. docker-compose.search.yml für den Suchdienst
3. docker-compose.o11y.yml für Observability-Dienste

Bereitstellung auf Kubernetes

https://github.com/nashtech-garage/yas/tree/main/k8s/deploy

Dokumentation

• Architektur und Komponenten
• Entwicklerrichtlinien

Mitwirken

• Gib uns einen Stern
• Einen Fehler melden
• Beteiligen Sie sich an Diskussionen
• Schlagen Sie neue Funktionen vor
• Senden Sie Pull-Anfragen. Wenn Sie neu bei GitHub sind, sollten Sie lernen, wie Sie durch Forking zu einem Projekt beitragen können

Durch Ihren Beitrag erklären Sie sich damit einverstanden, dass Ihre Beiträge unter der MIT-Lizenz lizenziert werden.

Screenshots

Backoffice und Storefront	Beobachtbarkeit