yas

YAS : Encore une autre boutique

YAS est un projet animalier visant à s'entraîner à créer une application de microservice typique en Java.

Technologies et cadres provisoires

• Java21
• Démarrage de printemps 3.2
• Conteneurs de test
• Suivant.js
• Porte-clés
• Kafka
• Recherche élastique
• K8
• Actions GitHub
• SonarCloud
• OpenTélémétrie
• Grafana, Loki, Prométhée, Tempo

Architecture du développement local

Premiers pas avec Docker Compose

1. Obtenez le dernier code source
2. Ajoutez les enregistrements suivants à votre fichier hôte :

 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. Ouvrez le terminal de votre choix, accédez au répertoire yas , exécutez docker compose up , attendez que tous les conteneurs soient opérationnels

Attention : Pour exécuter tous les conteneurs, vous avez besoin d'un minimum de 16 Go de RAM. Sinon, vous ne pouvez exécuter les services de base qu'avec cette commande docker compose -f docker-compose.yml up

4. Tous les conteneurs sont opérationnels, puis nous démarrons les connecteurs sources en exécutant le script, en ouvrant n'importe quelle fenêtre de terminal... allez dans le dossier racine YAS et tapez : ./start-source-connectors.sh
5. Ouvrez votre navigateur, vous pouvez désormais accéder aux sites Web via http://storefront/ ; http://backoffice/ connexion avec admin/mot de passe

Remarque : Lors de la première exécution, la vitrine et le backoffice peuvent ne pas fonctionner comme prévu. Arrêtez tous les conteneurs (Ctrl + C) et exécutez à nouveau Docker Compose Up.

Vous voudrez peut-être également explorer :

1. http://pgadmin.yas.local/ . Connexion au compte : [email protected] / admin. Enregistrez un serveur : postgres, port 5432, nom d'utilisateur admin, mot de passe admin. Le serveur Postgresql est également exposé à la machine hôte : nom du serveur : localhost, port : 5432, nom d'utilisateur : admin, mot de passe : admin
2. http://api.yas.local/swagger-ui/ pour tout le document API REST de tous les services
3. http://identity/ pour la console Keycloak, compte admin/admin
4. http://grafana/ pour l'observabilité : log, trace, matrice
5. http://elasticsearch/ pour appeler les API Elasticsearch

À propos des fichiers Docker-Compose

1. docker-compose.yml pour tous les services de base
2. docker-compose.search.yml pour le service de recherche
3. docker-compose.o11y.yml pour les services d'observabilité

Déployer sur Kubernetes

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

Documentation

• Architecture et composants
• Consignes pour les développeurs

Contribuer

• Donnez-nous une étoile
• Signaler un bug
• Participer aux discussions
• Proposer de nouvelles fonctionnalités
• Soumettez des demandes de tirage. Si vous êtes nouveau sur GitHub, envisagez d'apprendre à contribuer à un projet via le forking

En contribuant, vous acceptez que vos contributions soient sous licence MIT.

Captures d'écran

Back-office et vitrine	Observabilité