Skip to content

Commit d0aec40

Browse files
committed
wsl2: temporarily remove docs
Temporarily remove the wsl2 docs, as the wsl2 driver does not seem to work. See PR 1826 for a failed attempt to get it work. Signed-off-by: Akihiro Suda <[email protected]>
1 parent bd8c30c commit d0aec40

File tree

3 files changed

+12
-2
lines changed

3 files changed

+12
-2
lines changed

pkg/wsl2/wsl_driver_windows.go

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,11 @@ func (l *LimaWslDriver) Validate() error {
100100

101101
func (l *LimaWslDriver) Start(ctx context.Context) (chan error, error) {
102102
logrus.Infof("Starting WSL VM")
103+
104+
// Keep this warning below, at least until we can get the driver to work on GHA Large Runner (windows-2022-8-cores).
105+
// A failed attempt can be found at https://github.com/lima-vm/lima/pull/1826
106+
logrus.Warnf("wsl2 driver is experimental and seems currently unstable. Help wanted to fix it.")
107+
103108
status, err := store.GetWslStatus(l.Instance.Name)
104109
if err != nil {
105110
return nil, err

website/content/en/docs/Config/Mount/_index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -138,6 +138,8 @@ mounts:
138138
- For Linux, the "virtiofs" mount type requires the [Rust version of virtiofsd](https://gitlab.com/virtio-fs/virtiofsd).
139139
Using the version from QEMU (usually packaged as `qemu-virtiofsd`) will *not* work, as it requires root access to run.
140140

141+
<!-- WSL2 driver seems currently unstable -->
142+
<!--
141143
### wsl2
142144
> **Warning**
143145
> "wsl2" mode is experimental
@@ -165,3 +167,4 @@ mountType: "wsl2"
165167
#### Caveats
166168
- WSL2 file permissions may not work exactly as expected when accessing files that are natively on the Windows disk ([more info](https://github.com/MicrosoftDocs/WSL/blob/mattw-wsl2-explainer/WSL/file-permissions.md))
167169
- WSL2's disk sharing system uses a 9P protocol server, making the performance similar to [Lima's 9p](#9p) mode ([more info](https://github.com/MicrosoftDocs/WSL/blob/mattw-wsl2-explainer/WSL/wsl2-architecture.md#wsl-2-architectural-flow))
170+
-->

website/content/en/docs/Config/VMType/_index.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,7 @@ The vmType of existing instances cannot be changed.
1313
See the following flowchart to choose the best vmType for you:
1414
```mermaid
1515
flowchart
16-
host{"Host OS"} -- "Windows" --> wsl2["WSL2"]
17-
host -- "Linux" --> qemu["QEMU"]
16+
host{"Host OS"} -- "Linux" --> qemu["QEMU"]
1817
host -- "macOS" --> intel_on_arm{"Need to run <br> Intel binaries <br> on ARM?"}
1918
intel_on_arm -- "Yes" --> just_elf{"Just need to <br> run Intel userspace (fast), <br> or entire Intel VM (slow)?"}
2019
just_elf -- "Userspace (fast)" --> vz
@@ -69,6 +68,8 @@ mountType: "virtiofs"
6968
https://github.com/lima-vm/lima/issues/1577#issuecomment-1565625668
7069
The issue is fixed in macOS 13.5.
7170

71+
<!-- WSL2 driver seems currently unstable -->
72+
<!--
7273
## WSL2
7374
> **Warning**
7475
> "wsl2" mode is experimental
@@ -110,3 +111,4 @@ containerd:
110111
- When running lima using "wsl2", `${LIMA_HOME}/<INSTANCE>/serial.log` will not contain kernel boot logs
111112
- WSL2 requires a `tar` formatted rootfs archive instead of a VM image
112113
- Windows doesn't ship with ssh.exe, gzip.exe, etc. which are used by Lima at various points. The easiest way around this is to run `winget install -e --id Git.MinGit` (winget is now built in to Windows as well), and add the resulting `C:\Program Files\Git\usr\bin\` directory to your path.
114+
-->

0 commit comments

Comments
 (0)