2c7b463196
With the remote_inspect function in RH docker, we can inspect and image on a remote repository for various information like versions (when present). This allows us to expand atomic verify to check a local version against a remote version. atomic verify now can take an image as input (as before) and provide a greater level of detail when checking each base image (defined as a non-intermediate image). It now iterates on those base images looking for update status. The output of atomic verify has also been changed slightly to include a verbose option. When invoked, the verify output will list each base image with its versioning information. The non-verbose output remains largely the same, where only base images that have identified updates are put to stdout. If verbose is not called for by the user but we find base images with no version information, we output a warning message and print verbosely anyway. Updated man page
1.7 KiB
% ATOMIC(1) Atomic Man Pages % Dan Walsh % May 2015
NAME
atomic-verify - Verify image is fully updated
SYNOPSIS
atomic verify [-h|--help] [-v|--verbose] IMAGE
DESCRIPTION
atomic verify checks whether there is a newer image available and scans through all layers to see if any of the layers, which are base images themselves, have a new version available. If the tool finds an out of date image, it will report as such.
If the image or any of its layers are pulled from a repository, it will attempt to check the repository to see if there is a new image and capture any of its relevant information like version (where applicable).
Any images that do not possess a Version LABEL cannot be compared for available updates. If an image lacks the version information, it will still be part of the layer descriptions but will be cited as not having the version information.
OPTIONS:
-h --help Print usage statement
-v --verbose Will output the status of each base image that makes up the image being verified.
EXAMPLES
Verify the Red Hat rsyslog image
# atomic verify registry.access.redhat.com/rhel7/rsyslog
#
Verify the Red Hat rsyslog image and show status of each image layer
# atomic verify -v registry.access.redhat.com/rhel7/rsyslog
registry.access.redhat.com/rhel7/rsyslog contains the following images:
rhel7/rsyslog-7.1-29 rhel7/rsyslog-7.1-29
redhat/rhel7-7.1-24 redhat/rhel7-7.1-24
* = version difference
HISTORY
May 2015, Originally compiled by Daniel Walsh (dwalsh at redhat dot com)
Nov 2015, Updated for remote inspect by Brent Baude (bbaude at redhat dot com)