安装 WSL2、Ubuntu 及 docker（详细步骤）

史国生 發表於 2020-8-7 16:29:00

安装 WSL2、Ubuntu 及 docker（详细步骤）

本文链接：https://www.cnblogs.com/tujia/p/13438639.html
 
一、更新Windows版本
WSL 2 随着 Windows build 19041 而推出，能更好的兼容 docker，如果你的电脑版本低于 19041，请先升级更新 Windows
注：如果你已经有WSL 2了，可以直接跳过步骤一、二、三。
 
查看版本及升级方法：
1）查看 Windows 版本的方法：Windows+r，运行 winver
<img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200807101948205-1619581083.png">
 2）升级方法
访问：https://www.microsoft.com/zh-cn/software-download/windows10，点击“立即更新”，下载 Windows10Upgrade.exe，双击运行即可
<img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200807104529207-127166491.png">
更新完之后，可以根据个人情况决定要不要删掉 C:\Windows.old 文件夹及卸载 windows 10 易升 程序
 
二、启用 VirtualMachinePlatform 组件
windows+x+a 打开 PowerShell ，输入以下命令启用 VirtualMachinePlatform（虚拟机平台）组件
<div class="cnblogs_code">
<pre>Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform</pre>
</div>
保守起见，你也可以同时启用 Hyper-V 组件，官方的文档里没说要启用它
<div class="cnblogs_code">
<pre>Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All</pre>
</div>
注：启用组件之后，需要重启电脑才会生效
 
三、启动 wsl 2
注：如果你还没有安装过wsl linux 子系统，则先要开启wsl功能， 在 PowerShell 中执行下面命令，然后重启电脑即可
<div class="cnblogs_code">
<pre>Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux</pre>
</div>
 
可以先用 wsl -l -v 来查看当前的wsl版本。如果显示的是版本是1，则执行 wsl --set-default-version 2 来设置默认版本；
如果提示“错误: 0x1bc”或其他异常，可以试试更新 wsl linux内核版本
传送门：https://docs.microsoft.com/zh-cn/windows/wsl/wsl2-kernel，下载 wsl_update_x64.msi 程序并安装
<img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200807093136594-1069092822.png">
 
更新已有分发版本设置为 WSL 2 
<div class="cnblogs_code">
<pre># 查看已有linux分发版本
wsl --list --verbose
# 设置分发版本为 wsl 2
wsl --set-version <distribution name> <versionNumber></pre>
</div>
<img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200807140749361-2007143526.png">
 
注：如果 --set-version 2之后，wsl -l -v 还是显示1的话，只能卸载重装 ubuntu了 
 
参考链接： 
https://docs.microsoft.com/zh-cn/windows/wsl/install-win10
https://docs.microsoft.com/zh-cn/windows/wsl/wsl2-kernel
 
四、启动 ubuntu
win+q 搜索 ubuntu，选择以管理员身份运行
<img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200807153048660-577284694.png">
注：如果启动 ubuntu 时报错误：“WslRegisterDistribution failed with error: 0x80370102”，那就是还没启动BIOS 虚拟化功能，修改BIOS配置的方法请自动百度（一般是开机按F2）  
 <img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200807152708102-111380791.png">
 
排查wsl 2安装相关问题：https://docs.microsoft.com/zh-cn/windows/wsl/install-win10#troubleshooting-installation
 
镜像加速：https://www.runoob.com/docker/docker-mirror-acceleration.html
 
<hr>
 
五、安装 docker
网上的安装教程很多很乱
最好用官网的安装教程！！
最好用官网的安装教程！！
最好用官网的安装教程！！
传送门：https://docs.docker.com/engine/install/ubuntu/#installation-methods
<div class="cnblogs_code">
<pre>sudo apt-get update</pre>
</div>
<div class="cnblogs_code">
<pre>sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common</pre>
</div>
<div class="cnblogs_code">
<pre>curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</pre>
</div>
<div class="cnblogs_code">
<pre>sudo add-apt-repository "deb https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"</pre>
</div>
<div class="cnblogs_code">
<pre>sudo apt-get update</pre>
</div>
最后一步重点：不能直接安装最新版本的 docker！！！！（否则可能会有一堆bug等着你）
先运行如下命令，看一下有哪些包适合自己的系统的
<div class="cnblogs_code">
<pre>apt-cache madison docker-ce</pre>
</div>
<div class="cnblogs_code">
<pre>apt-cache madison docker-ce-cli</pre>
</div>
然后，选一个较低的版本安装即可，例如：
<div class="cnblogs_code">
<pre>sudo apt-get install docker-ce=5:19.03.9~3-0~ubuntu-focal docker-ce-cli=5:19.03.9~3-0~ubuntu-focal containerd.io</pre>
</div>
 
