Windows 10 安装 Docker Desktop for Windows 以 WSL 2 方式运行容器

前言

从内测算起，Windows 10 2020的第一个正式版（v2004）已经打磨了一年之久，不出意外，它会在5月28日开启全面推送。看到这个消息，对于软件“洁癖”的我，火烧眉毛的想要进行更新，天天都关注一下 itellyou。5月12日，已经有了最新的更新，为MSDN版2020第一个正式版，版本号为v2004（20H1），镜像为官方发布的最新版镜像。官方发布的最新集成补丁至202005，系统版本号Build 19041.264。立刻就下来进行了安装。

以前，一直在使用 Docker Desktop for Windows 运行 Docker 进行微服架构的开发。2004出来以前，就发现Docker Desktop for Windows有所变化，其一就是安装包的大小，从原来的900多M，变为如今的不到400M；其二新版本的Docker Desktop for Windows一直在建议使用WSL 2进行容器的运行。借着重装系统的机会，折腾了一下，初次研究着须要费一些精神。把整个过程整理下来。

软件版本

• Windows 10 2004 (20H1) 下载地址
• Docker Desktop for Windows 2.3.0.2 下载地址

注意事项

Windows 10 的 WSL 2 须要依赖于， Microsoft Store中的应用。适用于 Linux 的 Windows 子系统只能在系统驱动器（一般是 C: 驱动器）中运行，因此注意C盘的空间。

1、在 Windows 10 上安装 Hyper-V

Docker Desktop 想要在Windows上运行，须要依赖于Windows的Hyper-V模块。因此首先就要启用Hyper-V。

启用 Hyper-V 以在 Windows 10 上建立虚拟机。能够经过多种方式启用 Hyper-V，包括使用 Windows 10 控制面板、PowerShell 或使用部署映像服务和管理工具 (DISM)。

(1) 检查要求

• Windows 10 企业版、专业版或教育版
• 具备二级地址转换 (SLAT) 的 64 位处理器。
• CPU 支持 VM 监视器模式扩展（Intel CPU 上的 VT-c）。
• 最少 4 GB 内存。

请勿在 Windows 10 家庭版上安装 Hyper-V。

(2) 方式1、使用 PowerShell 启用 Hyper-V

1. 以管理员身份打开 PowerShell 控制台。
2. 运行如下命令：

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

若是没法找到此命令，请确保你以管理员身份运行 PowerShell。

安装完成后，请重启操做系统。

(3) 方式2、使用 CMD 和 DISM 启用 Hyper-V

部署映像服务和管理工具 (DISM) 可帮助配置 Windows 和 Windows 映像。在众多应用程序中，DISM 能够在操做系统运行时启用 Windows 功能。

使用 DISM 启用 Hyper-V 角色：

1. 以管理员身份打开 PowerShell 或 CMD 会话。
2. 键入下列命令：

DISM /Online /Enable-Feature /All /FeatureName:Microsoft-Hyper-V

(4) 方式3、经过“设置”启用 Hyper-V

• 右键单击 Windows 按钮并选择“应用和功能”。（左下角Windows图标）
• 选择相关设置下右侧的“程序和功能”。
• 选择“打开或关闭 Windows 功能”。
• 选择“Hyper-V”，而后单击“肯定”。

安装完成后，系统会提示你重启计算机。

2、适用于 Linux 的 Windows 子系统安装

(1) 安装适用于 Linux 的 Windows 子系统

必须先启用“适用于 Linux 的 Windows 子系统”可选功能，而后才能在 Windows 上安装 Linux 分发版。

以管理员身份打开 PowerShell 并运行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

若要仅安装 WSL 1，如今应重启计算机并继续安装所选的 Linux 分发版，不然请等待重启并继续更新到 WSL 2

(2) 更新到 WSL 2

2.1 若要更新到 WSL 2，必须知足如下条件：

• 运行 Windows 10（已更新到版本 2004 的内部版本 19041 或更高版本）。
• 经过按 Windows 徽标键 + R， 检查你的 Windows 版本，而后键入 winver，选择“肯定” 。 （或者在 Windows 命令提示符下输入 ver 命令）。 若是内部版本低于 19041，请更新到最新的 Windows 版本。

2.2 启用“虚拟机平台”可选组件

安装 WSL 2 以前，必须启用“虚拟机平台”可选功能。

以管理员身份打开 PowerShell 并运行：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

从新启动计算机，以完成 WSL 安装并更新到 WSL 2。

