ddtraining/advertisements

广告服务镜像（ecommerce-workshop）

镜像概述

本镜像为ecommerce-workshop项目提供广告服务功能，是项目中负责广告内容管理、展示逻辑处理及投放控制的核心组件。旨在为电商平台提供高效、可配置的广告服务支持。

核心功能与特性

核心功能

• 广告内容管理：支持广告信息的创建、更新、查询与删除
• 广告展示逻辑：根据预设规则（如用户标签、商品类别）动态展示广告
• 投放控制：支持广告投放时段、频次及目标用户群体的设置

特性

• 轻量级设计：基于精简基础镜像，资源占用低
• 易于集成：提供标准API接口，方便与电商平台其他模块对接
• 可配置性：支持通过环境变量调整服务参数，适应不同部署需求

使用场景与适用范围

使用场景

• 电商网站首页广告轮播
• 商品详情页关联广告展示
• 促销活动广告定向投放
• 用户个性化广告推荐

适用范围

• ecommerce-workshop项目内部广告服务部署
• 开发、测试及生产环境的广告功能验证与运行

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name ecommerce-ad-service \
  -p 8080:8080 \
  -e AD_SERVICE_PORT=8080 \
  -e DB_CONNECTION_STRING=jdbc:mysql://db-host:3306/ad_db \
  docker.xuanyuan.run/ecommerce-workshop/advertisements-service:latest

Docker Compose配置

yaml
version: '3.8'
services:
  ad-service:
    image: docker.xuanyuan.run/ecommerce-workshop/advertisements-service:latest
    container_name: ecommerce-ad-service
    ports:
      - "8080:8080"
    environment:
      - AD_SERVICE_PORT=8080
      - DB_CONNECTION_STRING=jdbc:mysql://db:3306/ad_db
      - LOG_LEVEL=INFO
    depends_on:
      - db
  db:
    image: docker.xuanyuan.run/mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=ad_db

环境变量配置

注意事项

• 部署前需确保数据库服务已启动并创建对应的数据库（如示例中的ad_db）
• 生产环境建议配置数据卷挂载，以持久化广告数据
• 高并发场景下可通过调整CACHE_ENABLED和AD_REFRESH_INTERVAL优化性能