Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 initial-
     ized.

OPTIONS
     --all, -a

     List information about all containers, including those which were not  cre-
     ated  by  and are not being used by Buildah.  Containers created by Buildah
     are denoted 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  de- |
     |		| scendant   used  to  create |
     |		| container		      |
     +----------+-----------------------------+

     --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  cre- |
     |		      | ated 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

SEE ALSO
     buildah(1)

buildah 			   March 2017		   buildah-containers(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=buildah-containers&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help