Skip to content

Add note on WSL2 path formatting for hot reloading in Rancher Desktop on Windows #1769

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Jun 26, 2025
+15 −0
Merged

Add note on WSL2 path formatting for hot reloading in Rancher Desktop on Windows #1769

Changes from 8 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
e08f31c
Added notes for hotreloading lambda functions with rancher desktop wi…
Darasimi-Ajewole May 13, 2025
dbe7f5c
remove emoji
quetzalliwrites Jun 5, 2025
941d5e3
fix linting error
quetzalliwrites Jun 5, 2025
6371fe3
code lines need a blank space before
quetzalliwrites Jun 5, 2025
186d896
Update index.md
Darasimi-Ajewole Jun 10, 2025
df4344d
Updating formatting
Darasimi-Ajewole Jun 10, 2025
cb5b540
Move to a more appropriate location
Darasimi-Ajewole Jun 11, 2025
c4ecea8
Apply suggestions from code review
quetzalliwrites Jun 25, 2025
343db56
fixed linting error
quetzalliwrites Jun 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions content/en/user-guide/lambda-tools/hot-reloading/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,17 @@
If using Docker Desktop on macOS, you might need to allow [file sharing](https://docs.docker.com/desktop/settings/mac/#file-sharing) for your target folders.
MacOS may prompt you to grant Docker access to your target folders.

**WSL2-compatible paths required with Rancher Desktop on Windows:**
Make sure your Lambda handler paths are specified using WSL2-compatible paths. For example, instead of using a Windows-style path such as:

Check failure on line 44 in content/en/user-guide/lambda-tools/hot-reloading/index.md

View workflow job for this annotation

GitHub Actions / Markdown Lint

Max 1 sentence should be on a line 

content/en/user-guide/lambda-tools/hot-reloading/index.md:44:77 max-one-sentence-per-line Max 1 sentence should be on a line [Context: "e paths. For e"] https://github.com/aepfli/markdownlint-rule-max-one-sentence-per-line
```bash

Check failure on line 45 in content/en/user-guide/lambda-tools/hot-reloading/index.md

View workflow job for this annotation

GitHub Actions / Markdown Lint

Fenced code blocks should be surrounded by blank lines 

content/en/user-guide/lambda-tools/hot-reloading/index.md:45 MD031/blanks-around-fences Fenced code blocks should be surrounded by blank lines [Context: "```bash"] https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md031.md
C:\Users\myuser\projects\lambda\handler.py
```

Check failure on line 47 in content/en/user-guide/lambda-tools/hot-reloading/index.md

View workflow job for this annotation

GitHub Actions / Markdown Lint

Fenced code blocks should be surrounded by blank lines 

content/en/user-guide/lambda-tools/hot-reloading/index.md:47 MD031/blanks-around-fences Fenced code blocks should be surrounded by blank lines [Context: "```"] https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md031.md
Use the corresponding WSL-style path:
```bash

Check failure on line 49 in content/en/user-guide/lambda-tools/hot-reloading/index.md

View workflow job for this annotation

GitHub Actions / Markdown Lint

Fenced code blocks should be surrounded by blank lines 

content/en/user-guide/lambda-tools/hot-reloading/index.md:49 MD031/blanks-around-fences Fenced code blocks should be surrounded by blank lines [Context: "```bash"] https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md031.md
/mnt/c/Users/myuser/projects/lambda/handler.py
```

Check failure on line 51 in content/en/user-guide/lambda-tools/hot-reloading/index.md

View workflow job for this annotation

GitHub Actions / Markdown Lint

Fenced code blocks should be surrounded by blank lines 

content/en/user-guide/lambda-tools/hot-reloading/index.md:51 MD031/blanks-around-fences Fenced code blocks should be surrounded by blank lines [Context: "```"] https://github.com/DavidAnson/markdownlint/blob/v0.37.4/doc/md031.md
This ensures that LocalStack can properly mount and watch your Lambda code inside the container when running under WSL2.

**Layer limit with hot reloading for layers:**
When hot reloading is active for a Lambda layer (Pro), the function can use at most one layer.

Expand Down
Loading