For the complete documentation index, see llms.txt. This page is also available as Markdown.

VM-Rezepte

So erstellen, konfigurieren und verwenden Sie VM-Rezepte in VergeOS für die schnelle Bereitstellung standardisierter virtueller Maschinen mit anpassbaren Fragen und Cloud-Init-Integration.

VM-Rezepte bieten eine leistungsstarke Möglichkeit, instanzspezifische virtuelle Maschinen schnell aus einer Standardkonfiguration bereitzustellen. Diese Seite führt Sie durch den Prozess des Erstellens und Verwendens von VM-Rezepten.

Was ist ein VM-Rezept?

VM-Rezepte sind anpassbare Vorlagen zum Starten neuer, eindeutiger virtueller Maschinen. Sie können anfängliche Hardwarespezifikationen, Zuordnungen zu Ressourcenpools und benutzerdefinierte Konfigurationsoptionen über einen beim Erstellen der VM angelegten Key-Value-Store enthalten. Ein Rezept kann zum Beispiel so konfiguriert werden, dass es zur Eingabe eines Datenbank-Benutzernamens und -Passworts auffordert oder eine bestimmte Gruppe von zu installierenden Paketen auswählt. Benutzer können Optionen direkt in der Benutzeroberfläche festlegen, wenn sie die neue VM-Instanz erstellen. Rezepte können außerdem zusammen mit der VergeOS-API genutzt werden, um benutzerdefinierte Benutzeroberflächen zu erstellen und Prozesse weiter zu straffen, indem sie in vorhandene Systeme integriert werden, z. B. Service-Portale.

Integration nach Industriestandard VergeOS unterstützt sowohl Cloud-Init (Linux) als auch Cloudbase-Init (Windows), um VMs beim ersten Start anzupassen. Dies kann Aufgaben wie das Einrichten von Benutzern, das Installieren von Paketen oder das Ausführen von Skripten umfassen. Rezepte können es Ihnen ermöglichen, cloud-init-/Cloudbase-Init-Implementierungen schnell bereitzustellen, indem sie die Benutzeroberfläche zum Erfassen von Eingaben bereitstellen und die zugehörigen Antwortdateien dynamisch erstellen. Siehe Erweiterte Verwendung unten für weitere Informationen.

Vorteile der Verwendung von VM-Rezepten

  • Schnelle Bereitstellung neuer virtueller Maschinen

  • Konsistenz über VM-Konfigurationen hinweg

  • Reduzierter manueller Einrichtungsaufwand

  • Anpassbar an spezifische Anwendungsanforderungen

Enthaltene VM-Rezepte

Ein VergeOS-System enthält automatisch das Repository des Dienstanbieters (Marketplace) bestehend aus VM-Rezepten, die sofort verwendet werden können, um neue virtuelle Maschinen vieler Typen zu erstellen. Die Liste dieser verfügbaren VM-Rezepte kann über Repositories > (doppelklicken) MarketPlace repository > VM Recipes.

marketplaceVMlisting

Sie können auf ein einzelnes VM-Rezept doppelklicken, um dessen Konfiguration anzuzeigen.

included-recipe-config

Ein neues VM-Rezept erstellen

Basiskonfiguration

  1. Eine VM erstellen als Basisschablone für das Rezept dienen. Die VM sollte generalisiert und für den Replikations-/Anpassungsprozess geeignet sein.

  2. Navigieren Sie im oberen Menü zu Virtuelle Maschinen > + Neues VM-Rezept.

