> 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/recipes-organization.md). # Rezeptorganisation 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. ```mermaid graph TD A["Repository"] --> B("Katalog 1") A --> C("Katalog 2") A --> D("Katalog 3") B --> E("VM-Rezept") B --> F("VM-Rezept") C --> G("Mandanten-Rezept") C --> H("Mandanten-Rezept") D --> I("VM-Rezept") D --> J("Mandanten-Rezept") D --> K("VM-Rezept") ``` * **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. {% hint style="info" %} **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.** {% endhint %} ### 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. {% hint style="info" %} **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.** {% endhint %} {% hint style="info" %} **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.** {% endhint %} --- # 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/recipes-organization.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.