Netmiko to biblioteka napisana w Pythonie przez Kirka Byersa. Jest jedną z najłatwiejszych opcji wejścia w świat automatyzacji sieci. Dlaczego? Ponieważ Netmiko wykorzystuje Pythonową bibliotekę Paramiko do łączenia się poprzez SSH do CLI. Wszystkie przekazywane przez nasz program polecenia są już Ci świetnie znane z obcowania z CLI danego producenta.

Instalacja Netmiko

Zanim zabierzemy się za nasz pierwszy skrypt, musimy zainstalować Pythona oraz  Netmiko. Ponieważ nie jest to standardowa biblioteka Pythona, zanim zaczniemy z niej korzystać, musimy ją doinstalować. Bez obaw, Python ma świetny manager bibliotek – pip, dzięki któremu możemy zainstalować brakującą bibliotekę.

pip install netmiko

Choć kod Pythona można pisać nawet w notatniku, gorąco polecam zaopatrzyć się w IDE, czyli specjalne środowisko programistyczne. Ułatwi Ci to i przyspieszy pracę, choćby przez podświetlenie składni. Osobiście korzystam z Pycharm lub Visual Studio Code.

Zanim zaczniesz

Zanim przejdziemy do samego pisania kodu, trzeba zrobić jeszcze kilka rzeczy. Przede wszystkim upewnij się, że masz dostęp do urządzenia, na którym będziesz testował swój program.

W moim przypadku będzie to wirtualny router Cisco w labie. 

ping 172.31.5.176
Pinging 172.31.5.176 with 32 bytes of data:
Reply from 172.31.5.176: bytes=32 time=22ms TTL=254
Reply from 172.31.5.176: bytes=32 time=25ms TTL=254
Reply from 172.31.5.176: bytes=32 time=23ms TTL=254

ssh cisco@172.31.5.176
cisco@172.31.5.176's password:
BDG-ACCR-01>

from netmiko import ConnectHandler
connection = ConnectHandler(
device_type='cisco_ios',
host='172.31.5.176',  
username='cisco', 
password='cisco')

output = connection.send_command('show ip interface brief')

print(output)
print('Zamykam polaczenie')

connection.disconnect()

C:/Users/RafałRudewicz/PycharmProjects/pierwszy_skrypt/main.py
Interface IP-Address OK? Method Status Protocol
GigabitEthernet0/0 172.31.5.176 YES DHCP up up 
GigabitEthernet0/1 10.1.1.10 YES NVRAM administratively down down 
GigabitEthernet0/2 unassigned YES unset administratively down down 
GigabitEthernet0/3 unassigned YES unset administratively down down 
Zamykam polaczenie

from netmiko import ConnectHandler
import getpass

passwd = getpass.getpass('Podaj haslo: ') 
connection = ConnectHandler( 
device_type='cisco_ios',
host='172.31.5.176', 
username='cisco', 
password=passwd)

output=connection.send_command('show ip interface brief')

print(output) 
print('Zamykam polaczenie')

connection.disconnect()

from netmiko import ConnectHandler
import getpass

passwd = getpass.getpass('Podaj haslo: ') 
connection = ConnectHandler( 
device_type='cisco_ios',
host='172.31.5.176', 
username='cisco', 
password=passwd, 
secret=passwd) 

connection.enable() 
output=connection.send_command('show run') 

print(output) 
print('Zamykam polaczenie') 

connection.disconnect()

Przejście do trybu konfiguracyjnego

Aby przejść do trybu konfiguracyjnego w Netmiko, mamy w zasadzie dwie opcje. Jedną z nich jest użycie znanej już metody send_command() z poleceniem „configure terminal„. Jednak bardziej elegancką i preferowaną opcją jest użycie metody config_mode(). Dlaczego tak? Netmiko potrafi obsługiwać wiele typów urządzeń od różnych producentów, ci zaś mogą posługiwać się odmiennymi zestawami poleceń dla trybu konfiguracyjnego.

from netmiko import ConnectHandler
import getpass

passwd = getpass.getpass('Podaj haslo: ')
connection = ConnectHandler(
device_type='cisco_ios',
host='172.31.5.176',
username='cisco',
password=passwd,
secret=passwd)
connection.enable()
connection.config_mode()
connection.send_command('hostname BDG-ACCR-01')
connection.exit_config_mode()
output=connection.send_command('show run | i hostname')

print(output)
print('Zamykam polaczenie')
connection.disconnect()

Zakończenie skryptu przez użytkownika

W obecnej formie skrypt wykonuje nasze instrukcje i po wykonaniu zadania ulega zamknięciu. Co, jednak gdybyśmy chcieli zobaczyć co wprowadzone zmiany?

from netmiko import ConnectHandler
import getpass

passwd = getpass.getpass('Podaj haslo: ')
connection = ConnectHandler(
device_type='cisco_ios',
host='172.31.5.176',
username='cisco',
password=passwd,
secret=passwd)
connection.enable()
connection.config_mode()
connection.send_command('hostname BDG-ACCR-01')
connection.exit_config_mode()
output=connection.send_command('show run | i hostname')

print(output)
input("Nacisnij Enter by zakonczyc...")
print('Zamykam polaczenie')
connection.disconnect()

W tym celu skorzystaliśmy ze wbudowanej w Pythona funkcji input(). Wyświetla ona tekst na ekranie oraz oczekuje na interakcję ze strony użytkownika. Dzięki temu nasz program nie zostanie zamknięty bez naszej zgody.

Podsumowanie

Gratulacje, właśnie dowiedziałeś się, jak napisać swój pierwszy skrypt do automatyzacji sieci z zastosowaniem Netmiko. Teraz już wiesz, w jaki sposób możesz sprawnie podłączyć się do zdalnego urządzenia, zmienić konfigurację oraz wykonać wiele poleceń typu show.

 Daj znać w komentarzu, czy już wcześniej miałeś styczność z automatyzacją sieci!