> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/automate-protect-and-extend/de/automatisierung/vm-recipes.md). # VM-Rezepte 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](#advanced-usage) 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](/files/efdd497d3b290abe5536affd4adca4c92a7a0ebc) Sie können auf ein einzelnes VM-Rezept doppelklicken, um dessen Konfiguration anzuzeigen. ![included-recipe-config](/files/c7d19cbabf8eb7a20d225d49ee906581e9251237) ## 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**. {% hint style="info" %} **Rezepte werden in** [**Katalogen**](/automate-protect-and-extend/de/automatisierung/recipes-organization.md#catalogs)**gespeichert. Wenn Sie noch keinen lokalen Katalog erstellt haben, werden Sie aufgefordert, zuerst einen neuen zu erstellen.** {% endhint %} 3. **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.

Wenn ein Rezept auf einer virtuellen Maschine basiert, werden Laufwerksfragen automatisch für jedes Laufwerk der VM erstellt, z. B. YB_DRIVE_1_SIZE, YB_DRIVE_3_NONPERSISTENT, YB_DRIVE_2_SERIAL usw.

* **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). 4. 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. {% hint style="success" %} **Wenn Sie Änderungen vornehmen und ein Rezept erneut veröffentlichen, werden entfernte Systeme und Mandanten darüber benachrichtigt, dass ein Update verfügbar ist (Benachrichtigung oben im VM-Rezept-Dashboard und Kontrollkästchen „Update verfügbar“); sie müssen das Rezept aktualisieren, um auf die Änderungen zuzugreifen.** {% endhint %} ## 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](#included-vm-recipes) 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/automate-protect-and-extend/de/automatisierung/vm-recipes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.