安装过程常见错误：
1）如果报错误：sleep: cannot read realtime clock: Invalid argument，则
<div class="cnblogs_code">
<pre>sudo mv /bin/sleep /bin/sleep~
touch /bin/sleep
chmod +x /bin/sleep</pre>
</div>
2）如果报错误：gpg: can't connect to the agent: IPC connect call failed，则
<div class="cnblogs_code">
<pre>sudo apt remove gpg
sudo apt-get update -y
sudo apt-get install -y gnupg1</pre>
</div>
如果还是不行，则
<div class="cnblogs_code">
<pre>wget https://launchpad.net/~rafaeldtinoco/+archive/ubuntu/lp1871129/+files/libc6_2.31-0ubuntu8+lp1871129~1_amd64.deb
sudo dpkg --install libc6_2.31-0ubuntu8+lp1871129~1_amd64.deb
sudo apt-mark hold libc6 #to avoid further update</pre>
</div>
3）如果报错误：sudo: add-apt-repository: command not found，则
<div class="cnblogs_code">
<pre>sudo apt install software-properties-common</pre>
</div>
 
六、docker 用户组
安装完之后，一般会提示
<div class="cnblogs_code">
<pre>If you would like to use Docker as a non-root user, you should now consider
adding your user to the "docker" group with something like:

sudo usermod -aG docker tiac

Remember that you will have to log out and back in for this to take effect!</pre>
</div>
注：意思是说，你好像不是用root来安装的docker的，需要添加当前用户到docker用户组；tiac是我的用户名，换成自己的用户名就好
<div class="cnblogs_code">
<pre>sudo usermod -aG docker your_name</pre>
</div>
 
七、启动 docker
启动 docker 服务
<div class="cnblogs_code">
<pre>sudo service docker start</pre>
</div>
启动之后，看一下服务状态
<div class="cnblogs_code">
<pre>sudo service docker status</pre>
</div>
如果提示“Docker is not running”，则关掉 ubuntu，以管理员身份重启 ubuntu
<img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200806154044181-1191506681.png">
 启动后，重新执行一下
<div class="cnblogs_code">
<pre>sudo service docker start
sudo service docker status</pre>
</div>
如果显示“Docker is running”，则基本没什么问题了，如果还有错，请参考下面步骤八
 
八、docker 测试
<div class="cnblogs_code">
<pre>sudo docker run hello-world</pre>
</div>
如果提示“docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?.”，则
<div class="cnblogs_code">
<pre>sudo usermod -aG docker $USER
sudo usermod -g docker $USER
sudo service docker restart</pre>
</div>
如果pull超时，则更换 docker hub镜像地址
<div class="cnblogs_code">
<pre>curl -sSL https://get.daocloud.io/daotools/set_mirror.sh | sh -s http://f1361db2.m.daocloud.io</pre>
</div>
详情：https://www.daocloud.io/mirror#accelerator-doc
 
排除所有异常，最后效果（为了这个Hello World 不容易啊...）
<img src="https://img2020.cnblogs.com/blog/550797/202008/550797-20200807162746663-339883081.png">
 
 
 
总结：
1）windows 内部版本要升级到19041（或更高版本）；
2）升级wsl1到wsl2（开启 VirtualMachinePlatform），wsl --set-default-version 2；
3）BIOS开户cpu虚拟化功能，Intel Virtualization Technology : Enable；
4）以管理员身份启动 ubuntu；
5）看docker官方的安装教程
6）不要安装最新版本docker
 
本文链接：https://www.cnblogs.com/tujia/p/13438639.html
<hr>
 完。 
来源：https://www.cnblogs.com/tujia/p/13438639.html

頁: [1]

琼殿技术论坛's Archiver

安装 WSL2、Ubuntu 及 docker（详细步骤）