Files
projet-vxlan-automation/documentation/INSTALLATION.md
2023-10-20 19:13:06 +00:00

77 lines
2.6 KiB
Markdown

## Table of Contents
1. [Installing ContainerLab](#installing-containerlab)
2. [Installing vrnetlab](#installing-vrnetlab)
3. [Installing Docker](#installing-docker)
## Installing ContainerLab
ContainerLab can be installed using the installation script that detects the operating system type and installs the appropriate package:
```bash
# 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 Docker
This is the containerization engine used by ContainerLab.
```bash
# 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](https://www.arista.com/en/support/software-download).
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 :
```bash
docker import cEOS64-lab-4.30.3M.tar.xz ceos:4.30.3M
```
### Nokia SR Linux
```bash
docker pull ghcr.io/nokia/srlinux
```
Now you should see images available to use :
```bash
➜ 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](https://containerlab.dev/install/)
- [vrnetlab](https://containerlab.dev/manual/vrnetlab/#vrnetlab)
- [BrianLinkLetter](https://www.brianlinkletter.com/2019/03/vrnetlab-emulate-networks-using-kvm-and-docker/)
- [Docker Engine for Debian](https://docs.docker.com/engine/install/debian/)