.nh
.TH podman-kube-down 1
.SH NAME
.PP
podman-kube-down - Remove containers and pods based on Kubernetes YAML

.SH SYNOPSIS
.PP
\fBpodman kube down\fP \fIfile.yml|-|https://website.io/file.yml\fP

.SH DESCRIPTION
.PP
\fBpodman kube down\fP reads a specified Kubernetes YAML file, tearing down pods that were created by the \fB\fCpodman kube play\fR command via the same Kubernetes YAML
file. Any volumes that were created by the previous \fB\fCpodman kube play\fR command remain intact. If the YAML file is specified as \fB\fC-\fR, \fB\fCpodman kube down\fR reads the
YAML from stdin. The input can also be a URL that points to a YAML file such as https://podman.io/demo.yml. \fB\fCpodman kube down\fR will then teardown the pods and
containers created by \fB\fCpodman kube play\fR via the same Kubernetes YAML from the URL. However, \fB\fCpodman kube down\fR will 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 \fB\fCpodman kube play\fR\&.

.SH EXAMPLES
.PP
Example YAML file \fB\fCdemo.yml\fR:

.PP
.RS

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

.fi
.RE

.PP
Remove the pod and containers as described in the \fB\fCdemo.yml\fR file

.PP
.RS

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

.fi
.RE

.PP
Remove the pod and containers as described in the \fB\fCdemo.yml\fR file YAML sent to stdin

.PP
.RS

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

.fi
.RE

.PP
Remove the pods and containers as described in the \fB\fCdemo.yml\fR file YAML read from a URL

.PP
.RS

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

.fi
.RE

.PP
\fB\fCpodman kube down\fR will 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.

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-kube(1)\fP, \fBpodman-kube-play(1)\fP, \fBpodman-kube-generate(1)\fP, \fBcontainers-certs.d(5)\fP