SuperAPI AI 工具集

setup-dev

编程与开发

查看项目

更新于 10-16 05:48

技能介绍

用途:引导用户在本地从零搭建并管理 Sentry 开发环境,覆盖全新安装、更新已有环境、启动开发服务、重置数据库等流程。官方说明完整流程在裸机上约需 30-45 分钟,主要耗时在下载依赖与 Docker 镜像。

主要能力:先检测当前状态(操作系统、shell、devenv 版本、Docker 运行时、OrbStack/Colima、direnv、仓库是否已初始化),再按结果跳到对应步骤;安装前置依赖(macOS 的 Xcode 命令行工具、Homebrew、Docker 运行时);安装 devenv 并配置 shell PATH 与 direnv;执行 bootstrap 与 sync;启动 devservices 并初始化数据库、创建超级用户;启动开发服务器。

必要用法:安装 devenv 使用 curl -fsSL https://raw.githubusercontent.com/getsentry/devenv/main/install-devenv.sh | bash;首次执行 devenv bootstrap,随后 devenv sync;启动服务用 devservices up 与 devservices serve;数据库初始化用 .venv/bin/sentry upgrade --noinput,创建用户用 .venv/bin/sentry createuser --superuser --email admin@sentry.io --password admin --no-input;重置数据库用 make reset-db。开发服务器地址为 http://dev.sentry.localhost:8000,登录 admin@sentry.io / admin。

适用场景:Sentry 贡献者本地开发、调试与日常维护。

限制与注意:需安装 Sentry Cookie Sync 浏览器扩展,否则界面白屏;首次 devservices up 需 5-10 分钟拉取镜像,后续约 30 秒;Kafka 主题警告属正常现象;使用 OrbStack 时部分脚本仅检查 Colima socket,可能需要修补 devservices.py;若配置了 AL MCP(devinfra-mcp),可用 al_search_docs 与 al_read_doc 获取深入排障文档。其他未在资料中说明的细节暂未提供。