prisma-compute
由 prisma 提供的 prisma-compute Skill,包含安装方法、功能说明、完整指令和 GitHub 原文入口。
name: prisma-compute
description: Deploy and operate apps on Prisma Compute with the Prisma 8 CLI. Use whenever the user mentions Prisma Compute, deploying or hosting a Prisma app, prisma deploy, prisma dev module.ts, Prisma Composer apps (module.ts, compute(), the composer section of prisma.config.ts), preview stages, deploy on push (prisma git connect, prisma/cloud-deploy-action), prisma service logs, versions, rollback, or custom domains, project env, PRISMA_SERVICE_TOKEN, regions, 504s, sleeping instances, or waitUntil; also when a project still uses the removed @prisma/cli app deploy, prisma.compute.ts, defineComputeConfig, compute:deploy, or build logs surface.
license: MIT
metadata:
author: prisma
version: "2.1.0"
功能说明
Deploy and operate apps on Prisma Compute with the Prisma 8 CLI. Use whenever the user mentions Prisma Compute, deploying or hosting a Prisma app, prisma deploy, prisma dev module.ts, Prisma Composer apps (module.ts, compute(), the composer section of prisma.config.ts), preview stages, deploy on push (prisma git connect, prisma/cloud-deploy-action), prisma service logs, versions, rollback, or custom domains, project env, PRISMA_SERVICE_TOKEN, regions, 504s, sleeping instances, or waitUntil; also when a project still uses the removed @prisma/cli app deploy, prisma.compute.ts, defineComputeConfig, compute:deploy, or build logs surface.
快速安装
npx skills add https://github.com/prisma/skills --skill prisma-compute
交给 AI 助手使用
以下是页面提示词的中文转述,命令保持原样。
运行 npx skills use "https://github.com/prisma/skills" --skill "prisma-compute",完整阅读输出并按 Skill 说明操作。必要时先将输出保存到临时文件;相对路径以输出提供的支持文件目录为准。
补充说明
Deploy and operate apps on Prisma Compute with the Prisma 8 CLI. Use whenever the user mentions Prisma Compute, deploying or hosting a Prisma app, `prisma...
Prisma Compute
Deploy TypeScript apps to Prisma Compute and operate them afterwards. Every deploy goes through a Prisma Composer app (a module.ts root module) and the Prisma 8 CLI, prisma.
Verified against prisma 8.0.0-rc.21 (published identically as @prisma/cli), @prisma/composer and @prisma/composer-prisma-cloud 0.28.0, @prisma/compute 0.1.0-beta.0, and create-prisma 0.14.1. Re-checked against prisma 8.0.0-rc.23, whose command surface matches rc.21, and Composer 0.30.0, which adds node()'s dependencies option (0.29.0) and narrows the supported Node.js versions. The CLI moves fast: run npx prisma <group> --help before using a flag this skill does not show.
Version-Matched Skills
The installed packages ship their own agent skills, matched to the installed version:
prisma-platform-core-concepts, insideprisma: projects, branches, services, versions, env vars, deploy on push.prisma-composer-core-concepts, inside@prisma/composer: declaring services, modules, databases, and builds;dev,deploy, and teardown.
npx prisma skills sync copies them into the agent skill directories (.claude/skills, .cursor/skills, .agents/skills, .devin/skills), and npx prisma skills list shows what is installed. npx prisma init does the same and adds a postinstall hook that keeps them current. When those skills are installed, use them for API details. This skill covers the deploy and operations workflow and its pitfalls.
Removed Surface
The Compute CLI from before Composer is gone. Its commands fail with CLI.UNKNOWN_COMMAND (removed flags with CLI.INVALID_ARGUMENTS), its config files are not read, and its environment variables are ignored:
| Removed | Use instead |
|---|---|
@prisma/cli app deploy, app build, app run |
Your own build script, then npx prisma deploy module.ts; npx prisma dev module.ts to run locally |
prisma.compute.ts, prisma.compute.json, defineComputeConfig |
module.ts, a service.ts per server declared with compute(), and the composer section of prisma.config.ts |
init writing a compute config |
npx prisma init now writes a prisma.config.ts with only a skills section, adds prisma as a dev dependency, and syncs skills. Add the composer section yourself |
compute:deploy script |
npx prisma deploy module.ts, or the deploy script current create-prisma generates |
app deploy --branch <name> |
npx prisma deploy module.ts --stage <name> |
app deploy --prod, --no-promote, app promote |
No --stage deploys production; service version promote <version-id> |
app show, app open, app list-deploys, app show-deploy |
service show <service>, service open <service>, service version list <service>, service version show <version-id> |
app logs |
service logs <service> |
app rollback --to <id> --yes |
service version rollback <service> --to <id> --confirm <id> |
app domain ... |
service domain ... --service <service> |
app remove |
Remove the provision() from module.ts and deploy, or service delete <service> --confirm <service> |
build logs <build-id> |
The GitHub Actions run log or the Console; GET /v1/builds/{buildId} for state and failing step |
database ... |
postgres ... |
project env remove |
project env delete |
auth logout --workspace <id> |
auth workspace logout <id> |
agent install, agent update, agent status |
npx skills add prisma/skills --skill prisma-compute; npx prisma skills sync for package skills |
PRISMA_PROJECT_ID, PRISMA_APP_ID, PRISMA_SERVICE_ID |
--project <id-or-name>, the service as a positional argument, and .prisma/local.json from project link |
/v1/apps REST endpoints |
/v1/services (the /v1/apps paths are deprecated) |
A repository with prisma.compute.ts or a compute:deploy script was set up for the removed flow. Port it to Composer (app-composer-setup.md) instead of running the old commands.
When to Apply
- Deploying a new or existing app to Prisma Compute
- Finishing the Console's Set up Prisma Cloud deploys pull request (
prisma-cloud/setup) - Porting a project that uses
prisma.compute.ts,compute:deploy, or@prisma/cli app deploy - Setting up preview stages, deploy on push, or CI deploys
- Reading service logs, listing versions, promoting, or rolling back
- Managing env vars, custom domains, Prisma Postgres databases, or buckets in a Compute project
- Debugging a failed deploy, an unreachable service, a
504, or work that stops when an instance sleeps
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | CLI surface | CRITICAL | cli- |
| 2 | App declaration | CRITICAL | app- |
| 3 | Runtime | CRITICAL | runtime- |
| 4 | Deploy | HIGH | deploy- |
| 5 | Operations | HIGH | ops- |
| 6 | Debugging | HIGH | debug- |
| 7 | Automation | MEDIUM | automation- |
Quick Reference
1. CLI surface (CRITICAL)
cli-prisma-8-binary- Platform and deploy commands exist only in the Prisma 8 CLI. In a Prisma 6 or 7 project,npx prismaruns that version's ORM CLI, which has noauth,project,service, ordeploy; Prisma 7'sdevstarts a local database instead. Checknpx prisma --version; outside a Prisma 8 project usenpx @prisma/cli@latest <command>.cli-help-first- Command groups areauth,project(withproject env),postgres,bucket,branch,git, andservice(withservice versionandservice domain), plusdeploy,dev,init,skills, andfeedback. Read--helpbefore using a flag.cli-json- Pass--json, and--no-interactivein scripts. Branch onerror.code(NAMESPACE.SUBCODE) and follownextActions; do not parse messages.cli-explicit-targets- Name the service as the first argument, the project with--project(or link the directory), and a preview with--branch. Without--brancha command targets the production branch; the CLI does not read the current Git branch.cli-consent-tokens- Destructive commands need--confirm <token>with an exact id, name, or hostname.--yescannot grant consent. Run them only when the user asked for that action.
2. App declaration (CRITICAL)
app-composer-required- A deployable app hasmodule.ts(default exportmodule(name, ...)), aservice.tsper server (compute({ name, deps, build })), and acomposersection inprisma.config.tswithprismaCloud(),nodeBuild()(plusnextjsBuild()for Next.js), andstate: prismaState().app-build-adapter-node({ module: import.meta.url, entry })for one self-contained bundle,node({ module, dir, entry })for a built directory,nextjs({ module, appDir })for Next.js standalone. Adddependencies: "external"tonode()when the build leaves packages as imports. Seeapp-framework-builds.md.app-region- The first deploy creates the project and needs a region:prismaCloud({ region: "eu-central-1" })orPRISMA_REGION. The region cannot change later.app-databases-rawPostgres()(package root) delivers{ url };postgres(contract)from@prisma/composer-prisma-cloud/ormadds a typed client and applies committed migrations on deploy. Read both throughservice.load(), notprocess.env.DATABASE_URL.app-names- Provision ids and service names allow[A-Za-z0-9]only, and the platform rejects ids shorter than three characters. The root module name becomes the project name.
3. Runtime (CRITICAL)
runtime-bind-all-interfaces- Listen onservice.port()(also exported asPORT, default 3000) and bind0.0.0.0. A loopback listener is unreachable.runtime-bun- Services run on Bun. By default (dependencies: "bundled") a deploy ships only the build output, never the project'snode_modules, so the build must inline every dependency except runtime built-ins. A build that leaves packages as imports (tsc, Astro's Node adapter) setsdependencies: "external"onnode(), and the deploy stages the installed packages its entry imports.runtime-first-byte-60s- A request that sends no bytes for 60 seconds gets504 Gateway Time-outand is cancelled. Respond first, then continue underwaitUntilor from a queue.runtime-sleep- Idle instances are snapshotted and resumed. Timers and floating promises can stall.waitUntilandKeepAwakeGuardfrom@prisma/computekeep an instance awake on a best-effort basis; they do not make work durable.runtime-no-websockets- WebSocket servers are not supported.
4. Deploy (HIGH)
deploy-build-first-deployanddevdo not build. Run the build, thennpx prisma deploy module.ts.deploy-dev-first-npx prisma dev module.tsruns the whole app locally with no credentials. Verify each local URL before deploying.deploy-production-intent- A deploy without--stage, and a push to the default branch of a connected repository, change production. Get the user's go-ahead first; use--stage <name>for previews.deploy-auth- On a workstation the user runsnpx prisma auth login(browser). In CI setPRISMA_SERVICE_TOKENandPRISMA_WORKSPACE_ID. Checknpx prisma auth whoami --json(envelope.result.authenticated,envelope.result.workspace) before deploying.deploy-link-after-deployfinds or creates the project by the root module name (or--name) and does not write.prisma/local.json. Runnpx prisma project link <app-name>afterwards, or pass--project, beforeservice,git, orproject envcommands.deploy-on-push- Deploy on push needs bothnpx prisma git connect(interactive) and a workflow runningprisma/cloud-deploy-action@v1. Connecting alone deploys nothing.deploy-existing-app- An existing server built withtscdeploys throughmodule.mjsandsrc/service.mts, takes its client fromservice.load().db.client(DATABASE_URLis the placeholder-on Compute), and shipsviews/,public/and other runtime files insidedist/. The Console's setup pull request gets some of this wrong. Seedeploy-existing-app.md; a Prisma 6 or 7 app upgrades withprisma-postgres-upgradefirst.deploy-verify-url- Take each service URL from the deploy output (--jsonresult or--report <path>) and request it.
5. Operations (HIGH)
ops-logs-service logs <service>reads the live version;--version-id <id>reads another,--followstreams. Build output lives in the CI log or the Console, not the CLI.ops-versions-service version promote <version-id>rebuilds with production env vars.service version rollback <service> --to <id> --confirm <id>switches back without a rebuild.ops-env-write-only-project env add|update|list|deletewith--role production,--role preview, or--branch <name>. Values are never returned and apply on the next deploy.ops-domains-service domain add <hostname> --service <service>, create the CNAME it reports, thenservice domain wait. Production branch only.ops-secrets-once-postgres create,postgres connection create|rotate, andbucket key createprint credentials once. Store them; never echo them.
6. Debugging (HIGH)
debug-error-code-first- Readerror.codeandnextActionsfrom--jsonoutput, orfailure.codefrom the--reportfile, before changing anything.debug-public-url- Test the printed public URL, notlocalhost. A deploy that converged but does not answer is usually host binding, the port, or a crash at boot; readservice logs.debug-report-cli-bugs- Report unresolvable CLI failures withnpx prisma feedback "<message>"without secrets.
7. Automation (MEDIUM)
automation-create-prisma-create-prismascaffolds a new Prisma 8 project that is already a Composer app. Its--jsonmode deploys unless--no-deployis passed.automation-control-api-@prisma/composer/controlexposesdeploy,destroy,dev, andlog. Teardown of a stage isdestroy; it reads onlyPRISMA_SERVICE_TOKENandPRISMA_WORKSPACE_ID.automation-rest-api- Use/v1/services,/v1/deployments/{deploymentId}/logs, and/v1/buildsfromhttps://api.prisma.io/v1/doc. Do not build new deploy tooling on@prisma/compute-sdk.
Preferred Workflow
- Inspect
package.json(isprisma8.x a dev dependency, are@prisma/composerand@prisma/composer-prisma-cloudinstalled?),module.ts,prisma.config.ts, the build script, and leftovers from the removed flow (prisma.compute.ts,compute:deploy). - Install what is missing and sync the package skills. In an existing project, pin the Composer packages with
--save-exactto the version that matches the installedprismaand@prisma/orm-postgres(seedeploy-existing-app.md); unpinned installs take the latest release, which may not work with them:npm install @prisma/composer @prisma/composer-prisma-cloud npm install -D prisma npx prisma skills sync - Declare or port the app:
app-composer-setup.mdandapp-framework-builds.md. - Build, run
npx prisma dev module.ts, and request each local URL it prints. - Run
npx prisma auth whoami --json. Ifenvelope.result.authenticatedisfalse, ask the user to runnpx prisma auth login. - Deploy a preview with
npm run build && npx prisma deploy module.ts --stage <name> --json, or production without--stageonce the user confirms. A new project needs a region. - Request each printed URL, then
npx prisma project link <app-name>andnpx prisma service list --json(add--branch <stage>for a preview). - Report the app name, stage, service ids, URLs, and database ids. Never report secret values.
Avoid
- Do not run
@prisma/cli app ...,build logs, ordatabase ..., and do not createprisma.compute.ts. - Do not run platform commands through a Prisma 6 or 7
prismabinary. - Do not read the port or connection strings from
process.envin a Composer service. - Do not expect
deployto build, to migrate arawPostgres()database, or to copy production data into a stage. - Do not pass
--yesto destructive commands; it cannot grant consent. - Do not run
auth loginorgit connectnon-interactively; both need a person at a browser. - Do not push to the default branch of a connected repository without the user's go-ahead; it deploys production.
References
cli-command-map.md: every verified command, global flags, JSON envelope, targeting, consent tokensapp-composer-setup.md: the minimum declaration, region, databases, config and secrets, porting fromprisma.compute.tsapp-framework-builds.md: build output andbuild:adapter per frameworkruntime-requirements.md: Bun, host and port, 60-second first byte, sleep, keep-awake, regionsdeploy-cli-and-ci.md:prisma deploy, stages, credentials, output, CI, teardowndeploy-on-push.md: GitHub connection and theprisma/cloud-deploy-actionworkflowdeploy-existing-app.md: an existingtscserver, the Console's setup pull request and its fixes, and the same files without oneops-services-and-config.md: services, versions, logs, domains, env vars, databases, bucketsdebug-deploy-failures.md: symptoms, causes, and fixesautomation-create-prisma.md: scaffolding a new Composer appautomation-rest-api.md: REST API paths, the control API, and the status of@prisma/compute-sdk
Docs: Compute, Deploy your first app, Composer, CLI reference.
Feedback
npx prisma feedback "<message>" sends anonymous feedback to the CLI team with the CLI version, Node.js version, and OS platform. Add --email <address> for a reply. Never include tokens, connection URLs, or user data.
来源与许可
prisma/skills 提供此 Skill,适用 MIT。本版本追加了安装和访问入口,并将相对文档链接解析为 GitHub 地址;原始文件可从下方原文入口获取。
MIT License
Copyright (c) 2025 Prisma
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.