InfraBuilderOS

Allt du behöver, samlat i en wizard

InfraBuilderOS täcker hela livscykeln — från initial nätverksdesign till driftverifiering och dokumentation — utan att du behöver lämna terminalen.

TUI-gränssnittet i fyra skärmdumpar

Wizarden körs helt i terminalen med Textual som rendering-motor. Med --ascii-flaggan fungerar den i PuTTY och alla terminaler utan Unicode-stöd.

14 steg från blank canvas till driftklar infrastruktur

Varje steg är ett eget skärmformulär i TUI:n. Du navigerar fritt mellan stegen och kan spara projektet när som helst med Ctrl+S.

1. 01
   Welcome

   Ange projektnamn och beskrivning. Startar nytt projekt eller öppnar ett befintligt via --project.
2. 02
   Network

   Välj nätverksmall (three_tier, three_tier_oob, flat_oob). Justera VLAN-ID, subnater, DHCP-intervall och domannamn.
3. 03
   Hypervisor

   Ange Proxmox-adress, nodnamn och API-token för VM-provisionering via community.proxmox.
4. 04
   Firewall

   Välj OPNsense eller MikroTik RouterOS. Ange management-IP, API-nyckel och hemlighet (lagras som vault-referens).
5. 05
   VMs

   Lagg till, redigera och ta bort virtuella maskiner. Välj OS-version (Ubuntu 22/24, AlmaLinux 8/9, Windows Server 2022/2025) och VLAN-tillhorighet.
6. 06
   Services

   Aktivera tjänster per VM via kryssrutor. Beroenden löses automatiskt — aktiveras dns_ad läggs ad_dc till utan att du begär det.
7. 07
   Hardening

   Välj hardening-profil per VM: CIS Level 1, CIS Level 2 eller STIG. Konfigurerbara parametrar som skip_reboot och disruption_high.
8. 08
   OOB

   Konfigurera out-of-band-hantering via iDRAC (Dell) eller iLO (HPE) med IP-adress och autentiseringsuppgifter.
9. 09
   PXE

   Aktivera PXE-startserver. Ange TFTP-rot och nätverksgränssnitt för nätverksstart.
10. 10
    Summary

    Läsbar översikt över hela projektet — alla VMs, tjänster, VLAN och hardeningprofiler — innan generering startar.
11. 11
    Vault

    Wizarden scannar projektet efter vault_-nyckelreferenser och presenterar ett maskerat inmatningsfallt för vart och ett. Sparas krypterat till vault.yml.
12. 12
    Run

    Genererar Ansible-katalogen (playbooks, inventory, group_vars, roles) och kör playbooks via ansible-runner med realtidslogg i TUI:n.
13. 13
    Verify

    Driftdetektering: jämför faktiskt tillstånd mot projektdefinitionen. Visar MATCH, DRIFT eller MISSING per host och tjänst med sammanfattning.
14. 14
    Docs

    Generera sex dokumenttyper i Markdown eller HTML till valfri utdatakatalog. Innehåller systemoverview, trafikmatriser, användarmanualer och kravspecifikation.

Stödda operativsystem och komponenter

InfraBuilderOS stöder de vanligaste enterprise-operativsystemen, bade Linux och Windows, samt ledande brandväggar och Proxmox som hypervisor.

Operativsystem

Brandväggar

Hypervisor

16 inbyggda tjänstplugins

Varje plugin är ett Python-objekt som deklarerar plattform, beroenden, portar, Ansible-variabler och driftcheckar. Beroenden löses automatiskt — ingen manuell ordning krävs.

Tre färdiga nätverksmallar

Välj en mall i steg 2 som startpunkt. Alla VLAN-parametrar — ID, namn, subnot och DHCP-intervall — kan redigeras fritt efterat i TUI:n.

CIS och STIG via ansible-lockdown

InfraBuilderOS anvander ansible-lockdown-rollerna för OS-hardening. Konfigurera niva per VM i steg 7. STIG för Ubuntu är inte tillgängligt i ansible-lockdown; anvand CIS för Ubuntu-hostar.

Konfigurerbara parametrar per profil: skip_reboot, disruption_high, enabled_sections och custom_vars.

Ansible-katalogen som genereras

I steg 12 skapar generatorn följande katalogstruktur, redo att köras med ansible-playbook site.yml -i inventory/hosts.ini.

