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

FreeBSD Manual Pages

  
 
  

home | help
podman-kube-down(1)	     General Commands Manual	     podman-kube-down(1)

NAME
     podman-kube-down - Remove containers and pods based on Kubernetes YAML

SYNOPSIS
     podman    kube    down   [options]   file.yml|-|https://website.io/file.yml
     [file2.yml|https://website.io/file2.yml ...]

DESCRIPTION
     podman kube down reads one or more specified Kubernetes YAML files, tearing
     down pods that were created by the podman kube play command  via  the  same
     Kubernetes YAML files. Any volumes that were created by the previous podman
     kube  play command remain intact unless the --force options is used. If the
     YAML file is specified as -, podman kube down reads the  YAML  from  stdin.
     The  inputs  can also be URLs that point to YAML files such as https://pod-
     man.io/demo.yml.  podman kube down tears down the pods and containers  cre-
     ated  by  podman kube play via the same Kubernetes YAML from the URLs. How-
     ever, podman kube down does not work with a URL if the YAML  file	the  URL
     points  to  has  been changed or altered since the creation of the pods and
     containers using podman kube play.

     When multiple YAML files are specified (local files, URLs,  or  a	combina-
     tion), they are processed sequentially and combined with YAML document sep-
     arators (---), just like with podman kube play.

OPTIONS
   --force
     Tear down the volumes linked to the PersistentVolumeClaims as part --down

EXAMPLES
     Example YAML file demo.yml:

     apiVersion: v1
     kind: Pod
     metadata:
     ...
     spec:
       containers:
       - command:
	 - top
	 - name: container
	   value: podman
	 image: foobar
     ...

     Remove the pod and containers as described in the demo.yml file

     $ podman kube down demo.yml
     Pods stopped:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
     Pods removed:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

     Remove  the  pod and containers as described in the demo.yml file YAML sent
     to stdin

     $ cat demo.yml | podman kube play -
     Pods stopped:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
     Pods removed:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

     Remove the pods and containers as described in the demo.yml file YAML  read
     from a URL

     $ podman kube down https://podman.io/demo.yml
     Pods stopped:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
     Pods removed:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

     podman  kube  down does not work with a URL if the YAML file the URL points
     to has been changed or altered since it was used to  create  the  pods  and
     containers.

     Remove the pods and containers that were created from multiple YAML files

     $ podman kube down pod.yml service.yml configmap.yml
     Pods stopped:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
     Pods removed:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

     Remove the pods and containers that were created from multiple URLs

     $ podman kube down https://example.com/pod.yml https://example.com/service.yml https://example.com/configmap.yml
     Pods stopped:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
     Pods removed:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

     Remove  the pods and containers that were created from a combination of lo-
     cal files and URLs

     $ podman kube down local-pod.yml https://example.com/service.yml local-configmap.yml
     Pods stopped:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6
     Pods removed:
     52182811df2b1e73f36476003a66ec872101ea59034ac0d4d3a7b40903b955a6

SEE ALSO
     podman(1),  podman-kube(1),  podman-kube-play(1),	podman-kube-generate(1),
     containers-certs.d(5)

							     podman-kube-down(1)

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

home | help