vishipayyallore/productsapi

产品API服务 Docker镜像文档

镜像概述

该镜像包含一个基于.NET 6的Web API服务（products.api），配合MongoDB数据库（productsdb），提供产品管理相关的后端功能支持。通过Docker Compose可快速部署完整的产品服务环境。

核心功能和特性

• 技术栈：基于.NET 6构建的Web API
• 数据库：使用MongoDB存储产品数据，支持数据持久化
• 配置灵活：通过环境变量配置数据库连接信息
• 服务依赖：明确依赖MongoDB服务，确保服务间正确通信
• 端口映射：默认暴露80端口，可映射到主机端口提供访问

使用场景

适用于电子商务平台的产品管理后端服务，可提供产品信息的CRUD（创建、读取、更新、删除）等API接口，支持前端应用或其他服务调用。

使用方法和配置说明

前置要求

• 已安装Docker和Docker Compose
• 网络环境允许访问Docker Hub拉取镜像（mongo和vishipayyallore/productsapi:latest）

Docker Compose部署示例

创建docker-compose.yml文件，内容如下：

yaml
version: '3.4'

services:
  productsdb:
    image: mongo
    container_name: productsdb
    restart: always
    ports:
      - "27017:27017"
    volumes:
      - mongo_data:/data/db

  products.api:
    image: vishipayyallore/productsapi:latest
    container_name: products.api
    environment:
      - "MongoDbSettings__ConnectionString=mongodb://productsdb:27017"
    depends_on:
      - productsdb
    ports:
      - "8000:80"
    volumes:
      - ${APPDATA}/ASP.NET/Https:/root/.aspnet/https:ro

volumes:
  mongo_data:

部署步骤

1. 将上述内容保存为docker-compose.yml
2. 在文件所在目录执行命令：docker-compose up -d
3. 服务将在后台启动，可通过docker-compose ps查看运行状态

配置说明

1. 数据库服务（productsdb）

• 镜像：使用官方MongoDB镜像（mongo）
• 容器名称：固定为productsdb
• 重启策略：always（服务退出时自动重启）
• 端口映射：主机27017端口映射到容器27017端口（MongoDB默认端口）
• 数据持久化：通过mongo_data卷挂载/data/db目录，确保数据不丢失

2. API服务（products.api）

• 镜像：vishipayyallore/productsapi:latest
• 容器名称：固定为products.api
• 环境变量：
  • MongoDbSettings__ConnectionString：数据库连接字符串，默认配置为mongodb://productsdb:27017（指向同一网络中的productsdb服务）
• 依赖关系：depends_on: productsdb（确保数据库服务先启动）
• 端口映射：主机8000端口映射到容器80端口（API服务默认端口）
• HTTPS证书挂载：通过${APPDATA}/ASP.NET/Https:/root/.aspnet/https:ro挂载主机ASP.NET HTTPS证书目录（只读权限），用于支持HTTPS访问

访问服务

服务启动后，可通过http://localhost:8000访问产品API服务接口。具体接口文档可参考项目GitHub地址中的说明。