Skip to content

Commit dee6378

Browse files
hellthellt
authoredJul 13, 2024··
Fix quickstart and srlceos lab configs (#2139)
* mention * fixed quickstart and srlceos lab * use srl formatting
·
v0.67.0v0.0.0-0.60.0-beta1
1 parent 5ef40fe commit dee6378

File tree

8 files changed

+302
-200
lines changed

8 files changed

+302
-200
lines changed
 

‎docs/install.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -29,12 +29,12 @@ The script officially supports the following OSes:
2929
* Fedora Server 40 (should work on other variants of Fedora)
3030
* Rocky Linux 9.3, 8.8 (should work on any 9.x and 8.x release)
3131

32-
3332
To install all components at once, run the following command on any of the supported OSes:
3433

3534
```bash
3635
curl -sL https://containerlab.dev/setup | sudo bash -s "all"
3736
```
37+
3838
/// note
3939
To complete installation please execute `newgrp docker` or logout and log back in.
4040
///
@@ -57,11 +57,11 @@ Other systems can follow the [manual installation](#manual-installation) procedu
5757
/// tab | Latest release
5858

5959
Download and install the latest release (may require `sudo`):
60-
61-
```bash
60+
<!-- --8<-- [start:install-script-cmd] -->
61+
```{.bash .no-select}
6262
bash -c "$(curl -sL https://get.containerlab.dev)"
6363
```
64-
64+
<!-- --8<-- [end:install-script-cmd] -->
6565
///
6666

6767
/// tab | Specific version

‎docs/lab-examples/srl-ceos.md

+172-100
Original file line numberDiff line numberDiff line change
@@ -1,134 +1,206 @@
1-
| | |
2-
| ----------------------------- | -------------------------------------------------------------------------------- |
3-
| **Description** | A Nokia SR Linux connected back-to-back with Arista cEOS |
4-
| **Components** | [Nokia SR Linux][srl], Arista cEOS |
5-
| **Resource requirements**[^1] | :fontawesome-solid-microchip: 2 <br/>:fontawesome-solid-memory: 2 GB |
6-
| **Topology file** | [srlceos01.clab.yml][topofile] |
7-
| **Name** | srlceos01 |
8-
| **Version information**[^2] | `containerlab:0.9.0`, `srlinux:20.6.3-145`, `ceos:4.32.0F`, `docker-ce:19.03.13` |
1+
# Nokia SR Linux and Arista cEOS
2+
3+
| | |
4+
| ----------------------------- | --------------------------------------------------------------------------- |
5+
| **Description** | A Nokia SR Linux connected back-to-back with Arista cEOS |
6+
| **Components** | [Nokia SR Linux][srl], Arista cEOS |
7+
| **Resource requirements**[^1] | :fontawesome-solid-microchip: 2 <br/>:fontawesome-solid-memory: 4 GB |
8+
| **Topology file** | [srlceos01.clab.yml][topofile] |
9+
| **Name** | srlceos01 |
10+
| **Version information**[^2] | `containerlab:0.56.0`, `srlinux:24.3.3`, `ceos:4.32.0F`, `docker-ce:26.0.0` |
911

1012
## Description
13+
1114
A lab consists of an SR Linux node connected with Arista cEOS via a point-to-point ethernet link. Both nodes are also connected with their management interfaces to the `containerlab` docker network.
1215

13-
<div class="mxgraph" style="max-width:100%;border:1px solid transparent;margin:0 auto; display:block;" data-mxgraph="{&quot;page&quot;:0,&quot;zoom&quot;:1.5,&quot;highlight&quot;:&quot;#0000ff&quot;,&quot;nav&quot;:true,&quot;check-visible-state&quot;:true,&quot;resize&quot;:true,&quot;url&quot;:&quot;https://raw.githubusercontent.com/srl-labs/containerlab/diagrams/srlceos01.drawio&quot;}"></div>
16+
<div class='mxgraph' style='max-width:100%;border:1px solid transparent;margin:0 auto; display:block;' data-mxgraph='{"page":0,"zoom":1.5,"highlight":"#0000ff","nav":true,"resize":true,"edit":"_blank","url":"https://raw.githubusercontent.com/srl-labs/containerlab/diagrams/srlceos01.drawio"}'></div>
17+
18+
## Deployment
19+
20+
The deployment process of this lab is explained in the [quickstart](../quickstart.md#deploying-a-lab).
1421

1522
## Use cases
23+
1624
This lab allows users to launch basic interoperability scenarios between Nokia SR Linux and Arista cEOS operating systems.
1725

1826
### BGP
27+
1928
<div class="mxgraph" style="max-width:100%;border:1px solid transparent;margin:0 auto; display:block;" data-mxgraph="{&quot;page&quot;:1,&quot;zoom&quot;:1.5,&quot;highlight&quot;:&quot;#0000ff&quot;,&quot;nav&quot;:true,&quot;check-visible-state&quot;:true,&quot;resize&quot;:true,&quot;url&quot;:&quot;https://raw.githubusercontent.com/srl-labs/containerlab/diagrams/srlceos01.drawio&quot;}"></div>
2029

2130
This lab demonstrates a simple iBGP peering scenario between Nokia SR Linux and Arista cEOS. Both nodes exchange NLRI with their loopback prefix making it reachable.
2231

2332
#### Configuration
33+
2434
Once the lab is deployed with containerlab, use the following configuration instructions to make interfaces configuration and enable BGP on both nodes.
2535

26-
=== "srl"
27-
Get into SR Linux CLI with `docker exec -it clab-srlceos01-srl sr_cli` and start configuration
28-
```bash
29-
# enter candidate datastore
30-
enter candidate
31-
32-
# configure loopback and data interfaces
33-
set / interface ethernet-1/1 admin-state enable
34-
set / interface ethernet-1/1 subinterface 0 admin-state enable
35-
set / interface ethernet-1/1 subinterface 0 ipv4 address 192.168.1.1/24
36-
37-
set / interface lo0 subinterface 0 admin-state enable
38-
set / interface lo0 subinterface 0 ipv4 address 10.10.10.1/32
39-
set / network-instance default interface ethernet-1/1.0
40-
set / network-instance default interface lo0.0
41-
42-
# configure BGP
43-
set / network-instance default protocols bgp admin-state enable
44-
set / network-instance default protocols bgp router-id 10.10.10.1
45-
set / network-instance default protocols bgp autonomous-system 65001
46-
set / network-instance default protocols bgp group ibgp ipv4-unicast admin-state enable
47-
set / network-instance default protocols bgp group ibgp export-policy export-lo
48-
set / network-instance default protocols bgp neighbor 192.168.1.2 admin-state enable
49-
set / network-instance default protocols bgp neighbor 192.168.1.2 peer-group ibgp
50-
set / network-instance default protocols bgp neighbor 192.168.1.2 peer-as 65001
51-
52-
# create export policy
53-
set / routing-policy policy export-lo statement 10 match protocol local
54-
set / routing-policy policy export-lo statement 10 action accept
55-
56-
# commit config
57-
commit now
58-
```
59-
=== "ceos"
60-
Get into cEOS CLI with `docker exec -it clab-srlceos01-ceos Cli` and start configuration
61-
```bash
62-
# enter configuration mode
63-
configure
64-
ip routing
65-
66-
# configure loopback and data interfaces
67-
interface Ethernet1
68-
no switchport
69-
ip address 192.168.1.2/24
70-
exit
71-
interface Loopback0
72-
ip address 10.10.10.2/32
73-
exit
74-
75-
# configure BGP
76-
router bgp 65001
77-
router-id 10.10.10.2
78-
neighbor 192.168.1.1 remote-as 65001
79-
network 10.10.10.2/32
80-
exit
81-
```
36+
/// tab | SR Linux
37+
Get into SR Linux CLI with `ssh clab-srlceos01-srl` and start configuration. You can configure the node by typing in commands using the snippet below, or copy it entirely and paste it into the CLI.
38+
39+
```{.srl .code-scroll-lg}
40+
# enter the candidate datastore
41+
enter candidate
42+
43+
# configure physical interface
44+
/ interface ethernet-1/1 {
45+
admin-state enable
46+
subinterface 0 {
47+
ipv4 {
48+
admin-state enable
49+
address 192.168.1.1/24 {
50+
}
51+
}
52+
}
53+
}
54+
55+
# configure loopback interface
56+
/ interface lo0 {
57+
subinterface 0 {
58+
ipv4 {
59+
admin-state enable
60+
address 10.10.10.1/32 {
61+
}
62+
}
63+
}
64+
}
65+
66+
# configure routing policy to import/export routes via BGP
67+
/ routing-policy {
68+
policy loopbacks-policy {
69+
statement 1 {
70+
match {
71+
protocol local
72+
}
73+
action {
74+
policy-result accept
75+
}
76+
}
77+
}
78+
}
79+
80+
/ network-instance default {
81+
# add physical and logical interface to the network instance
82+
interface ethernet-1/1.0 {
83+
}
84+
interface lo0.0 {
85+
}
86+
protocols {
87+
bgp {
88+
autonomous-system 65001
89+
router-id 10.10.10.1
90+
afi-safi ipv4-unicast {
91+
admin-state enable
92+
}
93+
group ibgp {
94+
export-policy loopbacks-policy
95+
import-policy loopbacks-policy
96+
}
97+
neighbor 192.168.1.2 {
98+
admin-state enable
99+
peer-as 65001
100+
peer-group ibgp
101+
}
102+
}
103+
}
104+
}
105+
106+
commit now
107+
```
108+
109+
///
110+
/// tab | cEOS
111+
Get into cEOS CLI with `ssh clab-srlceos01-ceos`[^3] and start configuration
112+
113+
```bash
114+
# enter configuration mode
115+
enable
116+
configure
117+
ip routing
118+
119+
# configure loopback and data interfaces
120+
interface Ethernet1
121+
no switchport
122+
ip address 192.168.1.2/24
123+
exit
124+
interface Loopback0
125+
ip address 10.10.10.2/32
126+
exit
127+
128+
# configure BGP
129+
router bgp 65001
130+
router-id 10.10.10.2
131+
neighbor 192.168.1.1 remote-as 65001
132+
network 10.10.10.2/32
133+
exit
134+
exit
135+
```
136+
137+
///
82138

83139
#### Verification
140+
84141
Once BGP peering is established, the routes can be seen in GRT of both nodes:
85142

86-
=== "srl"
87-
```bash
88-
A:srl# show network-instance default route-table ipv4-unicast summary | grep bgp
89-
| 10.10.10.2/32 | 0 | true | bgp | 0 | 170 | 192.168.1.2 (indirect) | None |
90-
```
91-
92-
=== "ceos"
93-
```bash
94-
ceos>show ip route
95-
96-
VRF: default
97-
Codes: C - connected, S - static, K - kernel,
98-
O - OSPF, IA - OSPF inter area, E1 - OSPF external type 1,
99-
E2 - OSPF external type 2, N1 - OSPF NSSA external type 1,
100-
N2 - OSPF NSSA external type2, B - BGP, B I - iBGP, B E - eBGP,
101-
R - RIP, I L1 - IS-IS level 1, I L2 - IS-IS level 2,
102-
O3 - OSPFv3, A B - BGP Aggregate, A O - OSPF Summary,
103-
NG - Nexthop Group Static Route, V - VXLAN Control Service,
104-
DH - DHCP client installed default route, M - Martian,
105-
DP - Dynamic Policy Route, L - VRF Leaked,
106-
RC - Route Cache Route
107-
108-
Gateway of last resort:
109-
K 0.0.0.0/0 [40/0] via 172.20.20.1, Management0
110-
111-
B I 10.10.10.1/32 [200/0] via 192.168.1.1, Ethernet1
112-
C 10.10.10.2/32 is directly connected, Loopback0
113-
C 172.20.20.0/24 is directly connected, Management0
114-
C 192.168.1.0/24 is directly connected, Ethernet1
115-
```
143+
/// tab | SR Linux
144+
145+
```srl
146+
A:srl# show / network-instance default route-table ipv4-unicast prefix 10.*2/32
147+
--------------------------------------------------------------------------------------------------------------------------------------------------
148+
IPv4 unicast route table of network instance default
149+
--------------------------------------------------------------------------------------------------------------------------------------------------
150+
+----------------+------+-----------+--------------------+---------+---------+--------+-----------+----------+----------+----------+-------------+
151+
| Prefix | ID | Route | Route Owner | Active | Origin | Metric | Pref | Next-hop | Next-hop | Backup | Backup |
152+
| | | Type | | | Network | | | (Type) | Interfac | Next-hop | Next-hop |
153+
| | | | | | Instanc | | | | e | (Type) | Interface |
154+
| | | | | | e | | | | | | |
155+
+================+======+===========+====================+=========+=========+========+===========+==========+==========+==========+=============+
156+
| 10.10.10.2/32 | 0 | bgp | bgp_mgr | True | default | 0 | 170 | 192.168. | ethernet | | |
157+
| | | | | | | | | 1.0/24 ( | -1/1.0 | | |
158+
| | | | | | | | | indirect | | | |
159+
| | | | | | | | | /local) | | | |
160+
+----------------+------+-----------+--------------------+---------+---------+--------+-----------+----------+----------+----------+-------------+
161+
```
162+
163+
///
164+
/// tab | cEOS
165+
166+
```bash
167+
ceos>show ip route
168+
169+
VRF: default
170+
Codes: C - connected, S - static, K - kernel,
171+
O - OSPF, IA - OSPF inter area, E1 - OSPF external type 1,
172+
E2 - OSPF external type 2, N1 - OSPF NSSA external type 1,
173+
N2 - OSPF NSSA external type2, B - BGP, B I - iBGP, B E - eBGP,
174+
R - RIP, I L1 - IS-IS level 1, I L2 - IS-IS level 2,
175+
O3 - OSPFv3, A B - BGP Aggregate, A O - OSPF Summary,
176+
NG - Nexthop Group Static Route, V - VXLAN Control Service,
177+
DH - DHCP client installed default route, M - Martian,
178+
DP - Dynamic Policy Route, L - VRF Leaked,
179+
RC - Route Cache Route
180+
181+
Gateway of last resort:
182+
K 0.0.0.0/0 [40/0] via 172.20.20.1, Management0
183+
184+
B I 10.10.10.1/32 [200/0] via 192.168.1.1, Ethernet1
185+
C 10.10.10.2/32 is directly connected, Loopback0
186+
C 172.20.20.0/24 is directly connected, Management0
187+
C 192.168.1.0/24 is directly connected, Ethernet1
188+
```
116189

190+
///
117191
Data plane confirms that routes have been programmed to FIB:
192+
118193
```
119194
A:srl# ping 10.10.10.2 network-instance default
120195
Using network instance default
121196
PING 10.10.10.2 (10.10.10.2) 56(84) bytes of data.
122197
64 bytes from 10.10.10.2: icmp_seq=1 ttl=64 time=3.47 ms
123198
```
124199

125-
126-
127200
[srl]: https://www.nokia.com/networks/products/service-router-linux-NOS/
128-
[ceos]:
129201
[topofile]: https://github.com/srl-labs/containerlab/tree/main/lab-examples/srlceos01/srlceos01.clab.yml
130202

131203
[^1]: Resource requirements are provisional. Consult with the installation guides for additional information.
132204
[^2]: The lab has been validated using these versions of the required tools/components. Using versions other than stated might lead to a non-operational setup process.
133-
134-
<script type="text/javascript" src="https://viewer.diagrams.net/js/viewer-static.min.js" async></script>
205+
[^3]: Credentials `admin:admin`
206+
<script type="text/javascript" src="https://viewer.diagrams.net/js/viewer-static.min.js" async></script>

‎docs/manual/kinds/ceos.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ cEOS nodes launched with containerlab comes up with
1414
* `admin` user created with password `admin`
1515

1616
## Getting cEOS image
17-
17+
<!-- --8<-- [start:ceos-get-image] -->
1818
Arista requires its users to register with arista.com before downloading any images. Once you created an account and logged in, go to the [software downloads](https://www.arista.com/en/support/software-download) section and download ceos64 tar archive for a given release.
1919

2020
Once downloaded, import the archive with docker:
@@ -23,7 +23,7 @@ Once downloaded, import the archive with docker:
2323
# import container image and save it under ceos:4.32.0F name
2424
docker import cEOS64-lab-4.32.0F.tar.xz ceos:4.32.0F
2525
```
26-
26+
<!-- --8<-- [end:ceos-get-image] -->
2727
## Managing ceos nodes
2828

2929
Arista cEOS node launched with containerlab can be managed via the following interfaces:

‎docs/quickstart.md

+110-90
Large diffs are not rendered by default.

‎docs/rn/0.56.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ See the [Ostinato integration](../manual/kinds/ostinato.md) page for more detail
2929

3030
We have added support for the following new SONiC kinds:
3131

32-
- [`sonic-vm`](../manual/kinds/sonic-vm.md) - is a VM-based upstream SONiC. You may want to pick sonic-vm over [sonic-vs](../manual/kinds/sonic-vs.md) if you hit some issues with the original sonic container #2120
32+
- [`sonic-vm`](../manual/kinds/sonic-vm.md) - is a VM-based upstream SONiC. You may want to pick sonic-vm over [sonic-vs](../manual/kinds/sonic-vs.md) if you hit some issues with the original sonic container. Added by @adam-kulagowski in #2120
3333
- [`dell_sonic`](../manual/kinds/dell_sonic.md) - is a SONiC distribution by Dell #2125
3434

3535
## Multi-arch `clab` container build

‎docs/stylesheets/extra.css

+10-1
Original file line numberDiff line numberDiff line change
@@ -139,4 +139,13 @@ https://github.com/squidfunk/mkdocs-material/discussions/4157#discussioncomment-
139139
padding-top: 0.5rem;
140140
}
141141

142-
/* END border for content tabs */
142+
/* END border for content tabs */
143+
144+
/* scrollable code blocks used in code snippets */
145+
div.highlight.code-scroll-lg pre>code {
146+
max-height: 80vh;
147+
}
148+
149+
div.highlight.code-scroll-sm pre>code {
150+
max-height: 50vh;
151+
}

‎lab-examples/srlceos01/srlceos01.clab.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ topology:
55
nodes:
66
srl:
77
kind: nokia_srlinux
8-
image: ghcr.io/nokia/srlinux
8+
image: ghcr.io/nokia/srlinux:24.3.3
99
ceos:
1010
kind: arista_ceos
1111
image: ceos:4.32.0F

‎mkdocs.yml

+2-1
Original file line numberDiff line numberDiff line change
@@ -261,7 +261,7 @@ plugins:
261261
redirect_maps:
262262
lab-examples/tls-cert.md: https://clabs.netdevops.me/security/gnmitls/
263263
lab-examples/ixp-lab.md: lab-examples/peering-lab.md
264-
#- typeset
264+
#- typeset
265265
- glightbox
266266
- macros:
267267
j2_block_start_string: "[[[%"
@@ -337,6 +337,7 @@ markdown_extensions:
337337
- pymdownx.snippets:
338338
check_paths: true
339339
dedent_subsections: true
340+
url_download: true
340341
- pymdownx.superfences:
341342
custom_fences:
342343
- name: mermaid

0 commit comments

Comments
 (0)
Please sign in to comment.