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

View File

@ -1,20 +1,22 @@
## experimental
## Experimental
This is an experimental driver. please use it only for experimental reasons.
for a better kubernetes in container experience, use docker [driver]({{< ref "/docs/drivers/docker/" >}})
## Install Podman
- [Podman](https://podman.io/getting-started/installation.html)
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" >}}).
## 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
minikube start --driver=podman --container-runtime=cri-o
```
To make docker the default driver:
Alternatively, start minikube with the podman driver only:
```shell
minikube start --driver=podman
```
To make podman the default driver:
```shell
minikube config set driver podman

View File

@ -11,21 +11,36 @@ aliases:
This driver is experimental and in active development. Help wanted!
{{% /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
- Install [Podman](https://podman.io/getting-started/installation)
- amd64 system
- Linux or macOS operating systems on amd64 architecture
- 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" %}}
## 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 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