projet-vxlan-automation/documentation/INSTALLATION.md

Table of Contents

1. Installing ContainerLab
2. Installing vrnetlab
3. Installing Docker

Installing ContainerLab

ContainerLab can be installed using the installation script that detects the operating system type and installs the appropriate package:

# download and install the latest version (may require sudo)
bash -c "$(curl -sL https://get.containerlab.dev)"

# with wget
bash -c "$(wget -qO - https://get.containerlab.dev)"

Installing vrnetlab

Vrnetlab places a VM inside a container and makes it executable as if it were a container image.
To do this, vrnetlab provides a set of scripts that build the container image from a VM disk provided by the user.

# update and install dependencies
sudo apt update
sudo apt -y install python3-bs4 sshpass make
sudo apt -y install git

# move to /opt and clone the project
cd /opt && sudo git clone https://github.com/hellt/vrnetlab

# optional: change the directory permissions
sudo chown -R $USER:$USER vrnetlab

Installing Docker

This is the containerization engine used by ContainerLab.

# Update and install dependencies
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg

# Add Docker's official GPG key:
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

# Add the repository to Apt sources:
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# To be able to execute docker with the current user
sudo usermod -aG docker $USER

Images installation

Arista cEOS

To download and install the arista cEOS image, you need to be registered to arista.com.
Once you created an account, please logged in and down the cEOS docker images.

To add this new image to docker, please use the docker CLI command :

docker import cEOS-lab-4.30.3M.tar ceos:4.30.3M

Cisco SR Linux

docker pull ghcr.io/nokia/srlinux

Now you should see images available to use :

➜  projet-vxlan-automation git:(main) ✗ docker images
REPOSITORY              TAG       IMAGE ID       CREATED       SIZE
ceos                    4.30.3M   63870e68ff8d   2 days ago    1.95GB
ghcr.io/nokia/srlinux   latest    801eb020ad70   11 days ago   2.59GB

Sources

• ContainerLab
• vrnetlab
• BrianLinkLetter
• Docker Engine for Debian