Skip to content

Commit

Permalink
0.60.1 release notes (#2338)
Browse files Browse the repository at this point in the history
* 0.60.1 release notes

* added devpod instructions for win
  • Loading branch information
hellt authored Dec 7, 2024
1 parent f4cd47d commit 37adecb
Show file tree
Hide file tree
Showing 3 changed files with 26 additions and 6 deletions.
4 changes: 2 additions & 2 deletions docs/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,13 +183,13 @@ The package installer will put the `containerlab` binary in the `/usr/bin` direc

## Windows

Containerlab runs on Windows powered by Windows Subsystem Linux (aka WSL), where you can run Containerlab directly or in a Devcontainer. Open up [Containerlab on Windows](windows.md) documentation for more details.
Containerlab runs on Windows powered by Windows Subsystem Linux (aka WSL), where you can run Containerlab directly or in a Devcontainer. Open up [**Containerlab on Windows**](windows.md) documentation for more details.

## Apple macOS

Running containerlab on macOS is possible both on ARM (M1/M2/M3/etc) and Intel chipsets. For a long time, we had many caveats around M-chipsets on Macs, but with the introduction of ARM64-native NOSes like Nokia SR Linux and Arista cEOS, powered by Rosetta emulation for x86_64-based NOSes, it is now possible to run containerlab on ARM-based Macs.

Since we wanted to share our experience with running containerlab on macOS in details, we have created a separate - [Containerlab on macOS](macos.md) - guide.
Since we wanted to share our experience with running containerlab on macOS in details, we have created a separate - [**Containerlab on macOS**](macos.md) - guide.

## Container

Expand Down
7 changes: 7 additions & 0 deletions docs/rn/0.60.md
Original file line number Diff line number Diff line change
Expand Up @@ -126,3 +126,10 @@ Please meet [WSL-Containerlab](https://github.com/srl-labs/wsl-containerlab).
* support for the interactive mode of the drawio integration #2291 by @FloSch62
* fixes and improvements to the installation scripts #2273 #2273
* enabled Netconf on SR Linux #2322

## Patches

### 0.60.1

* do not check bind paths when performing `destroy` #2334 #2337
* setup docker/moby 26.1.5 #2336
21 changes: 17 additions & 4 deletions docs/windows.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,18 +46,19 @@ wsl -l -v
On this system we already have a WSL VM with Ubuntu OS running, which was created when we installed WSL on Windows. If instead of a list of WSL VMs you get an error, you need to install WSL first:

```bash title="Installing WSL on Windows 11"
wsl --install
wsl --install -d Debian #(1)!
```

Installing WSL on Windows 11 will by default install the Ubuntu distribution. While it is perfectly fine to use it, we prefer Debian, so let's remove Ubuntu and install Debian instead:
1. Installing a new WSL system will prompt you to choose a username and password.

If you performed a default WSL installation before, you are likely running an Ubuntu, and while it is perfectly fine to use it, we prefer Debian, so let's remove Ubuntu and install Debian instead:

```bash title="Removing Ubuntu and installing Debian"
wsl --unregister Ubuntu #(1)!
wsl --install -d Debian #(1)!
wsl --install -d Debian
```

1. Unregistering a WSL VM will remove the VM. You should reference a WSL instance by the name you saw in the `wsl -l -v` command.
2. Installing a new WSL system will prompt you to choose a username and password.

Once the installation is complete, you will enter the WSL shell, which is a regular Linux shell[^2].

Expand Down Expand Up @@ -113,8 +114,19 @@ A few things to keep in mind when using devcontainers on windows:
```

Then you will be able to type `code .` in the cloned repository to open the project in VS Code.

2. As with macOS, you will likely wish to use a Docker-outside-of-Docker method, where the devcontainer will have access to the images and containers from the WSL VM.

## DevPod

DevPod delivers a stellar User Experience on macOS[^5], but on Windows, it requires a bit more setup. We tried to make it as easy as possible by providing you with the [WSL distribution](https://github.com/srl-labs/WSL-Containerlab) with the necessary tools pre-installed.

When you install Containerlab WSL VM and DevPod, you will have to create the SSH provider in DevPod with the following settings:

![pic](https://gitlab.com/rdodin/pics/-/wikis/uploads/f743697018ed049b5eb5a7afda175b02/image.png)

And that's it! You should now be able to use DevPod to run containerlabs on Windows.
[^1]: If you don't have a decent terminal emulator on Windows, install "Windows Terminal" from the Microsoft Store.
[^2]: The kernel and distribution parameters can be checked as follows:

Expand All @@ -132,3 +144,4 @@ A few things to keep in mind when using devcontainers on windows:

[^3]: Or any other desktop docker solution like Rancher Desktop, Podman Desktop, etc.
[^4]: Follows the devcontainer [specification](https://containers.dev/)
[^5]: Almost a [one-click solution](macos.md#devpod)

0 comments on commit 37adecb

Please sign in to comment.