Ir para o conteúdo

Visual Studio Code

O Containerlab possui uma extensão oficial para o Visual Studio Code, que facilita significativamente a criação, edição, visualização e gerenciamento de topologias em formato YAML. Este guia mostra como instalar a extensão, explorar seus recursos e utilizá-la inclusive em ambientes remotos.

1. Instalação da Extensão

Pré-requisitos

  • Visual Studio Code instalado.
  • Containerlab instalado (documentação oficial).
  • Docker instalado e em execução no sistema.

Instalação

  1. Acesse o marketplace do Visual Studio Code.
  2. Pesquise por: Containerlab.
  3. Ou acesse diretamente: Containerlab Extension.
  4. Após instalar, você verá um ícone do Containerlab na barra lateral esquerda.

2. Uso Básico

Criando e Editando Topologias

  • Crie arquivos com extensão .clab.yml para definir sua topologia.
  • Clique no ícone do Containerlab na barra lateral e selecione "Criar Topologia".
  • Um novo arquivo será aberto com estrutura base para definição de nós e links.

Ações Rápidas via Explorer

Na visualização lateral:

  • As topologias são listadas automaticamente.

  • Clique com o botão direito sobre uma topologia para acessar:

  • Deploy

  • Destroy
  • Redeploy
  • Graph

  • Estados do lab são exibidos com ícones coloridos:

  • 🟠 Criando contêineres

  • 🟢 Lab em execução
  • 🔴 Erro na criação

2.1 Aba dos Nós

Ao expandir uma topologia:

  • Cada nó será listado com seu nome e status.

  • Clique com o botão direito no nó para:

  • Conectar via SSH/Telnet.

  • Abrir terminal (docker exec).
  • Copiar informações: IP, MAC, vendor, nome.
  • Iniciar/parar/reiniciar o nó.
  • Salvar configurações do nó.
  • Visualizar logs.
  • Abrir porta web do nó (se aplicável).
  • Acessar o painel de Link Impairments.

Interfaces

  • Clique com o botão esquerdo no nó para expandir suas interfaces.

  • Para cada interface:

  • Estado da interface é exibido.

  • Clique com o botão direito → "Abrir com Wireshark" (requer o plugin do Edgeshark instalado).

2.2 Visualizando Topologias com TopoViewer

  • Na visualização lateral, clique com o botão direito em uma topologia.
  • Selecione "Graph Topo View".

  • Será aberta uma visualização gráfica (TopoViewer) mostrando:

  • Nós com ícones customizáveis via labels.

  • Conexões.
  • Agrupamento e geolocalização (opcional via geo-lat, geo-long).

3. Acesso Remoto via SSH

A extensão do Containerlab pode ser usada em conjunto com o Remote - SSH do VS Code, possibilitando uso remoto completo.

Passo a Passo

  1. Instale a extensão Remote - SSH.
  2. Clique no ícone verde de SSH no canto inferior esquerdo.
  3. Selecione "Conectar a um servidor remoto...".
  4. Preencha as informações de conexão (host, usuário, etc).

  5. Após conectado:

  6. Instale a extensão Containerlab no host remoto (via VS Code).

  7. Use normalmente a extensão com as topologias remotas.

Documentação Oficial