Skip to content
Docs

inquir apps deploy

Build source or release an image for an existing application.

@inquir/compute-cliv0.3.0 · Node.js 22+

Usage#

inquir apps deploybash
inquir apps deploy <app> [options]

Options#

OptionDescription
--image <ref>Release this container image instead of building source.
--build <buildId>Release an existing successful build; mutually exclusive with --image.
--dir <path>Source directory to upload; defaults to the current directory.
--dockerfile <path>Dockerfile relative to the build context; defaults to Dockerfile.
--context <path>Build context inside the uploaded source tree; defaults to .
--target <stage>Select a stage in a multi-stage Dockerfile.
--build-arg KEY=VALUEPass a Docker build argument; repeatable.
--forceRequest a new build instead of reusing a matching successful build.
--port <n>HTTP port inside the container; omit for a TCP-only service.
--tcp <name:port[:public]>Declare a TCP port; repeat for several ports. Public exposure assigns a platform port.
--volume <name:/path[:ro]>Mount a named persistent volume at an absolute container path; repeatable.
--memory <mb>Set the memory ceiling in MB.
--cpu <vcpus>Set the CPU ceiling in vCPUs.
--health-path </path>HTTP path used to check service health.
--health-command <cmd>Health command executed inside the container.
--promoteMove production traffic to this release once healthy.
--no-waitReturn after queuing; inspect completion separately.
--jsonPrint machine-readable results.

Global flags, environments and CLI credentials

Examples#

Example 1bash
inquir apps deploy web
Example 2bash
inquir apps deploy web --image nginx:alpine --port 80 --promote
Example 3bash
inquir apps deploy web --build BUILD_ID --promote

Behavior#

Without --image or --build, the CLI uploads the source directory and builds its Dockerfile on the platform. Local Docker is not required.

Save environment and network policy with apps update before deploying. The deploy handler does not apply --set, --ingress or --egress.

--no-wait skips waiting for the release; a required source build still finishes first.

Guides#