upswot/upswot.api Docker 镜像 - 轩辕镜像

Upswot.API Docker镜像文档

镜像概述

Upswot.API Docker镜像是用于部署和运行Upswot.API服务的容器化解决方案，基于ASP.NET Core构建，提供便捷的服务配置与运行能力，支持通过环境变量自定义应用参数，同时支持日志持久化存储。

核心功能与特性

• 环境变量配置：支持通过环境变量设置ASP.NET Core运行环境、服务监听URL及应用特定配置
• 端口映射：可将容器内服务端口映射至主机，实现外部网络访问
• 日志持久化：支持挂载主机目录至容器日志目录，确保日志文件持久化存储
• 服务自愈：结合Docker Compose的restart: always配置，实现服务异常自动重启

使用场景

适用于Upswot.API服务的部署场景，包括但不限于：

• 开发环境快速启动与测试
• 测试环境服务验证
• 生产环境稳定部署（配合日志持久化与服务自愈配置）

使用方法与配置说明

1. Docker Run命令部署

通过docker run命令快速启动服务，示例如下：

bash
docker run -d -p 8081:80 \
  -e ASPNETCORE_ENVIRONMENT=Production \
  -e ASPNETCORE_URLS=[***] \
  -e AppSettings:ServiceClientsFolder=/Services \
  -e AppSettings:AuthProvidersFolder=/Services \
  -e AppSettings:SecurePolicy=false \
  -v /var/docker/upswot.api:/logs \
  upswot/upswot.api:<tag>

参数说明：

• -d：后台运行容器
• -p 8081:80：将主机8081端口映射至容器内80端口（服务监听端口）
• -e：设置环境变量（详见"环境变量配置"部分）
• -v /var/docker/upswot.api:/logs：将主机/var/docker/upswot.api目录挂载至容器/logs目录，用于持久化存储日志
• upswot/upswot.api:<tag>：指定镜像名称及版本标签（需替换<tag>为实际版本）

2. Docker Compose部署

通过docker-compose.yml配置文件实现更灵活的服务管理，示例配置如下：

yaml
version: '3.4'
services:
  upswot.api:
    image: upswot/upswot.api:<tag>
    restart: always  # 服务异常时自动重启
    environment:
      - ASPNETCORE_ENVIRONMENT=Production  # 设置运行环境为生产环境
      - ASPNETCORE_URLS=[***]  # 服务监听容器内80端口
      - AppSettings:ServiceClientsFolder=/Services  # 服务客户端文件夹路径
      - AppSettings:AuthProvidersFolder=/Services  # 认证提供者文件夹路径
      - AppSettings:SecurePolicy=false  # 禁用安全策略
    ports:
      - 8081:80  # 端口映射配置
    volumes:
      - ./upswot.api:/logs  # 日志目录挂载（相对路径，当前目录下upswot.api文件夹）

启动命令：在配置文件所在目录执行docker-compose up -d

环境变量配置说明

注意事项

• 需将命令及配置文件中的<tag>替换为实际镜像版本标签（如latest或具体版本号）
• 日志目录挂载路径可根据实际需求调整，确保主机目录存在且有读写权限
• 端口映射中的主机端口（示例中8081）可根据主机端口占用情况调整