KamToHung commented on code in PR #863: URL: https://github.com/apache/dubbo-go-samples/pull/863#discussion_r2232372509
########## online_boutique/README.md: ########## @@ -1,17 +1,149 @@ # Dubbo Go Demo [](https://opensource.org/licenses/Apache-2.0) [](https://godoc.org/github.com/go-micro/demo) [](https://github.com/go-micro/demo/actions/workflows/ci.yml) [](https://github.com/go-micro/demo/actions/workflows/docker.yml) <p align="center"> -<img src="src/frontend/static/icons/Hipster_HeroLogoCyan.svg" width="300" alt="Online Boutique" /> +<img src="src/frontendservice/static/icons/Hipster_HeroLogoCyan.svg" width="300" alt="Online Boutique" /> </p> - **This application was forked from [microservices-demo](https://github.com/GoogleCloudPlatform/microservices-demo), used to demonstrate how to build micro servics with [dubbo-go](https://github.com/apache/dubbo-go).** **Online Boutique** is a cloud-native microservices demo application. Online Boutique consists of a 11-tier microservices application. The application is a web-based e-commerce app where users can browse items, add them to the cart, and purchase them. +## 🚀 Quick Start + +### Prerequisites + +Before you begin, make sure you have the following installed: + +- [Go](https://golang.org/doc/install) +- [Python 3](https://www.python.org/downloads/) +- [pip3](https://pip.pypa.io/en/stable/installation/) +- [ZooKeeper](https://zookeeper.apache.org/) + +### One-Command Setup + +Start all services with a single command: + +```bash +make start-all +``` + +This command will: +1. Build all 11 microservices +2. Start business services in the background +3. Wait for services to initialize +4. Start the load generator + +### Access the Application + +Once all services are running, you can access: +- **Web Frontend**: http://localhost:8090 +- **Service Status**: Check with `make status` +- **Service Logs**: View with `make logs` + +## 📋 Makefile Commands + +The project includes a comprehensive Makefile for easy service management: + +### Basic Commands + +| Command | Description | +|---------|-------------| +| `make help` | Show all available commands | +| `make start-all` | Build and start all services | +| `make stop-all` | Stop all running services | +| `make status` | Check status of all services | +| `make logs` | View logs from all services | + +### Service Management + +| Command | Description | +|---------|-------------| +| `make build-all` | Build all services without starting | +| `make clean-all` | Clean all build artifacts | +| `make tidy-all` | Run `go mod tidy` for all services | + +### Individual Service Control + +You can control individual services using the pattern `make <action>-<service>`: + +```bash +# Build specific service +make build-adservice +make build-cartservice + +# Start specific service +make start-adservice +make start-cartservice + +# Stop specific service +make stop-adservice +make stop-cartservice +``` + +### Available Services + +- `adservice` - Advertisement service +- `cartservice` - Shopping cart service +- `checkoutservice` - Checkout processing service +- `currencyservice` - Currency conversion service +- `emailservice` - Email notification service +- `frontendservice` - Web frontend service +- `paymentservice` - Payment processing service +- `productcatalogservice` - Product catalog service +- `recommendationservice` - Product recommendation service +- `shippingservice` - Shipping cost calculation service + +### Environment Setup + +Initialize your development environment: + +```bash +# Check prerequisites and initialize project +make init + +# Check environment dependencies +make check-env +``` + +### Service Monitoring + +Monitor your services: + +```bash +# Check which services are running +make status + +# View recent logs from all services +make logs + +# View logs for a specific service +tail -f logs/frontend.log Review Comment: fix -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
