From d691b370bc36947414552bb04aeddcc47b7bc32e Mon Sep 17 00:00:00 2001 From: Roman Dodin Date: Sun, 9 Apr 2023 17:18:34 +0200 Subject: [PATCH 1/3] rn 0.39 --- docs/rn/0.39.md | 21 +++++++++++++++++++++ mkdocs.yml | 1 + 2 files changed, 22 insertions(+) create mode 100644 docs/rn/0.39.md diff --git a/docs/rn/0.39.md b/docs/rn/0.39.md new file mode 100644 index 000000000..99c675cc3 --- /dev/null +++ b/docs/rn/0.39.md @@ -0,0 +1,21 @@ +# Release 0.39 + +:material-calendar: 2023-04-10 ยท :material-list-status: [Full Changelog](https://github.com/srl-labs/containerlab/releases) + +## Partial configs for SR OS + +Containerlab now supports partial configs for SR OS. This means that you can now specify only the parts of the config that you want to change, and the rest will be taken from the default config. This is a very useful feature when you want to change only a few things in the config, and you don't want to copy the whole config to your lab. #1249 + +Learn more about partial configs for SR OS [here](../manual/kinds/vr-sros.md#user-defined-config). + +## Node filtering + +This has been one of the most requested features for a long time. Users wanted to be able to deploy only a subset of nodes defined in their topology file. Usually, this was driven by the need to control the resource usage of the lab and and optimize the deployment time. + +Containerlab now allows users to provide a list of nodes to deploy, destroy, save, and graph commands to scope the operation to only those nodes. #1298 + +Check out [Node Filtering docs](../manual/node-filtering.md) for details. + +## Securely connecting to labs with Border0 (experimental) + +With mysocketio rebranding to border0 we had to revisit APIs for creating secured remote access to labs. This is an experimental feature and is not yet fully supported. Please see [this](../manual/published-ports.md) page for more details. #1131 diff --git a/mkdocs.yml b/mkdocs.yml index a660aa829..96ff876a6 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -94,6 +94,7 @@ nav: - 5-stage Clos topology: lab-examples/templated02.md - RARE/freeRtr: lab-examples/rare-freertr.md - Release notes: + - "0.39": rn/0.39.md - "0.38": rn/0.38.md - "0.37": rn/0.37.md - "0.36": rn/0.36.md From 444504a3d9c38e4364d7b1d4b643f74b5ac086ad Mon Sep 17 00:00:00 2001 From: Roman Dodin Date: Tue, 11 Apr 2023 14:25:00 +0200 Subject: [PATCH 2/3] brush up notes --- docs/rn/0.39.md | 35 ++++++++++++++++++++++++++++++++--- 1 file changed, 32 insertions(+), 3 deletions(-) diff --git a/docs/rn/0.39.md b/docs/rn/0.39.md index 99c675cc3..1498ee048 100644 --- a/docs/rn/0.39.md +++ b/docs/rn/0.39.md @@ -4,18 +4,47 @@ ## Partial configs for SR OS -Containerlab now supports partial configs for SR OS. This means that you can now specify only the parts of the config that you want to change, and the rest will be taken from the default config. This is a very useful feature when you want to change only a few things in the config, and you don't want to copy the whole config to your lab. #1249 - +Containerlab now supports partial configs for SR OS. This means you can now provide CLI snippets that will be added to the default config. A very useful feature when you want to add a few things to the config, and you don't want to copy the whole config to your lab. #1249 + +We believe this will make your lab repos cleaner and easier to maintain. + +=== "Topology" + ```yaml + name: sros_lab + topology: + nodes: + sros: + kind: vr-sros + startup-config: myconfig.partial.txt + ``` +=== "`myconfig.partial.txt`" + ``` + configure { + router "Base" { + static-routes { + route 192.168.200.200/32 route-type unicast { + next-hop "192.168.0.1" { + admin-state enable + } + } + } + } + } + ``` Learn more about partial configs for SR OS [here](../manual/kinds/vr-sros.md#user-defined-config). ## Node filtering -This has been one of the most requested features for a long time. Users wanted to be able to deploy only a subset of nodes defined in their topology file. Usually, this was driven by the need to control the resource usage of the lab and and optimize the deployment time. +One of the most requested features is finally there. Users wanted to be able to deploy only a subset of nodes defined in their topology file. Usually, this was driven by the need to control the resource usage of the lab and optimize the deployment time. Containerlab now allows users to provide a list of nodes to deploy, destroy, save, and graph commands to scope the operation to only those nodes. #1298 Check out [Node Filtering docs](../manual/node-filtering.md) for details. +## RARE joins Containerlab + +We are happy to announce that [RARE](../manual/kinds/rare-freertr.md) Network OS is now supported by Containerlab. RARE stands for Router for Academia, Research & Education. + ## Securely connecting to labs with Border0 (experimental) With mysocketio rebranding to border0 we had to revisit APIs for creating secured remote access to labs. This is an experimental feature and is not yet fully supported. Please see [this](../manual/published-ports.md) page for more details. #1131 From d30983dad674dd7ed814b49630f4ddf8676a87db Mon Sep 17 00:00:00 2001 From: Roman Dodin Date: Tue, 11 Apr 2023 16:07:55 +0200 Subject: [PATCH 3/3] added more release notes --- docs/htmltest.yml | 1 + docs/rn/0.39.md | 51 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) diff --git a/docs/htmltest.yml b/docs/htmltest.yml index 7c5e6f1d4..cdcdaa4d3 100644 --- a/docs/htmltest.yml +++ b/docs/htmltest.yml @@ -15,6 +15,7 @@ IgnoreURLs: - https://*github.com/ - https://twitter.com/* - mysocket.io # remove mysocket.io links until we rework to border0.com + - https://supportcenter.checkpoint.com/ # started to fail, meh. IgnoreDirectoryMissingTrailingSlash: true IgnoreAltMissing: true IgnoreSSLVerify: true diff --git a/docs/rn/0.39.md b/docs/rn/0.39.md index 1498ee048..c026003e8 100644 --- a/docs/rn/0.39.md +++ b/docs/rn/0.39.md @@ -31,8 +31,29 @@ We believe this will make your lab repos cleaner and easier to maintain. } } ``` + +The partial config can be provided as a [local file](../manual/kinds/vr-sros.md#partial-startup-config), [remote URL](../manual/kinds/vr-sros.md#remote-partial-files) or even [embedded](../manual/kinds/vr-sros.md#embedded-partial-files), yay! + Learn more about partial configs for SR OS [here](../manual/kinds/vr-sros.md#user-defined-config). +## Embedded startup-configs + +The changes made for allowing SR OS to have partial configs also allowed all other nodes to enjoy embedding startup-configs into the topology file. + +For example, this is a perfectly valid way to provide partial config for a Nokia SR Linux node: + +```yaml +name: srl + +topology: + nodes: + srl: + kind: nokia_srlinux + image: ghcr.io/nokia/srlinux:22.11.2 + startup-config: | + system information location "I am embedded config" +``` + ## Node filtering One of the most requested features is finally there. Users wanted to be able to deploy only a subset of nodes defined in their topology file. Usually, this was driven by the need to control the resource usage of the lab and optimize the deployment time. @@ -41,6 +62,36 @@ Containerlab now allows users to provide a list of nodes to deploy, destroy, sav Check out [Node Filtering docs](../manual/node-filtering.md) for details. +## CPU and Memory setting for SR OS nodes + +With [hellt/vrnetlab](https://github.com/hellt/vrnetlab/releases/tag/v0.10.1) release v0.10.1 we support setting the CPU and Memory for SR OS nodes. + +Before that feature was available, the CPU and Memory were set to the default values for a particular SR OS variant. This was not ideal as requirements change over time and when resources are underprovisioned, the node may not be able to start. + +Now you can set the CPU and Memory for SR OS nodes directly in the topology file: + +```yaml +# distrubuted node + sr: + kind: vr-sros + type: sr-1e + license: sros22.lic + env: + CP_MEMORY: 6 # CPM MEM + CP_CPU: 4 # CPM CPU + LC_MEMORY: 6 # Line card MEM + LC_CPU: 4 # Line card CPU + +# integrated + sr: + kind: vr-sros + type: sr-1 + license: sros22.lic + env: + MEMORY: 6 + CPU: 4 +``` + ## RARE joins Containerlab We are happy to announce that [RARE](../manual/kinds/rare-freertr.md) Network OS is now supported by Containerlab. RARE stands for Router for Academia, Research & Education.