2.3 将 WSL 2 设置为默认版本

安装新的 Linux 分发版时，请在 Powershell 中运行如下命令，以将 WSL 2 设置为默认版本：

wsl --set-default-version 2

(3) 安装所选的 Linux 分发版

1. 打开 Microsoft Store，并选择你偏好的 Linux 分发版 (若是上述链接打开有错，请直接打开Microsoft Store搜索)。

单击如下连接会打开每一个分发版的 Microsoft Store 页面，(若是下述链接打开有错，请直接打开Microsoft Store搜索)。：

• Ubuntu 16.04 LTS
• Ubuntu 18.04 LTS
• openSUSE Leap 15.1
• SUSE Linux Enterprise Server 12 SP5
• SUSE Linux Enterprise Server 15 SP1
• Kali Linux
• Debian GNU/Linux
• Fedora Remix for WSL
• Pengwin
• Pengwin Enterprise
• Alpine WSL

1. 在分发版的页面中，选择“获取”。

(4) 设置新分发版

首次启动新安装的 Linux分发版时，将打开一个控制台窗口。（就是以前安装的应用）

系统会要求你等待一分钟或两分钟，以便文件解压缩并存储到电脑上。将来的全部启动时间应不到一秒。

而后，须要为新的 Linux 分发版建立用户账户和密码。

(5) 将分发版版本设置为 WSL 1 或 WSL 2

能够打开 PowerShell 命令行并输入如下命令（仅在 Windows 内部版本 19041 或更高版本中可用），来检查分配给每一个已安装的 Linux 分发版的 WSL 版本：

wsl -l -v

或

wsl --list --verbose

经过以上命令，就能够查看刚刚已经安装的Linux发行版本，以及当前的WSL版本

若要将分发版设置为受某一 WSL 版本支持，请运行：

wsl --set-version <distribution name> <versionNumber>

请确保将 <distribution name> 替换为你的分发版的实际名称，并将 <versionNumber> 替换为数字“1”或“2”。 能够随时更改回 WSL 1，方法是运行与上面相同的命令，但将“2”替换为“1”。

此外，若是要使 WSL 2 成为你的默认体系结构，能够经过此命令执行该操做：

wsl --set-default-version 2

这会将安装的任何新分发版的版本设置为 WSL 2。

Docker Desktop 须要的就是 WSL 2

3、安装Docker Desktop for Windows

1. 双击运行 Docker Desktop Installer.exe 安装。（为了不不可预知的问题，最好用右键“以管理员身份运行”）。跟随安装界面，一路下一步便可。全部的选项都采用默认。安装成功后，点击“Close”关闭窗口。
2. 安装成功后，运行 Docker Desktop
3. 打开 Docker Desktop Settings，选择General

1. 勾选Use WSL 2 based engine。

若是在已经支持WSL的操做系统上，安装Docker Desktop，那么这个选项是被默认选中的。

若是不选中Use WSL 2 based engine，Resources下面就会回到以前版本的模样。本身制定CPU、内存等信息。可是该版本指定这些信息会出错。

1. 点击 Apply & Restart。
2. 请确保Linux发行版本是运行在WSL 2 模式下。WSL 在V1 和 V2 两种模式下均可以运行。

检查 WSL 模式，运行下面的命令：

wsl -l -v

若是现有的WSL 是v1，经过下面的命令能够升级为 v2:

wsl --set-version (distro name) 2

想要把 v2 设置为默认模式，能够经过下面的命令：

wsl --set-default-version 2

1. 当 Docker Desktop 重启以后, 进入 Settings > Resources > WSL Integration。

在这个界面中，选择任何你想要使用的Linux发行版本。

1. 点击 Apply & Restart。

4、查看效果

以上内容完成以后，主要工做就已经完成了。能够安装运行几个容器查看效果。

若是以为默认的仓库慢，能够在Settings>Docker Engine中的“registry-mirrors”配置你本身的加速器。

验证方法：

1. 首先在Windows PowerSell中，输入：

wsl -l -v

就能够查看到，多了docker desktop的信息。

1. 在Windows CMD中，经过命令随便运行几个容器（我是经过docker-compose, 运行本身的镜像）。在Linux中，就能够查看到已经运行的容器信息。

参考资料：

1: https://docs.microsoft.com/zh-cn/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v
2: https://docs.microsoft.com/zh-cn/windows/wsl/install-win10
3: https://docs.docker.com/docker-for-windows/wsl/