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
       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 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+14.3.quarterly>

home | help