一、工作思路概述
本阶段围绕"如何将Python服务部署为Docker容器"展开探索，目标在于实现小规模API服务的容器化部署与自动运行，并初步建立向远程仓库发布镜像的流程。整体思路分为以下几步：
-
构建最小可用Docker环境（Hello World）；
-
优化镜像体积，选用轻量化基础镜像；
-
构建功能性Python服务，具备API请求与文件持久化能力；
-
推送Docker镜像至远程仓库（Docker Hub）；
-
解决部署过程中遇到的网络、权限等问题。
二、已解决问题与解决策略
| 编号 | 问题描述 | 解决方案 |
|---|---|---|
| 1 | Docker镜像构建失败 | 初步诊断为网络问题，通过在Docker Desktop中配置国内镜像源（如清华源）解决 |
| 2 | 默认镜像体积过大（2GB+） | 替换基础镜像为 python:3.12-slim，实现瘦身优化 |
| 3 | 镜像中缺少依赖包 | 添加 requirements.txt，并通过 pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 安装所需依赖 |
| 4 | Python服务功能不足 | 构建基于 requests 的 API 请求逻辑，包含HTTPS容错与数据持久化机制 |
| 5 | 本地数据保存失败 | 使用 os.makedirs 确保数据目录存在，避免因目录缺失导致I/O错误 |
| 6 | Docker 镜像仅存在于本地 | 初步尝试将镜像推送至Docker Hub，并了解远程仓库认证机制 |
三、尚未解决问题
-
Docker Hub无法使用token进行认证
在尝试使用访问令牌进行Docker登录时失败，仅能使用密码登录，认证机制或与客户端版本、命令格式有关，需进一步查阅官方文档或切换至CLI-Login插件方式。
-
镜像大小进一步优化空间未完全探索
当前镜像虽已从2GB压缩至较小体积，但未开启多阶段构建、多层缓存清理等高级构建优化策略。
-
服务仍处于"单体程序 + Docker运行"阶段
未使用Docker Compose或K8s等手段实现服务编排，容器与宿主机日志、挂载等操作未配置完善。
四、关键发现与经验总结
-
合理选择基础镜像可大幅减少镜像体积
使用
python:3.12-slim替代完整镜像，节省构建时间与存储成本。 -
API请求服务中需设计降级机制
网络请求失败时自动退化为备用URL或本地数据，增强鲁棒性。
-
容器化开发中，log、data目录必须显式控制路径
便于后期容器卷挂载与可持续日志管理。
-
国内镜像源在容器环境下尤为重要
可显著提升依赖包下载速度与构建稳定性。