submitty/python

镜像概述

Submitty Python镜像官方仓库是Submitty项目官方维护的Python环境镜像集合，旨在为Submitty平台及相关Python应用提供标准化、可移植的运行和开发环境。该镜像基于官方Python镜像构建，预配置Submitty所需的核心依赖，确保跨环境的兼容性和部署一致性，简化开发与运维流程。

核心功能与特性

• 官方认证：Submitty项目官方维护，与Submitty平台版本同步更新，保障环境兼容性
• 依赖预配置：内置Submitty运行及开发所需的Python依赖包（如特定版本的Flask、SQLAlchemy等），减少手动配置步骤
• 多版本支持：提供多种Python版本标签（如3.9、3.10、3.11等），适配不同Submitty版本及应用需求
• 安全可靠：基于官方Python镜像构建，遵循Docker最佳实践，定期更新基础镜像以修复安全漏洞
• 轻量优化：采用slim版本基础镜像，精简体积同时保留核心功能，适合开发与生产环境

使用场景与适用范围

• Submitty平台开发：本地开发环境搭建，确保开发环境与生产环境一致
• 应用部署：Submitty相关Python应用（如插件、扩展工具、后端服务）的容器化部署
• 自动化测试：CI/CD流程（如GitHub Actions、GitLab CI）中的测试环境，保障代码兼容性
• 教学与演示：快速搭建Submitty教学演示环境，降低环境配置门槛

使用方法与配置说明### 基本使用#### 拉取镜像从Docker Hub拉取指定版本的Submitty Python镜像：```bash

docker pull submitty/python:

> 说明：`<tag>`为Python版本标签，格式通常为`{python-version}-{base-image}`，例如`3.10-slim`、`3.9-buster`。具体可用标签请参考https://hub.docker.com/r/submitty/python。

#### 运行交互式容器启动容器并进入交互式终端（适用于开发调试）：```bash
docker run -it --rm submitty/python:3.10-slim /bin/bash

• 参数说明：
  • -it：启用交互模式并分配终端
  • --rm：容器退出后自动删除，避免残留
  • /bin/bash：启动bash终端（可替换为/bin/sh等其他shell）

高级配置#### 挂载本地项目目录将本地项目文件挂载到容器中，实现代码实时同步（开发场景）：```bash

docker run -it --rm -v $(pwd):/app submitty/python:3.10-slim

- 参数说明：`-v $(pwd):/app`将当前目录（`$(pwd)`）挂载到容器内`/app`目录

#### 运行后台服务容器启动长期运行的Python应用（如Web服务）：```bash
docker run -d --name submitty-app -p 8000:8000 -v $(pwd):/app submitty/python:3.10-slim python /app/main.py

• 参数说明：
  • -d：后台运行容器
  • --name submitty-app：指定容器名称
  • -p 8000:8000：端口映射（主机端口:容器端口）
  • python /app/main.py：启动应用的命令（根据实际项目调整）

环境变量配置通过-e参数设置环境变量，适配应用配置需求：```bash

docker run -it --rm -e PYTHONPATH=/app -e LOG_LEVEL=info submitty/python:3.10-slim

- 常用环境变量（可根据应用需求扩展）：
  - `PYTHONPATH`：Python模块搜索路径
  - `LOG_LEVEL`：日志级别（如debug、info、warn）
  - `SUBMITTY_CONFIG`：Submitty配置文件路径

### Docker Compose示例对于多容器应用，可使用`docker-compose.yml`简化部署：```yaml
version: '3.8'
services:
  submitty-python-app:
    image: submitty/python:3.10-slim
    container_name: submitty-app
    volumes:
      - ./src:/app  # 挂载本地代码目录
    ports:
      - "8000:8000"  # 端口映射
    environment:
      - PYTHONPATH=/app
      - SUBMITTY_ENV=production
    command: python /app/main.py  # 应用启动命令

启动服务：

bash
docker-compose up -d

注意事项

• 生产环境建议指定具体版本标签（如3.10-slim）而非latest，避免因镜像更新导致兼容性问题
• 定期执行docker pull submitty/python:<tag>更新镜像，获取最新安全补丁和依赖更新
• 敏感配置（如密钥、数据库密码）建议通过环境变量或挂载配置文件注入，避免硬编码在镜像中