logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

podman-history - Show the history of an image

Description

podmanhistory 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.

Examples

       Show the history of the specified image:

       $ podman history debian
       ID              CREATED       CREATED BY                                      SIZE       COMMENT
       b676ca55e4f2c   9 weeks ago   /bin/sh -c #(nop) CMD ["bash"]                  0 B
       <missing>       9 weeks ago   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45.14 MB

       Show the history of the specified image without truncating content and using raw data:

       $ podman history --no-trunc=true --human=false debian
       ID              CREATED                CREATED BY                                      SIZE       COMMENT
       b676ca55e4f2c   2017-07-24T16:52:55Z   /bin/sh -c #(nop) CMD ["bash"]                  0
       <missing>       2017-07-24T16:52:54Z   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45142935

       Show the formatted history of the specified image:

       $ podman history --format "{{.ID}} {{.Created}}" debian
       b676ca55e4f2c   9 weeks ago
       <missing>       9 weeks ago

       Show the history in JSON format for the specified image:

       $ podman history --format json debian
       [
           {
            "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
            "created": "2017-07-24T16:52:55.195062314Z",
            "createdBy": "/bin/sh -c #(nop)  CMD [\"bash\"]",
            "size": 0,
            "comment": ""
           },
           {
            "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
            "created": "2017-07-24T16:52:54.898893387Z",
            "createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
            "size": 45142935,
            "comment": ""
           }
       ]

History

       July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.commailto:umohnani@redhat.compodman-history(1)

Name

       podman-history - Show the history of an image

Options

--format=format
       Alter the output for a format like 'json' or a Go template.

       Valid placeholders for the Go template are listed below:

       ┌───────────────┬───────────────────────────────────────┐
       │ PlaceholderDescription                           │
       ├───────────────┼───────────────────────────────────────┤
       │ .CommentCommentforthelayer                 │
       ├───────────────┼───────────────────────────────────────┤
       │ .Created      │ if  --human,   time   elapsed   since │
       │               │ creation,  otherwise  time  stamp  of │
       │               │ creation                              │
       ├───────────────┼───────────────────────────────────────┤
       │ .CreatedAt    │ Time when the image layer was created │
       ├───────────────┼───────────────────────────────────────┤
       │ .CreatedBy    │ Command used to create the layer      │
       ├───────────────┼───────────────────────────────────────┤
       │ .CreatedSince │ Elapsed time since  the  image  layer │
       │               │ was created                           │
       ├───────────────┼───────────────────────────────────────┤
       │ .IDImageID                              │
       ├───────────────┼───────────────────────────────────────┤
       │ .SizeSizeoflayerondisk                 │
       ├───────────────┼───────────────────────────────────────┤
       │ .TagsImagetags                            │
       └───────────────┴───────────────────────────────────────┘

   --help,-h
       Print usage statement

   --human,-H
       Display sizes and dates in human readable format (default true).

   --no-trunc
       Do not truncate the output (default false).

   --quiet,-q
       Print the numeric IDs only (default false).

See Also

podman(1)

Synopsis

podmanhistory [options] image[:tag|@digest]

       podmanimagehistory [options] image[:tag|@digest]

See Also