NAME

       podman-kube-apply - Apply Kubernetes YAML based on containers, pods, or volumes to a Kubernetes cluster

SYNOPSIS

       podman kube apply [options] [container... | pod... | volume...]

DESCRIPTION

       podman  kube  apply  deploys  a  podman container, pod, or volume to a Kubernetes cluster. Use the --file
       option to deploy a Kubernetes YAML (v1 specification) to a Kubernetes cluster as well.

       Note that the Kubernetes YAML file can be used to run the deployment in Podman via podman-play-kube(1).

OPTIONS

   --ca-cert-file=ca cert file path | insecure
       The path to the CA cert file for the Kubernetes cluster. Usually the kubeconfig has the CA cert file data
       and  generate  kube  automatically picks that up if it is available in the kubeconfig. If no CA cert file
       data is available, set this to insecure to bypass the certificate verification.

   --file, -f=kube yaml filepath
       Path to the kubernetes yaml file to deploy onto the kubernetes cluster. This file can be generated  using
       the  podman  kube generate command. The input may be in the form of a yaml file, or stdin. For stdin, use
       --file=-.

   --kubeconfig, -k=kubeconfig filepath
       Path to the kubeconfig file to be used when deploying the generated kube yaml to the Kubernetes  cluster.
       The environment variable KUBECONFIG can be used to set the path for the kubeconfig file as well.  Note: A
       kubeconfig can have multiple cluster configurations, but kube generate always  picks  the  first  cluster
       configuration in the given kubeconfig.

   --ns=namespace
       The namespace or project to deploy the workloads of the generated kube yaml to in the Kubernetes cluster.

   --service, -s
       Used  to  create  a  service  for  the  corresponding  container or pod being deployed to the cluster. In
       particular, if the container or pod has portmap bindings, the service specification includes  a  NodePort
       declaration  to expose the service. A random port is assigned by Podman in the service specification that
       is deployed to the cluster.

EXAMPLES

       Apply a podman volume and container to the "default" namespace in a Kubernetes cluster.

       $ podman kube apply --kubeconfig /tmp/kubeconfig myvol vol-test-1
       Deploying to cluster...
       Successfully deployed workloads to cluster!
       $ kubectl get pods
       NAME             READY   STATUS    RESTARTS   AGE
       vol-test-1-pod   1/1     Running   0          9m

       Apply a Kubernetes YAML file to the "default" namespace in a Kubernetes cluster.

       $ podman kube apply --kubeconfig /tmp/kubeconfig -f vol.yaml
       Deploying to cluster...
       Successfully deployed workloads to cluster!
       $ kubectl get pods
       NAME             READY   STATUS    RESTARTS   AGE
       vol-test-2-pod   1/1     Running   0          9m

       Apply a Kubernetes YAML file to the "test1" namespace in a Kubernetes cluster.

       $ podman kube apply --kubeconfig /tmp/kubeconfig --ns test1 vol-test-3
       Deploying to cluster...
       Successfully deployed workloads to cluster!
       $ kubectl get pods --namespace test1
       NAME             READY   STATUS    RESTARTS   AGE
       vol-test-3-pod   1/1     Running   0          9m

SEE ALSO

       podman(1), podman-container(1), podman-pod(1), podman-kube-play(1), podman-kube-generate(1)

HISTORY

       September 2022, Originally compiled by Urvashi Mohnani (umohnani at redhat dot com)

                                                                                            podman-kube-apply(1)