Organisation von Rezepten

So organisieren Sie Rezepte mithilfe von Repositories und Katalogen in VergeOS, einschließlich Anleitungen zum Teilen von Rezepten mit Mandanten und entfernten Systemen.

Diese Seite behandelt Repositories und Kataloge, die Container, die zur Organisation von Mandanten- und VM-Rezepten verwendet werden. Anweisungen zum Teilen von Rezepten sind ebenfalls enthalten.

Repositories

Was ist ein Repository?

Ein Repository ist eine Site-Sammlung von Rezepten. Ein Repository kann mehrere Kataloge mit Rezepten enthalten.

• Lokale Repositories: Kataloge/Rezepte werden auf dem lokalen System erstellt und gepflegt.
• Remote-Repositories: Rezeptkataloge, die auf einem separaten VergeOS-System erstellt und gepflegt werden, werden zur Verwendung auf dem lokalen System abgerufen. Das Teilen über Remote-Repositories macht es überflüssig, dieselben Rezepte an mehreren Standorten zu verwalten.

Automatisch installierte Repositories

"MarketPlace" Host-Level-Systeme werden mit Marketplace, einem speziellen, entfernten, von VergeOS bereitgestellten Repository, das eine große Auswahl an Linux- und Windows-VM-Rezepten enthält, die sofort einsatzbereit sind. Standardmäßig werden die in Marketplace enthaltenen Rezeptkataloge auf scope="global" gesetzt, wodurch sie auch von allen Mandanten des Systems verwendet werden können.

"Lokal" Standardmäßig verfügt Ihr neues VergeOS-System über ein leeres lokales Repository namens "Lokal" das bereit ist, um neue Kataloge/Rezepte zu erstellen.

Kataloge

Was ist ein Katalog?

Kataloge ermöglichen es Ihnen, Ihre zusammengehörigen Rezepte innerhalb eines Repositories zu gruppieren. Beispielsweise kann ein Katalog verschiedene Windows-VM-Rezepte enthalten, während ein anderer alle Linux-basierten VM-Rezepte enthält. Administratoren können Kataloge so organisieren, wie es für ihre Organisation sinnvoll ist. Kataloge können so konfiguriert werden, dass sie privat sind oder mit Ihren Mandanten oder anderen externen VergeOS-Systemen geteilt werden.

Neuen Katalog erstellen

1. Navigieren Sie zu Repositories > Liste aus dem oberen Menü und doppelklicken Sie auf das Repository in dem der Katalog gespeichert werden soll. Dies muss ein lokales Repository sein; Remote-Repositories werden auf dem Remote-System verwaltet. (Das standardmäßige "Lokal" Repository, das in jedem neuen VergeOS-System/Mandanten erstellt wird, wird typischerweise verwendet.)
2. Klicken Sie auf Kataloge im linken Menü und klicken Sie dann auf Neu.
3. Geben Sie eine aussagekräftige Namen für den Katalog an. Optional können dem Beschreibungsfeld zusätzliche administrative Informationen hinzugefügt werden.
4. Wählen Sie einen Veröffentlichungsbereich um die Zugänglichkeit des Katalogs festzulegen:

   • Privat - nur für diese bestimmte VergeOS Cloud verfügbar.
   • Keine - deaktiviert, nirgends verfügbar
   • Mandant - für diese bestimmte Cloud und ihre eigenen Mandanten verfügbar
   • Global - für dieses bestimmte System, seine Mandanten und externe VergeOS-Systeme verfügbar (Benutzeranmeldedaten erforderlich)

Rezepte teilen

Kataloge mit Ihren Mandanten teilen

