opbeans/opbeans-python

Opbeans for Ponies

概述和主要用途

这是基于Django构建的Opbeans演示应用实现，与https://github.com/opbeat/opbeans%E5%85%B1%E4%BA%AB%E7%9B%B8%E5%90%8C%E7%9A%84%E6%95%B0%E6%8D%AE%E5%BA%93%E6%A8%A1%E5%BC%8F%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8EElastic APM的测试和演示。

核心功能和特性

• 基于Django框架开发，适配Python环境
• 与Opbeans Node版本共享数据库模式，确保数据兼容性
• 通过环境变量灵活配置数据库连接
• 支持Celery任务队列（需配合Redis实例）
• 内置演示数据生成机制，运行迁移即可创建测试数据
• 提供默认管理员用户（barista/affogato）
• 支持本地测试，使用https://github.com/sstephenson/bats%E7%BC%96%E5%86%99%E6%B5%8B%E8%AF%95%E7%94%A8%E4%BE%8B
• 可本地构建并发布Docker镜像到Docker Hub

使用场景和适用范围

适用于开发和测试环境中验证Elastic APM对Python应用的监控功能，尤其适合演示和测试Django应用在Elastic APM下的性能和行为。

详细使用方法和配置说明

环境要求

• Python版本：推荐使用Python 3.5及以上版本

安装与依赖配置

1. 创建并激活虚拟环境：

   bash
   # 使用venv创建虚拟环境（示例）
   python -m venv venv
   # 激活虚拟环境（Windows: venv\Scripts\activate；Linux/macOS: source venv/bin/activate）
   

2. 安装依赖包：

   bash
   python -m pip install -r requirements.txt
   

数据库配置

通过环境变量DATABASE_URL配置数据库连接，格式如下：

bash
DATABASE_URL=postgres://user:password@host:port/dbname ./manage.py runserver

Celery与Redis设置

若需使用Celery，需部署Redis实例。本地开发推荐通过Docker快速启动Redis：

bash
docker run -p 6379:6379 redis

演示数据生成

运行数据库迁移命令生成演示数据：

bash
./manage.py migrate

迁移后将自动创建管理员用户：用户名barista，密码affogato。

本地测试

执行以下命令进行本地测试：

bash
make test

测试用例位于tests目录，基于bats框架编写。

Docker镜像发布

本地发布镜像到Docker Hub的命令：

bash
VERSION=1.2.3 make publish

说明：VERSION为镜像标签，指定发布到仓库的镜像版本。