<output-dir>/
├── ansible.cfg
├── site.yml                          # Master playbook (importerar alla faser)
├── 01-network.yml                    # Brandväggskonfiguration
├── 02-hypervisor.yml                 # Proxmox-konfiguration
├── 03-vms.yml                        # Skapa virtuella maskiner
├── 04-base-config.yml               # Basinstallning (hostname, SSH, osv.)
├── 05-services.yml                   # Tjanstinstallation via plugins
├── 06-hardening.yml                  # OS-hardening (CIS/STIG)
├── 07-oob.yml                        # OOB-konfiguration (iDRAC/iLO)
├── 08-verify.yml                     # Driftverifiering
├── inventory/
│   ├── hosts.ini                     # Inventarielista
│   └── group_vars/
│       ├── all.yml                   # Globala variabler (utan vault)
│       ├── all/
│       │   ├── vars.yml              # Globala variabler (med vault)
│       │   └── vault.yml             # Krypterade hemligheter (ansible-vault)
│       ├── linux.yml                 # Linux-specifika variabler
│       ├── windows.yml               # Windows-specifika variabler
│       └── firewall.yml              # MikroTik-anslutningsvariabler
│   └── host_vars/
│       ├── webb01.yml                # Per-host-variabler (en fil per VM)
│       └── dc01.yml
└── roles/
    └── requirements.yml              # ansible-galaxy-beroenden

Hemligheter hanteras säkert i TUI:n

I steg 11 scannar wizarden alla vault_-nyckelreferenser i projektet — till exempel vault_ca_passphrase, opnsense_api_key — och presenterar ett maskerat inmatningsfallt för vart och ett.

Varden lagras i minnet och skrivs av generatorn till inventory/group_vars/all/vault.yml. Kryptera efterat med ansible-vault.

---
vault_ca_passphrase: "hemligt-lösenord"
vault_opnsense_api_key: "abc123"
vault_opnsense_api_secret: "xyz789"

ansible-vault encrypt inventory/group_vars/all/vault.yml

Jämför faktiskt tillstånd mot projektdefinitionen

Steg 13 kör playbook 08-verify.yml mot den levande infrastrukturen och jämför resultatet med vad som är definierat i projektet. Varje tjänst-plugin implementerar get_inventory_checks() som genererar de Ansible-tasks som körs.

TUI:n visar resultaten uppdelade per host med en sammanfattning av antal MATCH, DRIFT och MISSING. Varje host kan expanderas för att se detaljerade kontrollresultat.

Sex dokumenttyper genereras automatiskt

Steg 14 genererar dokumentation direkt från projektmodellen. Bade Markdown och standalone-HTML stöds. Välj utdatakatalog direkt i TUI:n.

Modulart — lägg till en tjänst med 1 fil

Att lägga till en ny tjänst kräver bara ett Python-objekt och en Ansible-roll. Pluginen dyker automatiskt upp i steg 6 för alla VMs med ett OS som listas i supported_os_versions.

from infrabuilder.services.base import ServicePlugin

class MinTjanstPlugin(ServicePlugin):

    @property
    def name(self) -> str:
        return "min_tjanst"

    @property
    def display_name(self) -> str:
        return "Min Tjänst"

    @property
    def platform(self) -> str:
        return "linux"   # eller "windows" eller "both"

    @property
    def supported_os_versions(self) -> list[str]:
        return ["ubuntu_2204", "ubuntu_2404", "alma_8", "alma_9"]

    def get_role_name(self) -> str:
        return "namespace.min_tjanst_roll"

    def get_ansible_vars(self, config: dict) -> dict:
        return {"min_tjanst_port": config.get("port", 8080)}

    def get_dependencies(self) -> list[str]:
        return []   # t.ex. ["ntp"] om NTP måste vara installerat först

    def get_ports(self) -> list[dict]:
        return [{"port": 8080, "proto": "tcp"}]

    def validate(self, config: dict) -> list[str]:
        errors = []
        port = config.get("port", 8080)
        if not isinstance(port, int) or not (1 <= port <= 65535):
            errors.append("port måste vara ett heltal mellan 1 och 65535")
        return errors

    def get_inventory_checks(self) -> list[dict]:
        return [
            {
                "name": "Check min_tjanst is running",
                "ansible.builtin.service_facts": {},
            }
        ]

    def default_config(self) -> dict:
        return {"port": 8080}

from infrabuilder.services.min_tjanst import MinTjanstPlugin  # noqa: F401

för _cls in [
    ...,
    MinTjanstPlugin,   # <-- lägg till har
]:
    registry.register(_cls)

Skapa sedan en Ansible-roll under roles/min_tjanst_roll/ eller registrera den i roles/requirements.yml för automatisk nedladdning via ansible-galaxy.