Rezepte werden in Katalogengespeichert. Wenn Sie noch keinen lokalen Katalog erstellt haben, werden Sie aufgefordert, zuerst einen neuen zu erstellen.

  1. Rezeptfelder

    • Name: Verwenden Sie einen aussagekräftigen Namen, der das Rezept angemessen identifiziert und Benutzern hilft, geeignete Rezepte zu finden.

    • Beschreibung: (optional) Sie können hier zusätzliche Informationen zu diesem Rezept speichern. Dies kann ein guter Ort sein, um eine grundlegende Dokumentation zum vorgesehenen Zweck und zu allgemeinen Richtlinien bereitzustellen.

    • Symbol: (optional) ein Font-Awesome -Symbol kann dem Rezept zugeordnet werden. Symbole können Benutzern helfen, verschiedene Rezepte/Rezepttypen leicht zu erkennen.

    • Katalog: Wählen Sie einen Katalog aus, in dem das Rezept gespeichert werden soll. Kataloge helfen dabei, Rezepte übersichtlich zu organisieren.

    • Virtuelle Maschine: Wählen Sie eine Vorlagen-VM aus.

    • Version: Weisen Sie eine Versionsnummer zu. Dieses Feld wird bei jeder Änderung des Rezepts automatisch erhöht, um Änderungen nachzuverfolgen.

    Versionsnummerierung

    Eine Versionsnummer von 1.0.0 würde auf 1.0.0-1 und dann auf 1.0.0-2 usw. erhöht. Zusätzlich können Sie die Versionsnummer manuell bearbeiten, um größere Versionsänderungen widerzuspiegeln, z. B. die Version nach erheblichen Rezeptänderungen auf 2.0.0 zu ändern.

    • Asset für Fragenamen verwenden: Wenn aktiviert, basieren die Fragebezeichnungen für Laufwerke und NICs auf der zugewiesenen Asset-Nummer statt auf der Ordnungsnummer.

    • Versionsabhängigkeiten: (Nicht anwendbar für Rezepte, die nur auf dem lokalen System und dessen eigenen Mandanten verwendet werden.) Abhängigkeiten können angegeben werden, wenn für das ordnungsgemäße Funktionieren des Rezepts VergeOS-Funktionen erforderlich sind (damit ein entferntes System kein Rezept verwendet, das es nicht unterstützen kann).

  2. Klicken Sie auf Absenden um die Basiskonfiguration zu speichern. Das VM-Rezept-Dashboard zeigt an, wo Sie Ihre Abschnitte und Fragen konfigurieren können.

Fragen

Rezeptfragen werden verwendet, um Schlüsselwerte zu bestimmen. Wenn ein Rezept erstellt wird, werden einige Fragen automatisch hinzugefügt. Einige dieser Fragen sind standardmäßig deaktiviert und müssen aktiviert werden, wenn Sie sie verwenden möchten.

  1. (Optional) Standardmäßig deaktivierte Frage(n) aktivieren: Klicken Sie auf Fragen (linkes Menü oder Dashboard-Karte), wählen Sie die Frage(n) aus und klicken Sie im linken Menü auf Aktivieren.

  2. Um weitere Fragen zu konfigurieren, klicken Sie auf Fragen im linken Menü und dann Neu.

Fragenfelder:

  • Abschnitt: jede Frage gehört zu einem Abschnitt. Abschnitte ermöglichen es Ihnen, Ihre Fragen im Eingabeformular zu gruppieren. Einige Abschnitte werden automatisch erstellt. Optional können Sie neue Abschnitte für Ihre Fragen erstellen.

  • Name: dient als Variablenname, auf den in Skripten verwiesen werden kann; verwenden Sie einen aussagekräftigen Namen, um die Wartung und Fehlersuche im Skript zu erleichtern; nur alphanumerische Zeichen (keine Leerzeichen oder Sonderzeichen)

  • Typ: bestimmt, wie die Daten erfasst werden: über Benutzereingaben, Interaktion mit der VergeOS-Datenbank, Herunterladen von Cloud-Images usw.

  • Reihenfolge-ID: wird verwendet, um die Reihenfolge festzulegen, in der Fragen angezeigt werden (innerhalb des ausgewählten Abschnitts)

  • Anzeige: Text, der in der VergeOS-Benutzeroberfläche angezeigt wird, damit der Benutzer Rezeptfragen beantwortet

  • Standardwert: (optional) definiert einen anfänglichen Antwortwert für die Frage

  • Regex-Validierung: (optional) regulärer Ausdruck, der zur Validierung der Eingabe verwendet wird (Standard-Regex-Syntax)

  • Platzhaltertext: (optional) ausgegrauter Text, der als Beispiel für die erwartete Eingabe angezeigt wird

  • Tooltip-Text: (optional) Hilfetext für Benutzer, der in einem Popup angezeigt wird, wenn das Feld mit der Maus darübergefahren wird

  • Hinweistext: (optional) Hilfetext für Benutzer, der direkt unter dem Eingabefeld angezeigt wird, um zusätzliche Hinweise zu geben.

  • Bei Änderung: ermöglicht das Aus- und Einblenden anderer Fragen, wenn dieses Feld geändert wird. (Beispielcode wird in diesem Feld angezeigt, wenn eine neue Frage erstellt wird.)

    Zusätzliche Konfigurationsoptionen können je nach ausgewähltem Typ verfügbar sein.

Ein VM-Rezept simulieren

