【亲测免费】 YAS 微服务项目使用指南

1. 项目介绍

YAS（Yet Another Shop）是一个用 Java 编写的示例微服务项目，旨在练习构建典型的微服务应用程序。该项目涵盖了多种现代技术和框架，包括 Java 21、Spring Boot 3.2、Testcontainers、Next.js、Keycloak、Kafka、Elasticsearch、K8s、GitHub Actions、SonarCloud、OpenTelemetry、Grafana、Loki 和 Prometheus。

2. 项目快速启动

2.1 获取最新源代码

首先，从 GitHub 仓库获取最新的源代码：

git clone https://github.com/nashtech-garage/yas.git
cd yas

2.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
127.0.0.1 akhq

2.3 启动 Docker Compose

在终端中运行以下命令以启动所有容器：

docker-compose up

注意：为了运行所有容器，您需要至少 16GB 的 RAM。如果内存不足，可以只运行核心服务：

docker-compose -f docker-compose.yml up

2.4 启动源连接器

在另一个终端窗口中，运行以下命令以启动源连接器：

./start-source-connectors.sh

2.5 访问应用程序

所有容器启动并运行后，您可以通过以下 URL 访问应用程序：

• 前端商店：http://storefront/
• 后台管理：http://backoffice/
• 登录信息：用户名 admin，密码 password

注意：首次运行时，前端和后台管理可能无法正常工作。请停止所有容器（Ctrl + C）并再次运行 docker-compose up。

3. 应用案例和最佳实践

YAS 项目可以作为学习微服务架构的绝佳示例。通过该项目，开发者可以了解如何使用 Spring Boot、Kafka、Elasticsearch 等技术构建和部署微服务应用程序。此外，YAS 还展示了如何使用 Docker 和 Kubernetes 进行本地开发和生产部署。

4. 典型生态项目

YAS 项目依赖于多个开源生态项目，包括：

• Spring Boot：用于构建微服务应用程序的核心框架。
• Kafka：用于消息传递和事件驱动架构。
• Elasticsearch：用于搜索和分析数据。
• Keycloak：用于身份验证和授权。
• Grafana：用于监控和可视化。
• Prometheus：用于指标收集和监控。
• Loki：用于日志聚合和查询。

这些生态项目共同构成了 YAS 微服务架构的基础，展示了如何将它们集成在一起以构建一个完整的微服务应用程序。