Skip to content

Latest commit

 

History

History
245 lines (174 loc) · 8.41 KB

README.md

File metadata and controls

245 lines (174 loc) · 8.41 KB
Raw

Containerlab Basics

This workshop section introduces you to containerlab basics - topology file, image management workflows and lab lifecycle. It is loosely based on the official Containerlab quickstart.

Repository

Clone this repository to your workshop VM:

cd ~ && git clone https://github.com/srlinuxamericas/ac2-clab.git \
&& cd ac2-clab/10-basics

The repo should be cloned and you should be in the ac2-clab directory as per the output below:

autoconuser@2:~/ac2-clab/10-basics$

Topology

The topology file basic.clab.yml defines the lab we are going to use in this basics exercise. It consists of the two nodes:

  • Nokia SR Linux
  • Arista cEOS

The nodes are interconnected with a single link over their respective first Ethernet interfaces.

name: basic
topology:
  nodes:
    srl:
      kind: nokia_srlinux
      image: ghcr.io/nokia/srlinux
    ceos:
      kind: arista_ceos
      image: ceos:4.33.0F

  links:
    - endpoints: [srl:e1-1, ceos:eth1]

Deployment attempt #1

Try to deploy the lab:

sudo clab dep -t basic.clab.yml

Deployment fails, why?

Image management

Check what images are available on the system:

docker images

Pull SR Linux container image available for free:

docker pull ghcr.io/nokia/srlinux

Import cEOS image localled stored on your VM and pay attention to the 2nd argument for the docker import command where you have to specify the image:

docker import ~/images/cEOS64-lab-4.33.0F.tar ceos:4.33.0F

Expected output:

sha256:927c8cd41224d926dcbd491211653a0885d09733d1210806987a91ec1798e6d8

Check the local image store again:

docker images

Expected output:

REPOSITORY              TAG       IMAGE ID       CREATED          SIZE
ceos                    4.33.0F   927c8cd41224   34 seconds ago   2.46GB
ghcr.io/nokia/srlinux   latest    eb2a823cd8ce   8 days ago       2.35GB
hello-world             latest    d2c94e258dcb   18 months ago    13.3kB

Deployment attempt #2

Now that the images are available, try to deploy the lab again:

sudo clab dep -t basic.clab.yml

The deployment should succeed and a table will be displayed with the list of nodes and their management IPs.

+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| # |      Name       | Container ID |         Image         |     Kind      |  State  |  IPv4 Address  |     IPv6 Address     |
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| 1 | clab-basic-ceos | d58c68b6b088 | ceos:4.33.0F          | arista_ceos   | running | 172.20.20.2/24 | 3fff:172:20:20::2/64 |
| 2 | clab-basic-srl  | 6313e0cd122e | ghcr.io/nokia/srlinux | nokia_srlinux | running | 172.20.20.3/24 | 3fff:172:20:20::3/64 |
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+

Connecting to the nodes

Connect to the Nokia SR Linux node using the container name:

ssh clab-basic-srl

Connect to cEOS node using its hostname or IP address. Refer to the card for password.

ssh admin@172.20.20.2

Containerlab hosts automation

Containerlab creates /etc/hosts entries for each deployed lab so that you can access the nodes using their names. Check the entries:

cat /etc/hosts

Checking network connectivity

SR Linux and cEOS are started with their first Ethernet interfaces connected. Check the connectivity between the nodes:

The nodes also come up with LLDP enabled, our goal is to verify that the basic network connectivity is working by inspecting

ssh clab-basic-srl

and checking the LLDP neighbors on ethernet-1/1 interface

show /system lldp neighbor interface ethernet-1/1

The expected output should be:

--{ running }--[  ]--
A:srl# show /system lldp neighbor interface ethernet-1/1
  +----------+----------+---------+---------+---------+---------+---------+
  |   Name   | Neighbor | Neighbo | Neighbo | Neighbo | Neighbo | Neighbo |
  |          |          |    r    |    r    | r First | r Last  | r Port  |
  |          |          | System  | Chassis | Message | Update  |         |
  |          |          |  Name   |   ID    |         |         |         |
  +==========+==========+=========+=========+=========+=========+=========+
  | ethernet | 00:1C:73 | ceos    | 00:1C:7 | 20      | 16      | Etherne |
  | -1/1     | :46:95:5 |         | 3:46:95 | hours   | seconds | t1      |
  |          | C        |         | :5C     | ago     | ago     |         |
  +----------+----------+---------+---------+---------+---------+---------+

Listing running labs

When you are in the directory that contains the lab file, you can list the nodes of that lab simply by running:

sudo clab inspect

Expected output:

INFO[0000] Parsing & checking topology file: basic.clab.yml
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| # |      Name       | Container ID |         Image         |     Kind      |  State  |  IPv4 Address  |     IPv6 Address     |
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| 1 | clab-basic-ceos | c279d892ea22 | ceos:4.33.0F          | arista_ceos   | running | 172.20.20.2/24 | 2001:172:20:20::2/64 |
| 2 | clab-basic-srl  | 7c46eb454f51 | ghcr.io/nokia/srlinux | nokia_srlinux | running | 172.20.20.3/24 | 2001:172:20:20::3/64 |
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+

If the topology file is located in a different directory, you can specify the path to the topology file:

sudo clab inspect -t ~/ac2-clab/10-basics/
INFO[0000] Parsing & checking topology file: basic.clab.yml
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| # |      Name       | Container ID |         Image         |     Kind      |  State  |  IPv4 Address  |     IPv6 Address     |
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| 1 | clab-basic-ceos | c279d892ea22 | ceos:4.33.0F          | arista_ceos   | running | 172.20.20.2/24 | 2001:172:20:20::2/64 |
| 2 | clab-basic-srl  | 7c46eb454f51 | ghcr.io/nokia/srlinux | nokia_srlinux | running | 172.20.20.3/24 | 2001:172:20:20::3/64 |
+---+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+

You can also list all running labs regardless of where their topology files are located:

sudo clab inspect --all
+---+----------------+----------+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| # |   Topo Path    | Lab Name |      Name       | Container ID |         Image         |     Kind      |  State  |  IPv4 Address  |     IPv6 Address     |
+---+----------------+----------+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+
| 1 | basic.clab.yml | basic    | clab-basic-ceos | c279d892ea22 | ceos:4.33.0F          | arista_ceos   | running | 172.20.20.2/24 | 2001:172:20:20::2/64 |
| 2 |                |          | clab-basic-srl  | 7c46eb454f51 | ghcr.io/nokia/srlinux | nokia_srlinux | running | 172.20.20.3/24 | 2001:172:20:20::3/64 |
+---+----------------+----------+-----------------+--------------+-----------------------+---------------+---------+----------------+----------------------+

The output will contain all labs and their nodes.

Shortcuts:

  • sudo clab ins == sudo containerlab inspect
  • sudo clab ins -a == sudo containerlab inspect --all

Lab directory

Lab directory stores the artifacts generated by containerlab that are related to the lab:

  • tls certificates
  • startup configurations
  • inventory files
  • topology export json file
  • bind bounted directories

To list the contents of the lab directory, run:

tree -L 3 clab-basic/

Destroying the lab

When you are done with the lab, you can destroy it:

sudo clab destroy -t basic.clab.yml

You have now finished the basics lab exercise!