kubernetes
/
minikube
mirror of https://github.com/kubernetes/minikube.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Steps to get podman running 

- Remove repetitive notes in podman documentation
- Fix links in the usage document
- Tidy the language and grammar
pull/8608/head
Matt Broberg 2020-06-30 10:35:15 -05:00 committed by Matthew Broberg
parent 4ef26f5700
commit 39eaf835d0
2 changed files with 35 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
site/content/en/docs/drivers/includes/podman_usage.inc
View File

@ -1,20 +1,22 @@
## experimental ## Experimental
This is an experimental driver. please use it only for experimental reasons. This is an experimental driver. Please use it only for experimental reasons until it has reached maturity. For a more reliable minikube experience, use a non-experimental driver, like [Docker]({{< ref "/docs/drivers/docker.md" >}}).
for a better kubernetes in container experience, use docker [driver]({{< ref "/docs/drivers/docker/" >}})
## Install Podman
- [Podman](https://podman.io/getting-started/installation.html)
## Usage ## Usage
Start a cluster using the podman driver: It's recommended to run minikube with the podman driver and [CRI-O container runtime](https://https://cri-o.io/):
```shell
minikube start --driver=podman --container-runtime=cri-o
```
Alternatively, start minikube with the podman driver only:
```shell ```shell
minikube start --driver=podman minikube start --driver=podman
``` ```
To make docker the default driver:
To make podman the default driver:
```shell ```shell
minikube config set driver podman minikube config set driver podman

31
site/content/en/docs/drivers/podman.md
View File

@ -11,21 +11,36 @@ aliases:
This driver is experimental and in active development. Help wanted! This driver is experimental and in active development. Help wanted!
{{% /pageinfo %}} {{% /pageinfo %}}
The podman driver is another kubernetes in container driver for minikube. similar to [docker](https://minikube.sigs.k8s.io/docs/drivers/docker/) driver. The podman driver is experimental, and only supported on Linux and macOS (with a remote podman server). The podman driver is an alternative container runtime to the [Docker]({{< ref "/docs/drivers/docker.md >}}) driver.
## Requirements ## Requirements
- Install [Podman](https://podman.io/getting-started/installation) - Linux or macOS operating systems on amd64 architecture
- amd64 system - Install [podman](https://podman.io/getting-started/installation.html)
## Try it with CRI-O container runtime.
```shell
minikube start --driver=podman --container-runtime=cri-o
```
{{% readfile file="/docs/drivers/includes/podman_usage.inc" %}} {{% readfile file="/docs/drivers/includes/podman_usage.inc" %}}
## Known Issues ## Known Issues
- Podman driver is not supported on non-amd64 architectures such as arm yet. For non-amd64 archs please use [other drivers]({{< ref "/docs/drivers/_index.md" >}}) - Podman driver is not supported on non-amd64 architectures such as arm yet. For non-amd64 archs please use [other drivers]({{< ref "/docs/drivers/_index.md" >}})
- Podman requirements passwordless running of sudo. If you run into an error about sudo, do the following:
```shell
$ sudo visudo
```
Then append the following to the section *at the very bottom* of the file where `username` is your user account.
```shell
username ALL=(ALL) NOPASSWD: /usr/bin/podman
```
Be sure this text is *after* `#includedir /etc/sudoers.d`. To confirm it worked, try:
```shell
sudo -k -n podman version
```
## Troubleshooting
- Run `minikube start --alsologtostderr -v=7` to debug errors and crashes