Referenz für Software-Deployments

Konfigurationsfelder, Paketmanager und Zeitplansyntax für Software-Deployments

Referenz für Software-Deployments

Diese Referenz beschreibt die Konfigurationsfelder, Paketmanager und Zeitplanoptionen für Software-Deployments.

Funktionsstatus

Komponente	Status
Paketkatalogsuche (Chocolatey, winget, Homebrew)	Verfügbar
Konfigurationspaket-UI und -API	Verfügbar
Zeitplankonfiguration	Verfügbar
Gerätezuweisung und Abgleich	Verfügbar
Agent-seitige Paketinstallation	Verfügbar
Installationsergebnis-Protokollierung	Verfügbar

Konfigurationsfelder des Software-Deployments

Den Paketmanager wählst du über die Tab-Leiste oben im Dialog „Software hinzufügen“ — Chocolatey, Homebrew, winget, APT oder Eigene. Die Wahl steht fest, sobald das Deployment angelegt ist: Der Bearbeiten-Dialog zeigt den Paketmanager nur noch als Badge an. Der Dialog bietet außerdem einen Modus-Umschalter mit zwei Optionen — Einzelnes Paket und Alle veralteten aktualisieren —, der bestimmt, welche Felder gelten.

Katalog-Modus (Einzelnes Paket)

Feld	Typ	Erforderlich	Standard	Beschreibung
Anzeigename	string	Ja	—	Ein lesbarer Name, der in der octoja-Oberfläche angezeigt wird (aus dem Katalogeintrag vorausgefüllt)
Version	string	Nein	latest	Die zu installierende Version. Verwende `latest`, um immer die neueste verfügbare Version zu installieren, oder gib eine exakte Versionszeichenfolge an
Installationsverhalten	enum	Nein	Installieren & Aktualisieren	Installieren & Aktualisieren (`InstallAndUpdate`): Installiert bei Fehlen, aktualisiert bei veralteter Version. Nur Aktualisieren (`UpdateOnly`): Aktualisiert nur bereits auf dem Gerät vorhandene Software
Installationsargumente	string	Nein	—	Optionale Befehlszeilenargumente, die dem Paketmanager bei der Installation übergeben werden. Verfügbar, solange du das Deployment anlegst
Installieren für	enum	Nein	Alle Benutzer	Nur Windows (intern: `ExecutionContext`). Alle Benutzer (`System`): installiert für jeden Benutzer des Geräts und funktioniert auch, wenn niemand angemeldet ist — läuft als `NT AUTHORITY\SYSTEM` ohne interaktiven Desktop. Für die meisten Bereitstellungen empfohlen. Nur aktueller Benutzer (`User`): installiert nur für den angemeldeten Benutzer in dessen Profil und erfordert, dass jemand am Gerät angemeldet ist. Die Auswahl steht für winget und Chocolatey beim Anlegen und Bearbeiten bereit, auch bei Alle veralteten aktualisieren. macOS (Homebrew) und Linux (APT) ignorieren dieses Feld
Im Software-Kiosk anzeigen	bool	Nein	Nein	Zeigt diese Software auf der Software-Kiosk-Seite an, sodass Endbenutzer sie mit einem Klick selbst installieren können. Die Kiosk-Seite erreicht ein Gerät, sobald ein passendes Konfigurationspaket auf seinem Tab „Agent“ zusätzlich Software-Kiosk aktiviert gesetzt hat

Manuelle Eingabe (APT)

Der APT-Tab fragt das Paket von Hand ab, statt Katalogtreffer anzuzeigen — Debian und Ubuntu veröffentlichen keine Such-API. Gib einen Paketnamen und optional eine Version ein und wechsle dann in dasselbe Konfigurationsformular wie im Katalog-Modus: Der Anzeigename ist aus dem Paketnamen vorausgefüllt, und Version, Installationsverhalten, Installationsargumente und Im Software-Kiosk anzeigen verhalten sich genau wie dort.

Feld	Typ	Erforderlich	Standard	Beschreibung
Paketname	string	Ja	—	Der Bezeichner genau so, wie er im Repository der Distribution erscheint (z. B. `nginx`, `curl`, `htop`). Bei den übrigen Paketmanagern füllt der Katalog dieses Feld für dich aus

Modus „Alle veralteten aktualisieren“

Alle veralteten aktualisieren blendet die paketspezifischen Felder aus und aktualisiert veraltete Pakete unter Berücksichtigung der folgenden Ausschlüsse und des Mindestalters. Anzeigename und — bei winget und Chocolatey — Installieren für bleiben verfügbar. Lässt du den Anzeigenamen leer, benennt octoja den Eintrag nach dem gewählten Paketmanager.

Feld	Typ	Pflicht	Standard	Beschreibung
Diese Pakete nie aktualisieren	Paket-ID-Liste	Nein	Leer	winget/Chocolatey/APT; exakte IDs ohne Beachtung der Groß- und Kleinschreibung. Bei APT verwende die Paketnamen aus `apt list --upgradable`, nicht Anzeigenamen. Konfigurationspaket-Deployments erlauben höchstens 200 unterschiedliche Einträge.
Mindestalter für Updates (Tage)	Ganzzahl	Nein	0	Nur winget/Chocolatey; 0–365 Tage. 0 schaltet die Verzögerung aus. Unbekannte Datumswerte verhindern die Installation nicht.

Die Anleitung zum Zurückhalten von Software-Updates erklärt die unterschiedlichen Datumsquellen und den Geltungsbereich. APT unterstützt Ausschlüsse, aber kein Mindestalter; Homebrew unterstützt keines von beiden.

Unterstützte Paketmanager

