Deployments
A deploy produces a version of a service: one built artifact that can serve traffic. Versions live inside a branch, and the live version is the one currently serving requests.
Versions are created three ways:
- A git push. After you set up deploy on push, your repository's GitHub Actions workflow builds and deploys each pushed branch: the default Git branch deploys to production, and every other branch gets an isolated preview.
- The Console. Trigger a build and deploy from the browser.
deploy. For a Prisma Composer app,deployassembles the services you have already built and provisions them from your terminal or CI.
The service commands below manage the versions those flows create. They are targeted explicitly: the service is the first positional argument, and version-scoped commands take a globally unique version id, so there is no interactive picker and no dependence on your current git branch.
bunx prisma service show web
bunx prisma service open web
bunx prisma service version list web
bunx prisma service version show ver_123pnpm prisma service show web
pnpm prisma service open web
pnpm prisma service version list web
pnpm prisma service version show ver_123yarn prisma service show web
yarn prisma service open web
yarn prisma service version list web
yarn prisma service version show ver_123npx prisma service show web
npx prisma service open web
npx prisma service version list web
npx prisma service version show ver_123service show describes the service and its live version, service open opens its URL, version list lists the version history, and version show shows one version in detail.
service show describes the service and its live version, service open opens its URL, version list lists the version history, and version show shows one version in detail.
Read a version's logs with service logs. It defaults to the live version; --version-id <id> selects another:
bunx prisma service logs web --follow
bunx prisma service logs web --version-id ver_123 --tail 200pnpm prisma service logs web --follow
pnpm prisma service logs web --version-id ver_123 --tail 200yarn prisma service logs web --follow
yarn prisma service logs web --version-id ver_123 --tail 200npx prisma service logs web --follow
npx prisma service logs web --version-id ver_123 --tail 200Build output for a deploy is available in the Console alongside the version it produced.
Build output for a deploy is available in the Console alongside the version it produced.
Promote a preview version to production:
bunx prisma service version promote ver_123pnpm prisma service version promote ver_123yarn prisma service version promote ver_123npx prisma service version promote ver_123Promotion rebuilds the version with production environment variables and makes the result live behind the service's endpoint. The rebuild is what lets a version built for a preview branch pick up production environment variables on its way to production.
Roll back production to a previous version. Rollback reuses an existing build, so there is no rebuild step between you and a known-good state:
Promotion rebuilds the version with production environment variables and makes the result live behind the service's endpoint. The rebuild is what lets a version built for a preview branch pick up production environment variables on its way to production.
Roll back production to a previous version. Rollback reuses an existing build, so there is no rebuild step between you and a known-good state:
bunx prisma service version rollback web
bunx prisma service version rollback web --to ver_123pnpm prisma service version rollback web
pnpm prisma service version rollback web --to ver_123yarn prisma service version rollback web
yarn prisma service version rollback web --to ver_123npx prisma service version rollback web
npx prisma service version rollback web --to ver_123Without --to, rollback targets the version before the live one.
bunx prisma service version stop ver_123
bunx prisma service version start ver_123
bunx prisma service version delete ver_123pnpm prisma service version stop ver_123
pnpm prisma service version start ver_123
pnpm prisma service version delete ver_123yarn prisma service version stop ver_123
yarn prisma service version start ver_123
yarn prisma service version delete ver_123npx prisma service version stop ver_123
npx prisma service version start ver_123
npx prisma service version delete ver_123Stopping a version takes it out of service without deleting its artifact; starting it brings it back. Deleting a version permanently removes it and the artifact it holds, after confirmation.
Stopping a version takes it out of service without deleting its artifact; starting it brings it back. Deleting a version permanently removes it and the artifact it holds, after confirmation.
bunx prisma service delete webpnpm prisma service delete webyarn prisma service delete webnpx prisma service delete webThis permanently deletes the service from the branch you target with --branch. Pass --yes to skip the confirmation prompt.
This permanently deletes the service from the branch you target with --branch. Pass --yes to skip the confirmation prompt.
- Environment variables: persist config across deploys.
- Deploy on push: the push-to-deploy flow in detail.
- Domains: point a custom domain at production.
- Prisma Composer: declare the app the
deploycommand deploys.