Native Choco Runtime

Der Native Choco Runtime ist die eigene im Prozess ausgeführte Paketinstallations-Engine von RealmJoin, die die veraltete Chocolatey-0.10.3-Binärdatei ersetzt und dabei vollständig mit bestehenden Paketen kompatibel bleibt.

Der Native Choco Runtime wurde eingeführt mit RealmJoin Agent 4.21.6 (Beta). Die Funktion ist optional: Bestehende Clients verwenden weiterhin die klassische Chocolatey-Engine, bis Sie die native Runtime ausdrücklich aktivieren.

Was es ist

Wenn der RealmJoin Agent Softwarepakete außerhalb von Intune installiert (siehe Paketinstallation), hat er traditionell auf Chocolatey als zugrunde liegende Paket-Engine zurückgegriffen. RealmJoin lieferte einen fest gepinnten, stark gepatchten Build der Open-Source-Chocolatey-CLI — Version 0.10.3 — gebündelt als choco.exe unter C:\ProgramData\chocolatey\.

Die Native Choco Runtime ersetzt diese gebündelte Chocolatey-Binärdatei durch RealmJoins eigene, speziell dafür entwickelte Implementierung die im Prozess innerhalb des RealmJoin-Dienstes ausgeführt wird. Sie bildet Chocolatey nach: Es versteht dasselbe Paketformat (.nupkg) und verhält sich aus Sicht eines Paketautors und Administrators genauso, hängt aber nicht mehr von der gealterten Chocolatey-0.10.3-Codebasis ab.

Mit anderen Worten: Die Pakete, die Sie bereits verwenden, funktionieren unverändert weiter — nur die Engine darunter ändert sich.

So funktioniert es

• In-Process-Engine. Paketinstallationen laufen innerhalb des RealmJoin-Dienstes, anstatt einen externen choco.exe. Die chocolateyInstall.ps1 jedes Pakets wird in einem in-process PowerShell-Runspace ausgeführt.
• Isolierter Speicher. Die native Runtime installiert in ihr eigenes Root, C:\ProgramData\RealmJoin\choco\ (mit lib\, extensions\, und logs\ Unterordnern). Sie schreibt niemals in den Zustand des klassischen Chocolatey unter C:\ProgramData\chocolatey\ und ändert niemals die systemweite ChocolateyInstall Umgebungsvariable. Das bedeutet, dass die native Runtime und ein bereits vorhandenes klassisches Chocolatey nebeneinander existieren auf demselben Gerät.
• Automatische Auflösung von Abhängigkeiten. Paketabhängigkeiten, die in der .nuspec (wie die RealmJoin Core Choco-Erweiterung) werden automatisch aus Ihren konfigurierten Quellen aufgelöst und installiert.
• choco.exe Shim. Einige Paketskripte rufen choco.exe direkt auf. Damit diese weiterhin funktionieren, stellt die Runtime einen kleinen Shim unter %ProgramFiles%\RealmJoin\choco-shim\choco.exe bereit, der solche Aufrufe zurück in die In-Process-Engine leitet statt zu klassischem Chocolatey. Der Shim wird nicht dem System PATHhinzugefügt; er steht Paketskripten nur während ihrer Laufzeit zur Verfügung.

Kompatibilität

Die Native Choco Runtime ist als Drop-in-Ersatz:

• Bestehende RealmJoin-Pakete (einschließlich allem aus dem Paket-Store) werden auf die gleiche Weise installiert und deinstalliert.
• Die im RealmJoin-Portal konfigurierten Paketargumente / Parameter funktionieren weiterhin.
• Die RealmJoin Core Choco-Erweiterung Hilfs-Cmdlets, die in Paketskripten verwendet werden, bleiben verfügbar.
• RealmJoin ESP / Autopilot werden unterstützt: auf einem frischen Gerät mit aktivierter nativer Runtime, winchoco Pakete werden während der Registrierung nativ installiert, wobei ihre Abhängigkeiten automatisch aufgelöst werden.

Da diese Runtime in Beta ist, empfehlen wir, Ihre wichtigsten Pakete zunächst in einem Pilot-Ring zu validieren, bevor Sie sie tenant-weit ausrollen. Bitte melden Sie alle Verhaltensunterschiede an den RealmJoin Support, damit wir sie vor der allgemeinen Verfügbarkeit beheben können.

Wie man es verwendet

Die Runtime wird über eine RealmJoin Einstellungausgewählt, sodass Sie sie zentral steuern können, anstatt einzelne Clients anzufassen. RealmJoin-Einstellungen vererben sich, was bedeutet, dass Sie eine mandantenweite Standardvorgabe und bei Bedarf für bestimmte Gruppen überschreiben (und die darin enthaltenen Objekte).

Einstellungs-Schlüssel: Chocolatey.UseNativeRuntime

Einstellungswert: true / false

Die folgenden Einstellungen steuern das Verhalten:

