websoft9dev/apphub

镜像概述

本Docker镜像专为FastAPI应用设计，集成多种工具与配置以简化部署流程。基于uvicorn ASGI服务器运行FastAPI应用，内置git支持版本控制，通过入口脚本自动配置远程Gitea凭证，使用supervisord统一管理进程日志并输出至docker logs，同时包含健康检查机制监控关键服务凭证状态，支持依赖隔离与数据持久化。

核心功能与特性

• FastAPI运行环境：采用uvicorn作为ASGI服务器，高效加载并运行FastAPI应用
• Git集成：内置git工具，支持代码拉取、版本控制等操作
• Gitea凭证配置：入口脚本(entrypoint)自动配置远程Gitea的git访问凭证
• 健康检查机制：包含health.sh脚本，实时监控Gitea、Portainer及Nginx凭证状态，异常信息自动输出至日志
• 依赖隔离：使用virtualenv创建独立Python环境，通过pip安装requirements.txt中指定的依赖包
• 数据持久化：Dockerfile中预定义卷(volumes)，支持容器数据持久化存储
• 端口暴露：通过EXPOSE指令开放应用端口，便于外部网络访问
• 日志管理：集成supervisord进程管理工具，确保应用日志统一输出至docker logs，简化日志查看与调试

使用场景与适用范围

• 企业内部FastAPI后端服务的容器化部署
• 需要与Gitea代码仓库集成的版本控制应用
• 需监控第三方服务（如Portainer、Nginx）凭证有效性的场景
• 要求日志集中管理且可通过docker logs直接查看的容器化应用
• 需依赖隔离与数据持久化的Python应用部署

使用方法与配置说明

基本部署命令

bash
docker run -d \
  -p 8000:8000 \  # 映射容器暴露端口至主机（根据实际EXPOSE值调整）
  -v /host/path:/app/volume \  # 挂载本地目录至容器预定义卷
  --name fastapi-service \
  your-image-name:latest

关键配置说明

端口映射

镜像通过EXPOSE指令开放应用端口（具体端口需参考镜像实际定义），部署时需通过-p参数映射至主机端口，例如-p 8000:8000将容器8000端口映射至主机8000端口。

卷挂载

Dockerfile中预创建的卷可通过-v参数挂载本地目录，实现数据持久化。例如-v /host/data:/app/volume将主机/host/data目录挂载至容器卷，确保应用数据在容器重启后不丢失。

环境变量（可选）

若需自定义配置（如Gitea地址、凭证信息等），可通过-e参数传递环境变量：

bash
docker run -d \
  -e GITEA_URL="https://gitea.example.com" \
  -e GITEA_USER="username" \
  -e GITEA_TOKEN="token" \
  docker.xuanyuan.run/your-image-name:latest

（具体环境变量需参考镜像实际支持的配置项）

健康检查查看

容器启动后自动运行health.sh脚本，监控凭证状态。异常日志可通过docker logs直接查看：

bash
docker logs fastapi-service

日志管理

应用所有进程日志通过supervisord统一收集并输出至docker日志流，无需额外配置即可通过docker logs [容器名/ID]查看完整运行日志，支持-f参数实时跟踪日志输出：

bash
docker logs -f fastapi-service