Skip to content

A script tool tailored for Windows environments that facilitates offline installation of WSL2, Docker, and Kubernetes, simplifying the setup and deployment process.

License

Notifications You must be signed in to change notification settings

howiehu/offline-wsl2-docker-k8s-installer

Repository files navigation

离线WSL2、Docker、K8s安装工具(Offline WSL2/Docker/K8s Installer)

注意:本安装工具仅会安装Docker所依赖的WSL2必要组件,不会安装Linux发行版(例如Ubuntu),如有需要请自行研究安装。

本工具在以下环境下测试通过:

  • PowerShell:7.3.9
  • Windows 版本: 10.0.22631.2715
  • WSL2 版本: 2.0.9.0
  • WSL2 Linux内核版本: 5.15.133.1-1
  • Docker Desktop:4.25.2

吃 💩 记录

作者正被Windows下如 💩 一般的自动化运维能力,以及各大企业如 💩 一般的开发者体验所折磨,没有心思认真写README,也还没心思实现K8s部分的安装。

  • 不论是exe还是msi还是appx以及wsl的命令行本身,都没有足够友好的状态码供判断,必须使用各种取巧方法,而且不给你就不给,输出你还多语言是个什么鬼~
  • 截止本安装工具测试时间为止,Microsoft Store版本的PowerShell版本的PowerShell存在无法正常关联*.ps1脚本文件的问题
  • 不要相信官方Docker Desktop的安装说明中有关System requirements的鬼话,实际安装中必须使用与之配套的最新版本的WSL2。
  • 接上一条,然而微软官方说明并没有告诉你如何离线用命令行安装最新版本且只在Microsoft Store中发布的WSL2
  • 接上一条,如果看旧有文档,其方法已经过时,其中对于Windows的WSL功能的开启只针对WSL1,对于WSL2 Linux内核更新包的安装也仅适用于曾经WSL1时代的老版本的Windows。
  • 接上一条,通过提取链接获得到了最新(截止写文字时)的WSL2的MSIXBundle文件后,你会发现他会同时安装了一个APPX和一个MSI程序,卸载时需要两个都卸载。

必要条件(Requirements)

  • 确保所使用的计算机已经在BIOS中开启了CPU的虚拟化支持
  • Windows 11 21H2 (build 22000) 或更高版本
  • Windows 10 22H2 (build 19045) 或更高版本(理论上支持,但未在此环境做过测试)
  • PowerShell(pwsh) 7.3.9 或更高版本(非Windows PowerShell,本安装工具已附带,或自行前往Github下载最新的64位MSI安装包
  • Docker Desktop 4.25.2 或更高版本(由于安装包体积太大,需自行前往官方网站下载4.25.2版本的安装程序并放置在本安装工具的dependencies文件夹下,并确保命名为Docker Desktop Installer.exe

使用方法(Usage)

  1. 手动安装本安装工具所附带的(或自行下载的)PowerShell。(需要注意,请不要安装并使用Microsoft Store版本的PowerShell,问题请见前述“吃 💩 记录”
  2. 选择使用C:\Program Files\PowerShell\7\pwsh.exe(默认路径)作为*.ps1脚本文件的默认运行程序。
  3. 使用PowerShell,通过手动点击或在命令行中按下方所述顺序运行相应的*.ps1脚本文件。

脚本运行顺序

安装(Install)

  1. 0_enable_vmplatform_feature.ps1 - 开启Windows自带的虚拟机平台功能。
  2. 1_install_wsl2.ps1 - 安装WSL2。
  3. 2_install_docker_desktop.ps1 - 安装并配置Docker Desktop。

卸载(Uninstall)

  1. r0_uninstall_docker_desktop.ps1 - 卸载Docker Desktop。
  2. r1_uninstall_2.ps1 - 卸载WSL2。
  3. r2_disable_vmplatform_feature.ps1 - 关闭Windows自带的虚拟机平台功能。

About

A script tool tailored for Windows environments that facilitates offline installation of WSL2, Docker, and Kubernetes, simplifying the setup and deployment process.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published