Reference
pier deploy
Build and roll changed apps and sites (implies apply)
pier deploy [<ref>] [flags]Build and roll changed apps and sites (implies apply).
Arguments
| Argument | Required | Description |
|---|---|---|
<ref> | no | Deploy one app or site only (name or name/target); default: everything changed |
Flags
| Flag | Value | Default | Description |
|---|---|---|---|
-y, --yes | Skip confirmation prompt | ||
-f, --force | Force rebuild all apps | ||
--tag | latest | Image tag | |
--no-resume | Refuse to resume suspended targets — fail fast (CI escape hatch) | ||
--prune-external | Also delete resources on the server that aren't in pier.yaml and were never applied from it (added via console/API) | ||
--purge | Deletes in this deploy skip the 30-day recovery window (torn down immediately) | ||
--rename | KIND.OLD=NEW,... | Apply a rename in place instead of delete+create (KIND.OLD=NEW, e.g. apps.api=gateway). Repeatable. | |
--path | STRING | Site only: directory to build and upload (default: the site's build context) | |
--build-cmd | STRING | Site only: override the build command (build-time only) | |
--output-dir | STRING | Site only: override the output directory (build-time only) | |
--skip-build | Site only: skip install and build, upload the directory as is |
Global flags apply to every command.
Examples
pier deploy # everything changed in the current environment
pier deploy api/stage # one target
pier deploy -e prod -y # non-interactive, explicit environment
pier deploy www --path ./dist --skip-buildBehaviour
deployrunsapplyfirst. A change that only touches config (variables, plan) is applied and does not roll the workload; a change to the image, build context or a linked secret does.- A paused target is resumed before it is rolled unless
--no-resumeis set. --purgeand--prune-externaldelete; both are refused without-ywhen there is no terminal.
See also
pier apply · pier deploys ·
pier rollback · Concepts: apply, deploy, staged