Paketmanager	Plattform	Katalogquelle	Suche verfügbar
Chocolatey	Windows 7+	community.chocolatey.org	Ja — durchsucht das öffentliche Chocolatey-Community-Repository
winget	Windows 10 (1709+), Windows 11	Microsoft CDN package index	Ja — durchsucht den Microsoft winget-Paketindex
Homebrew	macOS	formulae.brew.sh	Ja — durchsucht sowohl den Homebrew-Formulae-Katalog (Befehlszeilentools) als auch den Cask-Katalog (grafische Anwendungen)
APT	Debian, Ubuntu	Distributions-Repositorys	Nein — den exakten Paketnamen manuell eingeben
Eigene	Windows	Deine eigenen veröffentlichten Pakete	Ja — filtert die auf deiner Instanz veröffentlichten eigenen Pakete

Chocolatey

Chocolatey ist ein Drittanbieter-Paketmanager für Windows. Software wird im Hintergrund über Pakete aus dem Chocolatey Community Repository installiert, das Tausende gängiger Anwendungen enthält. Für die meisten Pakete ist ein Versionsverlauf verfügbar.

winget

winget (Windows Package Manager) ist Microsofts integrierter Befehlszeilen-Installer, enthalten ab Windows 10 Version 1709. octoja verwendet die Community-Quelle winget, nicht msstore. Ein nicht erreichbarer Microsoft Store verhindert daher nicht die Verwaltung dieser Pakete; die Community-Quelle und die jeweiligen Download-Adressen müssen erreichbar bleiben.

Homebrew

Homebrew ist der Standard-Paketmanager für macOS. Befehlszeilentools werden aus dem Homebrew-Formulae-Katalog installiert, grafische macOS-Anwendungen — etwa Google Chrome, Slack und Visual Studio Code — aus dem Homebrew-Cask-Katalog. Casks erscheinen im Paketkatalog mit dem Badge Cask gekennzeichnet. In der Regel ist nur die neueste stabile Version verfügbar.

Wenn du ein Homebrew-Paket auf einem Mac verteilst, auf dem Homebrew nicht installiert ist, installiert der octoja-Agent zuerst Homebrew. Dieser automatische Bootstrap läuft auf Apple-Silicon-Macs (arm64); auf Intel-Macs muss Homebrew bereits installiert sein, bevor du Homebrew-Pakete zuweist. Vorhandene Homebrew-Installationen werden auf beiden Architekturen erkannt und genutzt.

APT

APT (Advanced Package Tool) ist der Paketmanager von Debian und Ubuntu Linux. Da keine öffentliche Such-API existiert, gib den exakten Paketnamen so ein, wie er im Repository der Distribution erscheint (z. B. nginx, postgresql, htop).

Verteilungszeitplan

Ein Konfigurationspaket trägt genau einen Verteilungszeitplan, den du auf seinem Tab „Software“ festlegst und der für alle Software-Deployments des Pakets gilt. Der Standard ist Kein Zeitplan festgelegt: octoja hält die Software fortlaufend aktuell und prüft sie alle paar Stunden erneut. Lege einen Zeitplan fest, um die Deployments stattdessen zu einer festen Zeit auszuführen.

Die Zeitplanauswahl baut den Zeitplan als Satz zusammen und speichert das Ergebnis als Cron-Ausdruck. Daneben zeigt eine Vorschau die nächsten fünf Ausführungen.

Option	Gespeichert als	Beispiel
täglich	`<Minute> <Stunde> * * *`	`0 3 * * *` — täglich um 03:00
alle paar Stunden	`0 /<n> * *`	`0 /6 * *` — alle 6 Stunden
an Werktagen	`<Minute> <Stunde> * * MON-FRI`	`0 6 * * MON-FRI` — montags bis freitags um 06:00
an bestimmten Tagen	`<Minute> <Stunde> * * <Tage>`	`0 2 * * MON,THU` — montags und donnerstags um 02:00
monatlich	`<Minute> <Stunde> <Tag> * *`, oder `L` / `L-<n>` für die letzten Tage des Monats, oder `<Tag>#<n>` / `<Tag>L` für eine Wochentagsposition	`0 3 1 * *` — am 1. jedes Monats um 03:00
bei Neustart	`@reboot`	Einmal bei jedem Gerätestart

Vorlagen decken die gängigen Fälle mit einem Klick ab — Jede Nacht um 03:00, An Werktagen um 06:00, Stündlich, Alle 6 Stunden, Montags um 02:00, Am 1. jedes Monats um 03:00, Am letzten Tag des Monats um 03:00, Beim System-Neustart und weitere.

Berechtigungen

Berechtigung	Erforderlich für
Monitoring-Check-Verwaltung (`monitoring-checks.manage`)	Konfigurationspakete öffnen und die darin enthaltenen Software-Deployments erstellen, bearbeiten oder entfernen — dieselbe Berechtigung deckt Konfigurationspakete und die Check-Zuweisung ab

Aktivitätsprotokollierung

Ergebnisse von Software-Deployments werden im Geräte-Aktivitätsprotokoll mit der Quelle Deployment (intern: SoftwareDeployment) erfasst.

Ein abgeschlossener Lauf von Alle veralteten aktualisieren hinterlässt auch dann einen Eintrag, wenn keine veralteten Pakete gefunden oder keine Versionen geändert wurden. Ein erfolgreicher Lauf bedeutet daher nicht zwingend, dass ein Update installiert wurde. Einzelpaket-Prüfungen ohne Änderung erzeugen dagegen keinen neuen Eintrag. Bei einer fehlgeschlagenen winget-Deinstallation prüfe die Fehlermeldung; der Auftrag gilt nur bei erfolgreichem Ergebnis des Paketmanagers als erfolgreich.

Siehe auch

Software auf Geräte verteilen — Schritt-für-Schritt-Anleitung, um ein Software-Deployment zu einem Konfigurationspaket hinzuzufügen.