Sie können ein VM-Rezept simulieren, um es zu testen. Durch die Simulation des Rezepts können Sie das Benutzer-Eingabeformular anzeigen, die Feldvalidierung testen und Beispiel-Antwortdateien erstellen, um Ihre Konfiguration zu überprüfen. Sie können nur ein VM-Rezept simulieren, das in Ihrem lokalen Katalog veröffentlicht wurde. Bei Bedarf können Sie Marketplace-Rezepte im lokalen Katalog referenzieren und klonen.

  • Um einfach das Benutzer-Eingabeformular anzuzeigen: Klicken Sie im VM-Rezept-Dashboard auf Rezept simulieren im linken Menü.

  • Über das simulierte Eingabeformular können Sie die Feldvalidierung testen und Test-Antwortdateien erzeugen, indem Sie auf die Simulieren -Schaltfläche unten im Formular klicken. Eine Liste von Variablen-/Wertpaaren sowie eine Ausgabe der simulierten Ergebnisdateien wird angezeigt.

  • Um mit der Erstellung einer VM aus den Eingaben fortzufahren, klicken Sie auf die Schaltfläche Erstellen.

Ein VM-Rezept ändern

Wenn an einem Rezept Änderungen vorgenommen werden, muss es erneut veröffentlicht werden, damit diese Änderungen verfügbar werden. Oben im Rezept-Dashboard wird eine Meldung angezeigt, die darauf hinweist, dass das Rezept erneut veröffentlicht werden muss, damit die Änderungen wirksam werden. Sie können den Erneut veröffentlichen -Link in dieser Meldung verwenden oder im linken Menü auf Erneut veröffentlichen klicken.

Ein VM-Rezept verwenden

VM-Rezepte können verwendet werden, wenn eine neue virtuelle Maschine erstellt wird. Alle zugänglichen Kataloge (lokal und entfernt) werden links auf dem neuen VM-Bildschirm aufgelistet; wählen Sie einen Katalog aus, um die verfügbaren einzelnen Rezepte anzuzeigen.

Rezeptinstanzen

Eine Instanz bezeichnet eine virtuelle Maschine, die einem VM-Rezept zugeordnet ist. Wenn eine virtuelle Maschine mit einem Rezept erstellt wird, gilt sie als Instanz des Rezepts, bis sie gelöscht oder vom Rezept getrennt wird.

Klicken Sie auf Instanzen im linken Menü eines VM-Rezept-Dashboards, um schnell auf eine Liste der zugehörigen VMs zuzugreifen. Ein VM-Rezept kann nicht gelöscht werden, wenn zugehörige VM-Instanzen vorhanden sind.

Erweiterte Verwendung

Integration von Cloud-Init und Cloudbase-Init

Zur Verwendung mit einer VM-Vorlage:

  • Setzen Sie das Cloud-init-Datasource-Feld = Config Drive v2.

  • Installieren Sie Cloud-init und zugehörige Skripte innerhalb der VM-Vorlage.

Zur Verwendung mit einem Online-OS-Image: VergeOS-Rezepte ermöglichen es, die vielen vorinstallierten, cloud-init-fähigen OS-Images zu nutzen, die von den meisten Linux- und FreeBSD-Betriebssystemen zum Herunterladen angeboten werden. Um ein bestimmtes heruntergeladenes Image zu verwenden, können Sie eine Rezeptfrage wie folgt konfigurieren:

  • Name="OS_DL_URL"

  • Typ=Versteckt

  • Standardwert: die Download-URL (z. B. https://cloud-images.example.com/releases/jammy/release/ubuntu-22.04-server-cloudimg-amd64-disk-kvm.img, http://download.rockylinux.org/pub/rocky/8/images/x86_64/Rocky-8-GenericCloud.latest.x86_64.qcow2)

Um ein Cloud-Image über das Web zu streamen, können Sie eine Rezeptfrage wie folgt konfigurieren:

  • Name="OS_URL"

  • Typ=Versteckt

  • Standardwert: die Image-URL (z. B. https://cloud/debian.org/images/cloud/bullseye/latest/debian-11-generic-amd64.qcow2)

Referenzbeispiele: Marketplace-Rezepte bieten gute Beispiele für die Verwendung von cloud-init-/Cloudbase-Init-OS-Images in einem Rezept.

Die Integration mit Cloud-init/Cloudbase-Init ermöglicht viele Lösungen mit einer Vielzahl möglicher Ansätze. Wenden Sie sich an den VergeOS-Support, wenn Sie zusätzliche Unterstützung benötigen.

Zuletzt aktualisiert

War das hilfreich?