xiaopeng163/flask-redis

flask-redis 镜像文档

镜像概述

flask-redis是一个集成了Flask Web框架与Redis数据库的Docker镜像，旨在为开发者提供开箱即用的开发和部署环境。该镜像预配置了Python运行时、Flask依赖及Redis服务，解决了传统开发中环境配置繁琐、依赖冲突等问题，支持快速启动基于Flask和Redis的Web应用。

核心功能与特性

• 预配置环境：内置Python 3.x运行时、Flask框架及常用依赖（如redis-py客户端），无需手动安装
• Redis集成：镜像内置Redis服务，支持应用直接通过本地网络访问，简化缓存、会话存储等功能开发
• 轻量级设计：基于Alpine或Debian slim基础镜像构建，体积小巧，资源占用低
• 灵活配置：支持通过环境变量自定义Flask应用入口、Redis连接参数及端口映射
• 开发友好：支持代码挂载模式，便于开发过程中实时修改和调试应用代码

适用场景

• 开发环境：快速搭建本地开发环境，避免因系统差异导致的"在我电脑上能运行"问题
• 原型验证：快速验证基于Flask+Redis的应用构想，缩短从概念到原型的周期
• 小型Web服务：部署轻量级Web应用，如API服务、数据缓存服务、简单管理后台等
• 教学与演示：作为Flask或Redis教学案例的统一运行环境，确保演示一致性

使用方法与配置说明

基本使用

快速启动容器

通过以下命令启动基础容器，默认启动Flask开发服务器和Redis服务：

bash
docker run -d -p 5000:5000 --name flask-redis-app flask-redis

挂载本地代码（开发模式）

挂载本地Flask应用代码到容器，实现实时开发：

bash
docker run -d -p 5000:5000 \
  -v /path/to/your/flask/app:/app \
  -e FLASK_APP=app.py \
  -e FLASK_ENV=development \
  --name flask-redis-dev flask-redis

环境变量配置

docker-compose配置示例

创建docker-compose.yml文件，实现多容器协调（如需分离Flask和Redis服务）：

yaml
version: '3'
services:
  web:
    image: flask-redis
    ports:
      - "5000:5000"
    volumes:
      - ./app:/app
    environment:
      - FLASK_APP=main.py
      - FLASK_ENV=development
      - REDIS_HOST=redis
    depends_on:
      - redis
  redis:
    image: redis:alpine
    ports:
      - "6379:6379"

启动服务：

bash
docker-compose up -d

基本使用流程

1. 准备应用代码：本地创建Flask应用文件（如app.py），包含基本路由和Redis交互逻辑：

   python
   from flask import Flask
   import redis
   
   app = Flask(__name__)
   r = redis.Redis(host=os.getenv('REDIS_HOST'), port=os.getenv('REDIS_PORT'))
   
   @app.route('/')
   def hello():
       r.incr('visits')
       return f"Hello! Visits: {r.get('visits').decode('utf-8')}"
   
   if __name__ == '__main__':
       app.run(host='0.0.0.0', port=os.getenv('FLASK_PORT'))
   

2. 启动容器：使用上述docker run或docker-compose命令启动容器

3. 访问应用：通过http://localhost:5000访问Web服务，验证Flask与Redis功能是否正常

注意事项

• 生产环境建议分离Flask应用与Redis服务，通过独立的Redis容器提供数据库服务
• 敏感配置（如Redis密码）建议通过Docker Secrets或环境变量文件注入，避免硬编码
• 调整FLASK_ENV=production时，需配置生产级WSGI服务器（如Gunicorn）以提高性能和稳定性