关于 modal-web-scheduling-knowledge
面向使用 Modal 构建 HTTP 端点和定时任务的开发者参考技能，涵盖实现选择、本地测试、部署与排错；不涉及 Modal 计算或存储功能。
主要功能
- 01HTTP 端点路由指引
- 02Cron 与间隔调度
- 03本地服务与部署流程
- 04重试、超时和幂等性建议
- 05部署与日志排错清单
适用场景
- 01为 API 选择端点装饰器
- 02设置周期性 ETL 任务
- 03测试并部署 Modal 应用
- 04排查调度或端点配置问题
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/modal-web-scheduling-knowledge确认已加载。
详细介绍
Modal Web 和调度知识
将此技能用于 Modal Web 端点和定时任务。对于 GPU 计算、自动扩缩容或存储原语，请使用专门的 Modal 计算或存储技能。
端点路由
- 对于简单的函数式 HTTP API，请使用
@modal.fastapi_endpoint()。 - 对于完整的 FastAPI/Starlette 应用、WebSocket、中间件和路由，请使用
@modal.asgi_app()。 - 对于 WSGI 框架，请使用
@modal.wsgi_app()。 - 对于能够安全地在每个容器中并发处理输入的高吞吐量端点，请添加
@modal.concurrent。 - 使用
modal serve在本地测试，然后使用modal deploy部署。
调度路由
- 对于日历计划和明确指定的时区，请使用
modal.Cron(...)。 - 对于基于间隔的执行，请使用
modal.Period(...)。 - 计划任务从已部署的应用运行；
modal run仅用于手动测试。 - 对于计划执行的 ETL 或周期性任务，请添加重试、超时和幂等性。
调试清单
- 测试计划任务时，确认应用已部署。
- 使用有界日志流检查端点日志。
- 部署前验证密钥和环境名称。
- 在扩展流量前，先发送最小请求或手动触发计划任务。
评论
支持 Markdown