Referenz für Software-Deployments

Konfigurationsfelder, Paketmanager und Zeitplansyntax für Software-Deployments

Geschrieben von Erdinc Akay

Zuletzt aktualisiert Vor 26 Tagen

Referenz für Software-Deployments

Diese Referenz beschreibt den aktuellen Stand, die Konfiguration und die Einschränkungen von 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

Die Wahl des Paketmanagers triffst du beim Hinzufügen des Deployments (über die Katalogauswahl oder durch Umschalten auf manuelle Eingabe); sie ist kein editierbares Feld auf dem Deployment-Formular selbst. Der Dialog „Software hinzufügen" 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
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. 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

Manueller Modus

Der manuelle Modus ersetzt den Anzeigenamen aus dem Katalog durch ein Paketname-Feld. Alle übrigen Felder (Version, Installationsverhalten, Installationsargumente, Installieren für, Im Software-Kiosk anzeigen) sind identisch mit dem Katalog-Modus.

Feld	Typ	Erforderlich	Standard	Beschreibung
Paketname	string	Ja	—	Der vom Paketmanager verwendete Bezeichner (z. B. `googlechrome` für Chocolatey, `Google.Chrome` für Winget, `nginx` für APT)

Modus „Alle veralteten aktualisieren"

Wenn du den Umschalter Alle veralteten aktualisieren (intern: UpdateAllOutdated) wählst, werden die paketspezifischen Felder ausgeblendet und der Agent aktualisiert jedes Paket, das der Paketmanager als veraltet meldet. Nur das Feld „Anzeigename" und — bei Chocolatey und winget — das Feld „Installieren für" bleiben anwendbar.

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, Linux	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
Custom	Beliebig (vom Betreiber definiert)	Vom Betreiber verwaltete benutzerdefinierte Pakete	Nein — aus den vom Administrator registrierten benutzerdefinierten Paketen auswählen

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. Software wird aus dem Microsoft Store und von Community-gepflegten Quellen installiert.

Homebrew

Homebrew ist der Standard-Paketmanager für macOS und ist auch unter Linux verfügbar. 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).

Zeitplansyntax

┌───────────── Minute (0–59)│ ┌───────────── Stunde (0–23)│ │ ┌───────────── Tag des Monats (1–31)│ │ │ ┌───────────── Monat (1–12)│ │ │ │ ┌───────────── Wochentag (0–6, wobei 0 = Sonntag)│ │ │ │ │* * * * *

Beispiel	Bedeutung
`@reboot`	Bei jedem Gerätestart
`/30 * * *`	Alle 30 Minuten
`0 2 * * *`	Täglich um 2:00 Uhr
`0 2 * * 1-5`	Werktags um 2:00 Uhr
`0 3 1 * *`	Am ersten Tag jedes Monats um 3:00 Uhr

Die octoja-Oberfläche bietet eine visuelle Zeitplanauswahl — du musst keine Cron-Ausdrücke manuell schreiben.

Berechtigungen

Berechtigung	Erforderlich für
Softwareverteilungs-Verwaltung (`software-deployments.manage`)	Erstellen, Bearbeiten und Entfernen von Software-Deployments in Konfigurationspaketen

Aktivitätsprotokollierung

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

Siehe auch

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