springcommunity/spring-petclinic-customers-service

Spring Petclinic Microservices - Customers Service

镜像概述和主要用途

本镜像为Spring Petclinic微服务项目中的客户服务（Customers Service） 组件，负责管理宠物诊所的客户信息，包括客户数据的存储、查询、更新和删除等操作。作为整个微服务架构的重要组成部分，该服务通过REST API提供客户相关功能，并与其他微服务（如宠物服务、预约服务等）协同工作，共同构建完整的宠物诊所管理系统。

详细项目信息请参考：https://github.com/spring-petclinic/spring-petclinic-microservices

核心功能和特性

• 客户数据管理：提供客户信息的创建、查询、更新和删除（CRUD）操作
• REST API接口：通过标准化API与前端或其他微服务进行数据交互
• 微服务集成：支持与Spring Petclinic生态中的其他微服务（如pet-service、appointment-service）通信
• 基于Spring技术栈：构建于Spring Boot、Spring Cloud等框架之上，具备良好的可扩展性和维护性
• 独立部署：作为独立微服务部署，支持水平扩展以应对负载变化

使用场景和适用范围

• 宠物诊所管理系统：作为核心业务模块，用于管理客户基础信息
• 微服务架构演示：作为Spring微服务架构的示例组件，用于学习和实践微服务设计模式
• 企业级应用开发：可作为类似客户管理模块的参考实现，快速构建业务系统

使用方法和配置说明

前提条件

• Docker环境已安装并运行
• （可选）Docker Compose工具（用于多服务协同部署）
• （根据项目要求）数据库服务（如MySQL）或其他依赖服务已部署

从源码构建镜像（推荐）

该服务需从源码构建，详细步骤参考GitHub仓库构建指南：

bash
# 克隆项目仓库
git clone https://github.com/spring-petclinic/spring-petclinic-microservices.git
cd spring-petclinic-microservices/spring-petclinic-customers-service

# 使用Maven构建Docker镜像
./mvnw spring-boot:build-image

运行容器

构建完成后运行容器：

bash
docker run -d -p 8080:8080 --name customers-service docker.xuanyuan.run/spring-petclinic-customers-service:latest

环境变量配置

常用环境变量配置（具体参数参考GitHub文档）：

• SERVER_PORT：服务端口，默认8080
• SPRING_DATASOURCE_URL：数据库连接URL
• SPRING_DATASOURCE_USERNAME：数据库用户名
• SPRING_DATASOURCE_PASSWORD：数据库密码
• EUREKA_CLIENT_SERVICEURL_DEFAULTZONE：服务注册中心地址（如使用Eureka）

示例（带环境变量）：

bash
docker run -d \
  -p 8080:8080 \
  --name customers-service \
  -e SERVER_PORT=8080 \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/petclinic \
  -e SPRING_DATASOURCE_USERNAME=root \
  -e SPRING_DATASOURCE_PASSWORD=petclinic \
  docker.xuanyuan.run/spring-petclinic-customers-service:latest

Docker Compose示例

多服务协同部署示例（参考项目架构调整）：

yaml
version: '3.8'

services:
  customers-service:
    image: docker.xuanyuan.run/spring-petclinic-customers-service:latest
    build:
      context: ./spring-petclinic-customers-service
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=docker
      - SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/petclinic_customers
      - SPRING_DATASOURCE_USERNAME=root
      - SPRING_DATASOURCE_PASSWORD=petclinic
    depends_on:
      - mysql

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=petclinic
      - MYSQL_DATABASE=petclinic_customers
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

配置参数说明

详细配置参数、环境变量及服务集成说明，请参考项目GitHub仓库：
https://github.com/spring-petclinic/spring-petclinic-microservices