Aller au contenu

La version 0.1.0 est une première version, à l'essai. Voir ce qui n'est pas prouvé →

bogolang
EN

← Exemples

backup_diff

Prend une nouvelle sauvegarde de chaque équipement et montre ce qui a changé depuis la précédente, section par section.

Prend une nouvelle sauvegarde de la configuration courante de chaque équipement de devices.csv et la compare avec la sauvegarde précédente du même équipement dans le dossier backups. Chaque ligne changée est montrée avec sa section devant (interface Gi1/0/3 / shutdown), donc une ligne qui a seulement bougé, ou le nombre d'octets qu'IOS écrit en haut, n'est pas montré comme un changement.

Exécutez-le sur les sorties enregistrées dans saved, sans équipement :

bogo run --replay saved backup_diff.bogo
bogo test backup_diff.bogo

Pour l'utiliser sur votre propre réseau :

  • Mettez vos équipements dans devices.csv et une sauvegarde précédente par équipement dans backups, nommée DEVICE.cfg.
  • Enregistrez des identifiants une fois avec bogo login default.
  • Exécutez-le sans --replay : il se connecte alors vraiment à chaque équipement par SSH.
  • Ajoutez le mot save après le nom du fichier pour garder les nouvelles sauvegardes à la place des anciennes : bogo run backup_diff.bogo save. Sans lui, rien n'est écrit.
  • Une sauvegarde contient des secrets de l'équipement. Gardez le dossier backups avec autant de soin que les équipements.
backup_diff.bogo
edition 2027
"""What changed since the last backup? Take a fresh backup of each device and compare it."""


class BackupDiff:
    """Compares the running configuration of each device with its file in the folder backups.
    Run with the word save to keep the fresh backups in place of the old ones."""

    folder: str = "backups"

    @staticmethod
    def touched(changes: ConfigDiff) -> list[str]:
        """The top sections a diff touches, each once, in order: 'vlan 30', 'ntp server ...'."""
        seen: list[str] = []
        for line in changes.removed + changes.added:
            top: str = line.split(" / ")[0]
            if top not in seen:
                seen.append(top)
        return seen

    @staticmethod
    def main(args: list[str]) -> None:
        devices: list[Device] = inventory("devices.csv")
        changed: int = 0
        for d in devices:
            fresh: Config = backup(d)
            old: Config = load_config(f"{BackupDiff.folder}/{d.name}.cfg", d.platform)
            changes: ConfigDiff = diff(old, fresh)
            if not changes:
                print(f"{d.name}: no change")
                continue
            changed += 1
            print(
                f"{d.name}: {len(changes.removed)} lines removed, {len(changes.added)} added, "
                f"in {len(BackupDiff.touched(changes))} sections"
            )
            print("    " + str(changes).replace("\n", "\n    "))
            if "save" in args:
                fresh.save(f"{BackupDiff.folder}/{d.name}.cfg")
        print(f"\n{changed} of {len(devices)} devices changed since their last backup.")


class TestBackupDiff:
    def config(self, text: str) -> Config:
        return Config(Device(name="sw-test", ip=192.0.2.99), text, "")

    def test_same_lines_is_no_change(self) -> None:
        a: Config = self.config("hostname sw-test\n!\nvlan 10\n name USERS\n")
        b: Config = self.config(
            "Current configuration : 99 bytes\nhostname sw-test\n!\nvlan 10\n name USERS\n"
        )
        assert not diff(a, b)

    def test_touched_lists_each_section_once(self) -> None:
        a: Config = self.config("interface Gi1/0/3\n description spare\n shutdown\n")
        b: Config = self.config("interface Gi1/0/3\n description cameras\nvlan 30\n name CAMERAS\n")
        assert BackupDiff.touched(diff(a, b)) == ["interface Gi1/0/3", "vlan 30"]