Add 'kpod history' command
Signed-off-by: umohnani8 <umohnani@redhat.com>
This commit is contained in:
parent
b4973e1006
commit
ad490708a4
6 changed files with 518 additions and 1 deletions
69
docs/kpod-history.1.md
Normal file
69
docs/kpod-history.1.md
Normal file
|
@ -0,0 +1,69 @@
|
|||
% kpod(8) # kpod-history - Simple tool to view the history of an image
|
||||
% Urvashi Mohnani
|
||||
% JULY 2017
|
||||
# NAME
|
||||
kpod-history - Shows the history of an image.
|
||||
|
||||
# SYNOPSIS
|
||||
**kpod history [OPTIONS] IMAGE[:TAG|DIGEST]**
|
||||
|
||||
# DESCRIPTION
|
||||
**kpod history** displays the history of an image by printing out information
|
||||
about each layer used in the image. The information printed out for each layer
|
||||
include Created (time and date), Created By, Size, and Comment. The output can
|
||||
be truncated or not using the **--no-trunc** flag. If the **--human** flag is
|
||||
set, the time of creation and size are printed out in a human readable format.
|
||||
The **--quiet** flag displays the ID of the image only when set and the **--format**
|
||||
flag is used to print the information using the Go template provided by the user.
|
||||
|
||||
Valid placeholders for the Go template are listed below:
|
||||
| **Placeholder** | **Description** |
|
||||
|-----------------|------------------------------------------------------------------------------|
|
||||
| .ID | Image ID |
|
||||
| .Created | if **--human**, time elapsed since creation, otherwise time stamp of creation|
|
||||
| .CreatedBy | Command used to create the layer |
|
||||
| .Size | Size of layer on disk |
|
||||
| .Comment | Comment for the layer |
|
||||
|
||||
**kpod [GLOBAL OPTIONS]**
|
||||
|
||||
**kpod [GLOBAL OPTIONS] history [OPTIONS]**
|
||||
|
||||
# GLOBAL OPTIONS
|
||||
|
||||
**--help, -h**
|
||||
Print usage statement
|
||||
|
||||
# OPTIONS
|
||||
|
||||
**--human, -H**
|
||||
Display sizes and dates in human readable format
|
||||
|
||||
**--no-trunc**
|
||||
Do not truncate the output
|
||||
|
||||
**--quiet, -q**
|
||||
Print the numeric IDs only
|
||||
|
||||
**--format**
|
||||
Pretty-print history of the image using a Go template
|
||||
|
||||
**--json**
|
||||
Print the history in JSON form
|
||||
|
||||
# COMMANDS
|
||||
|
||||
**kpod history debian**
|
||||
|
||||
**kpod history --no-trunc=true --human=false debian**
|
||||
|
||||
**kpod history --format "{{.ID}} {{.Created}}" debian**
|
||||
|
||||
## history
|
||||
Show the history of an image
|
||||
|
||||
# SEE ALSO
|
||||
kpod(1), crio(8), crio.conf(5)
|
||||
|
||||
# HISTORY
|
||||
July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|
Loading…
Add table
Add a link
Reference in a new issue