InsForge Cli Skills

使用 CLI 创建和管理 InsForge 项目,负责身份验证、项目配置、数据库管理、边缘函数、存储、部署以及密钥...

安装

概览

InsForge CLI 是一个专为 InsForge Backend-as-a-Service(BaaS)平台设计的命令行工具,旨在帮助开发者高效地创建、配置和管理云端后端项目。它通过统一的终端接口集成了身份验证、数据库操作、边缘函数部署、对象存储管理、定时任务调度以及应用部署等核心功能,显著简化了现代全栈开发的运维流程。该工具支持非交互式操作模式,便于集成到 CI/CD 流水线中,并提供了丰富的 JSON 输出选项,方便脚本与自动化系统处理数据。使用 InsForge CLI 前需确保已正确登录并获得项目授权,否则将无法执行大多数命令。其设计注重安全性和可观测性,例如密钥软删除机制、详细的日志分类查询能力,以及严格的构建前置检查,确保生产环境的稳定性与可追溯性。

核心功能特点

  1. 支持 OAuth 和密码两种方式的身份认证,兼容非交互式环境变量登录
  2. 提供完整的数据库管理功能,包括 SQL 查询、表结构检查、RPC 函数调用及导入导出备份
  3. 内置边缘函数部署与调用机制,可直接从本地目录发布 TypeScript 函数并触发测试执行
  4. 对象存储操作涵盖桶的增删、文件上传下载及列表检索,支持公有和私有访问控制
  5. 定时任务(Schedule)采用 PostgreSQL cron 格式,支持基于 HTTP 请求的周期性作业编排,并允许引用加密密钥
  6. 前端应用一键部署至 InsForge 托管平台,自动识别主流框架(如 Vite、Next.js)的环境变量前缀规则

适用场景

InsForge CLI 特别适合需要快速搭建并持续维护云原生后端服务的开发团队。对于初创公司或独立开发者而言,它降低了从零开始构建后端基础设施的技术门槛——只需几条命令即可完成数据库初始化、设置行级安全策略、部署用户认证逻辑,并将 React/Vue 前端应用上线。在 DevOps 实践中,该工具极大提升了自动化部署的效率:开发者可在本地完成代码编译后,通过 `insforge deployments deploy` 将构建产物推送到云端,避免因远程构建失败造成的资源浪费。此外,当系统出现异常时,CLI 提供的多源日志查询功能(如 `function.logs`、`postgres.logs`)能精准定位问题根源,无论是函数超时、SQL 约束冲突还是 API 鉴权错误。对于依赖定时任务的场景,如每日数据清理、第三方 API 轮询同步或邮件发送调度,CLI 的 Schedule 模块结合 Secrets 管理,使得敏感凭证的安全注入变得简单可靠。总之,任何涉及 InsForge BaaS 平台的日常开发、调试、监控与维护工作,都能通过 InsForge CLI 实现高度一致且高效的终端操作体验。