Skip to content
Snippets Groups Projects

Ansible playbook for deploying a containerlab node

This playbook is used to install containerlab on a VM, and test network configurations.

To run this playbook:

  1. Clone the base template (in Proxmox) "cl-base-os-template"
  2. Get the ip address of the new VM, and configure your ssh environment
  3. Create & activate a python virtual environment and install ansible
  4. Update inventory.yml so that your VM is defined in the "dev_environments" goup
  5. Run ansible like this: ansible-playbook -i inventory.yml playbook.yml

note: to run ansible, you'll also need to update group_vars/dev_environments.yml with the S3 access key & secret

Containerlab project template(s) are installed from here, in the ~nat users's home directory: https://gitlab.geant.org/nat/ansible-containerlab/-/tree/main/roles/dev_networks/files

To ssh into the nat user's shell, you'll need the containerlab-rsa private key ("b3BlbnNzaC1rZXktdjEAAAAABG5...")

To start containerlab (e.g. project lab01):

  1. shell into the nat user
  2. cd lab01
  3. sudo containerlab deploy

To view the currently running containerlab status:

  1. navigate to the same directory as above (e.g. lab01)
  2. sudo containerlab inspect