convox/docs/reference/primitives/app/process.md

42 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2019-12-20 13:45:41 +00:00
# Process
A Process is a running container that is created by running a command on a [Release](release.md).
Long-running Processes are created by [Services](service.md) and will be automatically recreated upon termination.
One-off Processes are created with `convox run`.
## Command Line Interface
### Running a One-off Process
$ convox run web bash -a myapp
myapp@web-96x6s:/$
> You can run a one-off Process using any [Release](release.md) with the `--release` option.
### Listing Processes
$ convox ps -a myapp
ID SERVICE STATUS RELEASE STARTED COMMAND
web-0a1b2c3d4e-8wkjj web running RABCDEFGHI 1 day ago bin/web
web-96x6s web running RABCDEFGHI 1 minute ago bash
### Getting Information about a Process
$ convox ps info web-6499468bf8-8wkjj -a myapp
Id web-6499468bf8-8wkjj
App myapp
Command bin/web
Instance node-0a1b2c3d4e
Release RABCDEFGHI
Service web
Started 1 day ago
Status running
### Terminating a Process
$ convox ps stop web-6499468bf8-8wkjj -a myapp
Stopping web-6499468bf8-8wkjj... OK
> Terminating a Process that is part of a [Service](service.md) will cause a new Process to be started to replace it.