deploy
deploy logs
Show the build output of one deployment.
read onlyrepeatableruns until stopped
The build output of one deployment: the image build and whatever your own build wrote along the way. It is the first place to look when a deployment failed.
This is the build, not the application. What a running application prints is
outplane logs.
Usage
outplane deploy logs <DEPLOYMENT> [flags]Arguments
| Argument | Type | Description |
|---|---|---|
DEPLOYMENT | string | Deployment id, as reported by outplane deploy create. Required. |
Flags
| Flag | Type | Description |
|---|---|---|
-f, --follow | bool | Keep printing until the build finishes. |
--timeout | duration | How long --follow waits before giving up. Defaults to 20m. |
The global flags apply as well.
Examples
Read a finished build
outplane deploy logs 4821Watch a build that is still running
outplane deploy logs 4821 --followSearch a finished build's output
outplane deploy logs 4821 -o textWhat to Know
- Output is the build text, written to stdout as it arrives. It is not JSON, and --json does not change that: there is no record structure to report.
- Build output lives with the build machine and is removed after it is cleaned up, so an old deployment may have none left. That is reported, not treated as an empty build.
- A deployment of an already-built image never had a build, so it has no output.
- Without --follow this returns whatever exists right now, which for a running build is a partial log.
- This is the build.
outplane logsis the running application.
Errors
Beyond 0 for success, this command exits with:
| Exit | Kind | Meaning |
|---|---|---|
2 | usage | Invalid arguments, unknown flag, or client-side validation failure. |
3 | auth | Not authenticated, token revoked or expired, or forbidden for this team. |
5 | not_found | The named resource does not exist, or is not visible to this credential. |
8 | upstream | The Out Plane API returned a server error. |
124 | timeout | A client-side deadline expired. The server operation may still be running. |
The code on the error object is one of deploy.no_build, deploy.logs_gone, app.not_found. Branch on that, or on the exit status. The message is prose and changes.