1. Setzen Sie den Veröffentlichungsbereich = 'Mandanten' (oder 'Global', was auch den Zugriff auf externe Systeme mit den entsprechenden Anmeldedaten ermöglicht).
2. Wechseln Sie zur UI des Mandanten für die restlichen Schritte.
3. Navigieren Sie zum Dienstanbieter Repository und klicken Sie auf Aktualisieren.
4. Doppelklicken Sie auf den gewünschten Katalog um die darin enthaltenen Rezepte anzuzeigen.
5. Klicken Sie auf VM-Rezepte -oder- Mandanten-Rezepte um die jeweilige Liste anzuzeigen.
6. Wählen Sie die gewünschten Rezepte aus.
7. Klicken Sie auf Herunterladen/Aktualisieren im linken Menü, um sie in die Mandantenumgebung herunterzuladen. Wenn ein Rezept den Status Online anzeigt, ist es verfügbar.

Wenn ein Rezept an der Quelle aktualisiert wird, wird in der UI des Mandanten eine Meldung angezeigt, dass ein Update zum Herunterladen verfügbar ist.

Kataloge an ein Remote-System teilen

Zugriff auf einen Katalog gewähren (Freigabeseite)

1. Erstellen Sie einen neuen Benutzer mit Typ: API der zur Authentifizierung durch das Remote-System/den Mandanten verwendet wird. Notieren Sie sich Benutzername und Passwort.
2. Navigieren Sie zum Katalog-Dashboard (Repositories > Catalogs > doppelklicken Sie auf den vorgesehenen Katalog).
3. Klicken Sie auf Berechtigungen im linken Menü.
4. Klicken Sie auf Benutzer hinzufügen im linken Menü.
5. Legen Sie die folgenden Felder für die neue Berechtigung fest:

   • Berechtigter: der oben erstellte API-Benutzer
   • Berechtigungen: Auflisten und Lesen
   • Typ: Kataloge
   • Name: Name des Katalogs, der geteilt wird
6. Klicken Sie auf Absenden um die neue Berechtigung zu speichern.

Mit einem Remote-Katalog verbinden (Empfängerseite):

1. Navigieren Sie zu Repositories > + Neues Repository.
2. Ausfüllen Felder für das neue Repository:

   • Namen: ein aussagekräftiger Name, der hilft, dieses Repository zu unterscheiden.
   • Beschreibung: (optional) hier eingegebene zusätzliche Informationen können für die spätere Verwaltung hilfreich sein.
   • Typ: Remote
   • URL: die IP- oder DNS-Adresse des Hostsystems, z. B. https://VergeOS.example.com
   • Benutzer/Passwort: verwenden Sie die Anmeldedaten des oben auf dem Host-System erstellten API-Benutzers.
   • Unsichere Zertifikate zulassen: diese Option dient dazu, ein selbstsigniertes Zertifikat innerhalb desselben privaten Netzwerks zu unterstützen; die Verwendung einer öffentlichen URL ohne sicheres SSL kann riskant sein und wird nicht empfohlen.
   • Max. schnellste Tier-Stufe: ermöglicht Ihnen, die beste Tier-Stufe für Rezept-Laufwerke festzulegen (z. B. hat ein Rezept auf dem Remote-System ein Laufwerk auf Tier 2; wenn diese Einstellung auf Tier 4 gesetzt ist, wird das Laufwerk beim Herunterladen auf Tier 4 verschoben.)
3. Klicken Sie auf Absenden um das neue Repository zu speichern.
4. Sobald erstellt, navigieren Sie zum Repository-Dashboard und klicken Sie auf Aktualisieren um seine Kataloge neu zu laden. Rezepte können lokal heruntergeladen werden und stehen dann beim Erstellen einer neuen VM/eines Mandanten zur Verfügung.

Wenn das Remote-System das Repository erstellt, das mit Ihrem System verbunden ist, hat es Zugriff auf alle Ihre Kataloge, für die der angegebene API-Benutzer Berechtigungen hat.

Wenn ein Rezept an der Quelle aktualisiert wird, wird in der UI des Remote-Systems eine Meldung angezeigt, dass ein Update zum Herunterladen verfügbar ist.