Implementierbare Architekturvarianten erstellen
Eine implementierbare Architektur kann Variationen von Funktionalität oder Komplexität enthalten. Sie können beispielsweise eine Variante für den Schnelleinstieg mit Basisfunktionen für eine einfache, kostengünstige Implementierung erstellen und dann eine Standardvariante mit einer komplexeren Architektur haben, die in der Produktion verwendet wird. Jede dieser Varianten ist selbst eine bereitstellbare Architektur, die integriert und so konfiguriert wird, dass sie als Optionen für dieselbe Kachel im Katalog angezeigt wird.
Wenn Sie in der ibm_catalog.json
-Katalogmanifestdatei arbeiten, werden variations
als flavors
bezeichnet. Auf der Seite mit den Katalogdetails werden sie jedoch als Varianten bezeichnet.
Die Variationen der Kernarchitektur variieren häufig in den folgenden Schlüsselbereichen:
- Kosten
- Compliance
- Komplexität in Zeit und Nutzung
- Sie stellt für einen bestimmten Anwendungsfall etwas anderes bereit, löst jedoch dasselbe allgemeine Geschäftsproblem.
Das folgende Beispiel zeigt eine implementierbare Architektur mit zwei Varianten im Katalog. Dies sind zwei Varianten, die dieselbe Quelle URL, denselben Produktnamen und dieselbe Version während der Aufnahme in den Katalog verwenden, um sicherzustellen, dass sie nebeneinander angezeigt werden, nachdem ein Benutzer die Katalogkachel ausgewählt hat:

Variante zu einer vorhandenen implementierbaren Architektur hinzufügen
Führen Sie die folgenden Schritte aus, um eine weitere Variante der bereits erstellten implementierbaren Architektur zu erstellen:
-
Erstellen Sie in Ihrem Quellcode-Repository ein Arbeitsverzeichnis und fügen Sie die erforderlichen Terraform-Dateien für eine bereitstellbare Architektur hinzu.
-
Fügen Sie in der Manifestdatei das folgende Code-Snippet im Abschnitt
flavors
hinzu. Dieses Array definiert das Angebot als Teil derselben implementierbaren Architektur, ermöglicht es jedoch, es als Variante im Katalog aufzuführen. Wenn Sie Ihr Manifest aus einer zuvor integrierten-Version im Katalog heruntergeladen haben, ist bereits eine Minimaldefinition für eine neue Variante vorhanden.Wenn Ihre implementierbare Architektur beispielsweise
Dinner
heißt und Sie eine Variante davon erstellen möchten, können Sie sie wie im folgenden Beispielsteak
nennen."flavors": [ { "label": "Steak", "name": "steak-variation", "working_directory": "./steak", "install_type": "fullstack" } ]
Die aktualisierte Katalogmanifestdatei, die Sie als Teil Ihres Release hochladen, füllt die meisten Konfigurationen für Ihre neue Variante automatisch aus. Es ist jedoch ein bewährtes Verfahren, die Konfiguration zu validieren, bevor Sie das Produkt für Ihre Organisation freigeben.
Sie können diese Schritte wiederholen, falls Sie weitere Varianten hinzufügen möchten. Wenn Sie fertig sind, können Sie Ihr Git-Release erstellen und mit dem Onboarding in einem privaten Katalog beginnen, um eine Katalogkachel zu erstellen, die Sie mit anderen gemeinsam nutzen können.
Hinzufügen einer Variante aus mehreren einsatzfähigen Architekturen
Wenn Sie in Ihrem Projekt Architekturen übereinandergelegt haben, können Sie diese Lösung als Variante in den Katalog aufnehmen. Wenn eine Schnellstartvariante einer einsatzfähigen Architektur einfach und kostengünstig ist, ist eine Lösung, die durch Stapeln erstellt wurde, in der Regel komplexer und erzeugt mehr Ressourcen als diese Schnellstartvariante.
Führen Sie die folgenden Schritte aus:
-
Stapeln Sie einsatzfähige Architekturen in einem Projekt. Weitere Informationen finden Sie unter Implementierbare Architekturen stapeln.
Konfigurieren Sie die Architekturen und stellen Sie sie bereit, um zu überprüfen, ob die Gesamtlösung wie geplant funktioniert, bevor Sie sie als Variante hinzufügen.
-
Definieren Sie die Variablen, die die Benutzer für eine erfolgreiche Bereitstellung konfigurieren müssen. Weitere Informationen finden Sie unter Stackvariablen definieren.
-
Erstellen Sie eine Stackdefinitionsdatei. Die Stack-Definition legt fest, wie sich die gestapelten einsatzfähigen Architekturen zueinander verhalten. Die Stapelvariablen, die Sie im vorherigen Schritt definiert haben, sind ebenfalls in Ihrer Stapeldefinitionsdatei enthalten.
-
Erstellen Sie in Ihrem Quellcode-Repository ein Arbeitsverzeichnis und fügen Sie die Datei
stack_definition.json
diesem Verzeichnis hinzu. Weitere Informationen finden Sie unter Quellenrepository erstellen. -
Fügen Sie in Ihrer Manifestdatei
ibm_catalog.json
das folgende Code-Snippet im Abschnittflavors
hinzu:Wenn Ihre einsatzfähige Architektur beispielsweise
Dinner
heißt und Sie eine Variation dieser Architektur erstellen möchten, könnten Sie sieSteak and potatoes with broccoli
nennen, wie im folgenden Beispiel gezeigt."flavors": [ { "label": "Steak and potatoes with broccoli", "name": "steak-potatoes-broccoli-variation", "working_directory": "./steak-potatoes-broccoli", "install_type": "fullstack" } ]
Falls noch nicht geschehen, erstellen Sie Ihr Git-Release und starten Sie das Onboarding in einem privaten Katalog, um eine Katalogkachel zu erstellen, die Sie mit anderen gemeinsam nutzen können.