Einstellung	Standard	Bedeutung
Chocolatey.Enabled	false	RealmJoin verwaltet auf dem Gerät Pakete vom Typ Chocolatey.
Chocolatey.UseNativeRuntime	false	Hauptschalter. Wenn falseUseNativeRuntime = false choco.exe. Wenn trueUseNativeRuntime = true winchoco Installationen über die in-process native Runtime.
Chocolatey.DisableShim	false	Nur relevant, wenn UseNativeRuntime = true. Wenn true, schlägt jedes Paketskript, das ein externes choco.exe aufruft, laut fehl, statt über den Shim weitergeleitet zu werden — nützlich, um Skripte sichtbar zu machen, die noch ein externes Binary verwenden.

1

Aktivieren Sie es zunächst für eine Pilotgruppe

Öffnen Sie die Einstellungen einer RealmJoin Gruppe Gruppe, die eine kleine Menge an Pilotgeräten enthält, und setzen Sie Chocolatey.UseNativeRuntime zu true Chocolatey.UseNativeRuntime = true

2

Validieren Sie Ihre Pakete

Lassen Sie die Pilotgeräte ihre normalen Paketzuteilungen und Upgrades ausführen. Bestätigen Sie, dass Installationen erfolgreich sind, und prüfen Sie die Logs, wenn etwas ungewöhnlich aussieht (siehe Probleme bei der Paketinstallation).

3

Rollen Sie es tenant-weit aus

Wenn Sie sicher sind, setzen Sie Chocolatey.UseNativeRuntime zu true da die mandantenweite Standardvorgabe Chocolatey.UseNativeRuntime = true

Die Konfiguration folgt demselben Modell aus Mandanten-Einstellung / Gruppenüberschreibung wie die anderen Agenteneinstellungen, die unter Allgemeine Einstellungen (zum Beispiel die Client-Konfiguration und LAPS-Konfiguration Mandanteneinstellungen).

Was ist der Standard

Native Choco Runtime ist standardmäßig deaktiviert (Chocolatey.UseNativeRuntime = false). Clients verwenden weiterhin die klassische, gebündelte Chocolatey-0.10.3-Engine, bis ein Administrator die native Runtime aktiviert — entweder mandantenweit oder für eine bestimmte Gruppe. So können Sie die neue Runtime in Ihrem eigenen Tempo einführen und genauso leicht wieder zurückrollen, solange die Funktion noch in Beta ist.

Vorhandene Geräte migrieren

Die native Runtime und das klassische Chocolatey nebeneinander existieren auf einem Gerät so lange wie nötig nebeneinander bestehen. Wenn Sie die native Runtime auf einem Gerät aktivieren, auf dem bereits klassische Chocolatey-Installationspakete vorhanden sind:

• Bestehende, von RealmJoin verwaltete Pakete funktionieren weiterhin und werden nicht nicht neu installiert, nur weil sich die Runtime geändert hat — ihr installierter Zustand bleibt über den Wechsel hinweg erhalten, sodass es keinen Neuinstallationssturm gibt.
• Neue Installationen und Upgrades laufen über die native Runtime; die klassische Installation bleibt unangetastet auf der Festplatte, bis sie ausdrücklich entfernt wird.

Die flächendeckende Entfernung von klassischem Chocolatey ist als separater, orchestrierter Schritt geplant. Bis dahin kann die native Runtime problemlos mit einer zurückgebliebenen klassischen Installation koexistieren, sodass es keine harte Frist gibt, sie aufzuräumen.

Für ein einzelnes Gerät (zum Beispiel während Support oder QA) kann ein Administrator eine Maschine mit dem migrieren Sie Befehl erhöhten Shell:

# Vorschau darauf, was passieren würde, ohne Änderungen vorzunehmen
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --dry-run

# Zustandsbehaftete Pakete über die native Runtime neu installieren, dann das klassische entfernen
& "C:\Program Files\RealmJoin\choco-shim\choco.exe" migrate --yes

choco migrate ist ein Admin-Helfer für ein einzelnes Gerät (Support, Dev/QA, einmalige Bereinigung). Es ist nicht nicht der Mechanismus, um die Änderung über einen gesamten Gerätebestand auszurollen — verwenden Sie dafür die Mandanten-/Gruppeneinstellungen.

Protokolle & Fehlerbehebung

Native-Runtime-Installationen schreiben ein Pro-Paket-Protokoll nach:

C:\ProgramData\RealmJoin\choco\logs\<package-id>\<timestamp>_<version>_<operation>.log

(auf die 10 neuesten Einträge pro Paket begrenzt). Das ist getrennt vom klassischen Chocolatey C:\ProgramData\chocolatey\logs\. Wenn Sie für eine Supportanfrage Protokolle sammeln, fügen Sie den C:\ProgramData\RealmJoin\ Ordner wie unter Probleme bei der Paketinstallation.

Datei- & Pfadreferenz

Pfad	Zweck
C:\ProgramData\RealmJoin\choco\lib\<id>	Installationsstamm des Native-Runtime-Pakets.
C:\ProgramData\RealmJoin\choco\extensions\<id>	Automatisch importierte PowerShell-Hilfsmodule.
C:\ProgramData\RealmJoin\choco\logs\<id>	Pro-Installation-Protokolle (je Paket die letzten 10).
C:\Program Files\RealmJoin\choco-shim\choco.exe	Die choco.exe Shim.