yas

YAS: もうひとつのショップ

YAS は、Java で典型的なマイクロサービス アプリケーションを構築することを目的としたペット プロジェクトです。

暫定的なテクノロジーとフレームワーク

• ジャワ21
• スプリングブーツ3.2
• テストコンテナ
• Next.js
• キークローク
• カフカ
• エラスティックサーチ
• K8s
• GitHub アクション
• ソナークラウド
• オープンテレメトリ
• グラファナ、ロキ、プロメテウス、テンポ

ローカル開発アーキテクチャ

Docker Compose を始める

1. 最新のソースコードを入手する
2. 次のレコードをホスト ファイルに追加します。

 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. 選択したターミナルを開き、 yasディレクトリに移動し、 docker compose up実行し、すべてのコンテナが起動して実行されるまで待ちます。

警告:すべてのコンテナを実行するには、少なくとも 16GB の RAM が必要です。それ以外の場合は、このコマンドdocker compose -f docker-compose.yml upでのみコア サービスを実行できます。

4. すべてのコンテナが起動して実行されたら、スクリプトを実行してソース コネクタを開始し、任意のターミナル ウィンドウを開きます...YAS ルート フォルダーに移動して、「./start-source-connectors.sh」と入力します。
5. ブラウザを開くと、 http://storefront/経由で Web サイトにアクセスできるようになります。 http://backoffice/ admin/password でログイン

注:最初の実行では、ストアフロントとバックオフィスが期待どおりに動作しない可能性があります。すべてのコンテナーを停止し (Ctrl + C)、docker compose up を再度実行します。

次のことも検討してみてください。

1. http://pgadmin.yas.local/ 。アカウントのログイン: [email protected] / admin.サーバーを登録します: postgres、ポート 5432、ユーザー名 admin、パスワード admin。 Postgresql サーバーはホスト マシンにも公開されます: サーバー名: localhost、ポート: 5432、ユーザー名: admin、パスワード: admin
2. すべてのサービスのすべての REST API ドキュメントについてはhttp://api.yas.local/swagger-ui/
3. Keycloakコンソールの場合はhttp://identity/ 、アカウントadmin/admin
4. 可観測性についてはhttp://grafana/ : ログ、トレース、マトリックス
5. Elasticsearch API を呼び出すにはhttp://elasticsearch/

docker-compose ファイルについて

1. すべてのコア サービス用の docker-compose.yml
2. 検索サービスの docker-compose.search.yml
3. 可観測性サービス用の docker-compose.o11y.yml

Kubernetes へのデプロイ

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

ドキュメント

• アーキテクチャとコンポーネント
• 開発者ガイドライン

貢献する

• 星を付けてください
• バグの報告
• ディスカッションに参加する
• 新しい機能を提案する
• プルリクエストを送信します。 GitHub を初めて使用する場合は、フォークを通じてプロジェクトに貢献する方法を学ぶことを検討してください。

貢献することにより、あなたの貢献が MIT ライセンスに基づいてライセンスされることに同意したものとみなされます。

スクリーンショット

バックオフィスとストアフロント	可観測性