用途:介绍 Prisma Platform 上托管、部署、运维应用所需的核心概念(项目、分支、预览环境、服务及版本、Prisma Postgres、存储、环境变量等),作为该版本 prisma 包内技能,描述项目实际安装版本的准确行为。
主要能力:一个 prisma CLI 统一入口,涵盖 Prisma ORM(数据契约、类型化查询、迁移)、Prisma Composer(服务、数据库、存储桶声明)、Prisma Compute(托管)、Prisma Postgres(托管 PostgreSQL)、Prisma Storage(S3 兼容对象存储)。Workspace 为账户边界,Project 为产品/代码库,Branch 为以 git 分支命名的隔离环境,内含服务、数据库、存储桶。首个分支为生产分支,其余为预览分支;预览分支删除上游 git 分支即整体拆除,空闲未固定的可被回收。服务为分支内 HTTP 应用,每次部署生成不可变版本,可提升(promote)到生产或回滚(零停机)。支持 GitHub 与 CLI 两种部署方式,二者收敛同一声明。Compute 运行于 Bun。
使用方式:安装 npm install prisma @prisma/composer @prisma/composer-prisma-cloud;认证 prisma auth login 或设置 PRISMA_SERVICE_TOKEN(多工作区时加 PRISMA_WORKSPACE_ID);生产部署 prisma deploy module.ts,预览加 --stage <name>;本地运行 prisma dev module.ts;同步技能 prisma skills sync。本地栈不支持 Windows。
限制:环境变量值只写不可读,部署时按分支类别解析;生产配置只能是项目模板,分支覆盖仅预览类;资源 id 仅允许 [A-Za-z0-9];自定义域仅能附加到生产分支;运行时无全局 Temporal,需用 temporal-polyfill 或 *String 列类型;数据库 URL、连接串、存储桶密钥仅在创建时显示一次,丢失需轮换;区域创建后不可变更。