lizard service

Manage an individual service’s configuration, source, and lifecycle.

Usage

lizard service set [service] [flags]
lizard service show [service] [flags]
lizard service rename <new-name> [flags]
lizard service delete [service] [flags]
lizard service logs [service] [flags]
lizard service link [name]

Subcommands

lizard service set

Apply build/start/source/variables/rename changes to a service.

FlagDescription
--set <path>=<value>Set a field (repeatable; needs the service argument)
-f, --file <path>JSON config file to apply
--forceOverwrite even if changed remotely

Common fields are flat and map 1:1 to the wire schema: sourceType, repoUrl, branch, rootDirectory, dockerfilePath, buildCommand, startCommand, preDeployCommand, watchPatterns, containerPort, cpuLimit (for example 2000m), memoryLimit (for example 2Gi), name. variables.<KEY>=<value> sets a service secret, the same as lizard secrets set --service.

service set uses optimistic concurrency via configRevision. On a 409, re-read the config with lizard service show, reconcile, and retry — or pass --force.

lizard service show

Show the current service configuration as JSON. Use -s to limit to one service.

lizard service rename <new-name>

Rename a service or addon: the linked one, or the one you pass with -s. References use the target’s current name, so update every ${{old-name.KEY}} to the new name after a rename.

lizard service delete

Delete a service (alias rm). -y, --yes skips confirmation; without a TTY it is required.

lizard service logs

Stream a service’s logs (see also lizard logs).

FlagDescription
--buildShow the latest build’s logs
-n, --tail <n>Print the last N lines (up to 2000) and exit; --tail all prints 2000
--page <n>Page through older logs, 200 lines per page (1 = most recent)

Link a service to the current directory.

Examples

Update a service’s build and start commands

lizard service set api --set branch=main --set buildCommand="npm run build"

Inspect a service’s full configuration

lizard service show -s api

Delete a service without a confirmation prompt

lizard service delete -y

See also

  • lizard port — show or change a service’s container port
  • lizard scale — scale a service’s replicas, CPU, memory, or storage
  • Architecture — how services relate to projects and addons
  • Build pipeline — how buildCommand, startCommand, and source settings are used at build time

Updated