W-tek Scriptbibliotek

Internt, sentralt bibliotek for automatiserings- og driftsscript på tvers av plattformene vi forvalter: Windows Server, Microsoft 365, NinjaRMM, SentinelOne og Cove – pluss delte hjelpefunksjoner.

Målet er at script skal være lette å finne, trygge å kjøre, og dokumentert godt nok til at en kollega kan ta dem i bruk uten å spørre forfatteren.

Mappestruktur

Biblioteket er organisert etter plattform/verktøy på toppnivå, med funksjonelle undermapper:

script-library/
├─ windows-server/        # Drift og herding av Windows Server
│  ├─ maintenance/        # Vedlikehold, opprydding, oppdatering
│  ├─ monitoring/         # Helsesjekker, statusrapporter
│  ├─ security-hardening/ # Herding, baseline, GPO
│  ├─ deployment/         # Utrulling, installasjon
│  └─ reporting/          # Rapporter og uttrekk
├─ microsoft-365/         # M365 / Entra / Exchange / Teams / SharePoint
│  ├─ entra-id/
│  ├─ exchange-online/
│  ├─ teams/
│  ├─ sharepoint-onedrive/
│  ├─ security-compliance/
│  └─ reporting/
├─ ninjarmm/              # Script som kjøres via NinjaRMM
│  ├─ automations/
│  ├─ monitoring/
│  ├─ software-deployment/
│  └─ reporting/
├─ sentinelone/           # SentinelOne drift og API
│  ├─ deployment/
│  ├─ response-actions/
│  ├─ reporting/
│  └─ api/
├─ cove/                  # Cove Data Protection (backup)
│  ├─ backup-jobs/
│  ├─ monitoring/
│  └─ reporting/
├─ _shared/               # Gjenbrukbare moduler, funksjoner og ressurser
│  ├─ modules/
│  ├─ functions/
│  └─ assets/
├─ templates/             # Maler for nye script (PS1/SH/PY) + script-README
└─ docs/                  # Overordnet dokumentasjon

Finnes det ikke en passende mappe? Opprett en ny undermappe i riktig plattform, og legg ved en kort README.md.

Slik legger du inn et nytt script

1. Velg riktig plattform- og funksjonsmappe.
2. Kopier en mal fra templates/ (template.ps1, template.sh, template.py).
3. Gi fila et beskrivende navn etter konvensjonen (se CONTRIBUTING.md).
4. Fyll ut hele headeren (synopsis, parametere, eksempel, forfatter, versjon, krav, endringslogg).
5. Enkle script kan ligge som én fil. Trenger scriptet flere filer/ressurser, lag en egen undermappe med en README.md (bruk templates/SCRIPT_README_TEMPLATE.md).
6. Commit på en egen branch og åpne en pull request for gjennomgang (se CONTRIBUTING.md).

Grunnregler

• Aldri hemmeligheter i repoet. Ingen passord, API-nøkler, tokens eller kundedata. Bruk parametere, miljøvariabler eller en hemmelighetsløsning.
• Alle script skal ha utfyllende header og minst ett EXAMPLE.
• Idempotent og trygt der mulig – støtt -WhatIf/dry-run for endringer.
• Test før merge – beskriv hva som er testet og på hvilken versjon.
• Én oppgave per script – hold dem fokuserte og gjenbrukbare.

Se CONTRIBUTING.md for fullstendige konvensjoner.