buildah-containers

buildah-containers(1) General Commands Manual buildah-containers(1)

NAME

   buildah-containers - List the working containers and their base images.

SYNOPSIS

   buildah containers [options]

DESCRIPTION

   Lists containers which appear to be Buildah working containers, their names and IDs, and the names and IDs of the images from which they were initialized.

OPTIONS

   --all, -a

   List  information  about  all containers, including those which were not created by and are not being used by Buildah.  Containers created by Buildah are de‐
   noted with an '*' in the 'BUILDER' column.

   --filter, -f

   Filter output based on conditions provided.

   Valid filters are listed below:

   ┌─────────┬─────────────────────────────────────────────────────────┐
   │Filter   │ Description                                             │
   ├─────────┼─────────────────────────────────────────────────────────┤
   │id       │ [ID] Container's ID                                     │
   ├─────────┼─────────────────────────────────────────────────────────┤
   │name     │ [Name] Container's name                                 │
   ├─────────┼─────────────────────────────────────────────────────────┤
   │ancestor │ [ImageName] Image or descendant  used  to  create  con‐ │
   │         │ tainer                                                  │
   └─────────┴─────────────────────────────────────────────────────────┘

   --format

   Pretty-print containers using a Go template.

   Valid placeholders for the Go template are listed below:

   ┌───────────────┬──────────────────────────────────────────┐
   │Placeholder    │ Description                              │
   ├───────────────┼──────────────────────────────────────────┤
   │.ContainerID   │ Container ID                             │
   ├───────────────┼──────────────────────────────────────────┤
   │.Builder       │ Whether container was created by buildah │
   ├───────────────┼──────────────────────────────────────────┤
   │.ImageID       │ Image ID                                 │
   ├───────────────┼──────────────────────────────────────────┤
   │.ImageName     │ Image name                               │
   ├───────────────┼──────────────────────────────────────────┤
   │.ContainerName │ Container name                           │
   └───────────────┴──────────────────────────────────────────┘

   --json

   Output in JSON format.

   --noheading, -n

   Omit the table headings from the listing of containers.

   --notruncate

   Do not truncate IDs and image names in the output.

   --quiet, -q

   Displays only the container IDs.

EXAMPLE

   buildah containers

          CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
          ccf84de04b80     *     53ce4390f2ad registry.access.redhat.com/ub... ubi8-working-container
          45be1d806fc5     *     16ea53ea7c65 docker.io/library/busybox:latest busybox-working-container

   buildah containers --quiet

          ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
          45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

   buildah containers -q --noheading --notruncate

          ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
          45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

   buildah containers --json

          [
              {
                  "id": "ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8",
                  "builder": true,
                  "imageid": "53ce4390f2adb1681eb1a90ec8b48c49c015e0a8d336c197637e7f65e365fa9e",
                  "imagename": "registry.access.redhat.com/ubi8:latest",
                  "containername": "ubi8-working-container"
              },
              {
                  "id": "45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07",
                  "builder": true,
                  "imageid": "16ea53ea7c652456803632d67517b78a4f9075a10bfdc4fc6b7b4cbf2bc98497",
                  "imagename": "docker.io/library/busybox:latest",
                  "containername": "busybox-working-container"
              }
          ]

   buildah containers --format "{{.ContainerID}} {{.ContainerName}}"

          ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8   ubi8-working-container
          45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07   busybox-working-container

   buildah containers --format "Container ID: {{.ContainerID}}"

          Container   ID:   ccf84de04b80c309ce6586997c79a769033dc4129db903c1882bc24a058438b8
          Container   ID:   45be1d806fc533fcfc2beee77e424d87e5990d3ce9214d6b374677d6630bba07

   buildah containers --filter ancestor=ubuntu

          CONTAINER ID  BUILDER  IMAGE ID     IMAGE NAME                       CONTAINER NAME
          fbfd3505376e     *     0ff04b2e7b63 docker.io/library/ubuntu:latest  ubuntu-working-container