List locally available container images

list_images() returns a data frame of container images currently stored in the local image store, as reported by podman image ls or docker image ls. This is useful for finding the image ID to pass to push_image() after building an image with build_image().

Usage

list_images(tool = NULL, verbose = FALSE)

Arguments

tool

A character string or NULL. The container tool to use. One of "podman" or "docker". If NULL (the default), the function auto-detects which tool is available, preferring podman.

verbose

Logical. If TRUE, prints a progress message before querying the local image store. Defaults to FALSE.

Value

A data frame with five columns: repository, tag, image_id, created, and size. Rows where both repository and tag are <none> correspond to untagged images produced by build_image() when no tag argument was supplied. The data frame is also printed to the console. Returns an empty data frame if no images are found.

Finding your image ID

After calling build_image(), run list_images() to find the image ID of the image you just built. Untagged images appear with <none> in the repository and tag columns – the image_id column contains the hash you need to pass to push_image():

imgs <- list_images()
push_image(
  image_id = imgs$image_id[1],
  netid    = "erwin.lares",
  project  = "container-registry"
)

Examples

if (FALSE) { # \dontrun{
# List all local images
list_images()

# Capture the result for programmatic use
imgs <- list_images()
imgs$image_id[1]
} # }