Skip to content

Commit

Permalink
add docs for setting up WSL 2 & Docker
Browse files Browse the repository at this point in the history
  • Loading branch information
spowelljr committed Jan 13, 2022
1 parent 3edd561 commit 099c61f
Show file tree
Hide file tree
Showing 3 changed files with 57 additions and 40 deletions.
41 changes: 40 additions & 1 deletion site/content/en/docs/drivers/docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,46 @@ aliases:

The Docker driver allows you to install Kubernetes into an existing Docker install. On Linux, this does not require virtualization to be enabled.

{{% readfile file="/docs/drivers/includes/docker_usage.inc" %}}
## Requirements

- [Install Docker](https://hub.docker.com/search?q=&type=edition&offering=community&sort=updated_at&order=desc) 18.09 or higher
- amd64 or arm64 system.
- If using WSL complete [these steps]({{<ref "/docs/tutorials/wsl_docker_driver">}}) first

## Usage

Start a cluster using the docker driver:

```shell
minikube start --driver=docker
```
To make docker the default driver:

```shell
minikube config set driver docker
```

## Rootless Docker
### Requirements
- Docker 20.10 or higher, see https://rootlesscontaine.rs/getting-started/docker/
- Cgroup v2 delegation, see https://rootlesscontaine.rs/getting-started/common/cgroup2/

### Usage

Start a cluster using the rootless docker driver:

```shell
dockerd-rootless-setuptool.sh install -f
docker context use rootless

minikube start --driver=docker --container-runtime=containerd
```

The `--container-runtime` flag must be set to "containerd" or "cri-o".

The restrictions of rootless `kind` apply to minikube with rootless docker as well.

See https://kind.sigs.k8s.io/docs/user/rootless/ .

## Special features

Expand Down
39 changes: 0 additions & 39 deletions site/content/en/docs/drivers/includes/docker_usage.inc

This file was deleted.

17 changes: 17 additions & 0 deletions site/content/en/docs/tutorials/wsl_docker_driver.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: "Setting Up WSL 2 & Docker Desktop"
linkTitle: "Setting Up WSL 2 & Docker Desktop"
weight: 1
date: 2022-01-12
---

## Overview

- This guide will show you how to setup WSL 2 and Docker Desktop.


## Steps
Microsoft and Docker have in-depth guides for both, just follow along for a successful setup!

1. [Install WSL](https://docs.microsoft.com/en-us/windows/wsl/install)
2. Install and setup [Docker Desktop for Windows](https://docs.docker.com/desktop/windows/wsl/#download)

0 comments on commit 099c61f

Please sign in to comment.