Erweiterung einer einsatzfähigen Architektur während des Onboarding

Wenn Sie eine einsatzfähige Architektur in einen privaten Katalog einbinden, können Sie sie durch Stapeln mit anderen Architekturen erweitern. Wenn Sie diese anderen Architekturen hinzufügen, geben Sie an, ob sie erforderlich sind, um Ihre Architektur wie vorgesehen einzusetzen, oder ob sie optional verwendet werden können, um den Anwendungsfall zu erweitern. Wenn Sie das Onboarding abgeschlossen haben, ist das Ergebnis eine robuste End-to-End-Lösung, die aus mehreren einsatzfähigen Architekturen besteht, die zusammenarbeiten.

Sind die einsatzfähigen Architekturen, die Sie zusammenstellen möchten, bereits in einem Katalog verfügbar? Wenn dies der Fall ist, können Sie diese Architekturen in einem Projekt stapeln und diese Lösung als separaten Katalogeintrag einbinden. Wenn Sie einsatzfähige Architekturen in einem Projekt stapeln, wird die Einbeziehung optionaler oder austauschbarer Architekturen derzeit nicht unterstützt. Dieser Ansatz funktioniert also am besten, wenn alle Architekturen, die Sie zusammenfügen möchten, für die Bereitstellung der End-to-End-Lösung erforderlich sind.

Warum eine verteilbare Architektur erweitern?

Sie können eine verteilbare Architektur aus verschiedenen Gründen erweitern. Wenn zum Beispiel die Architektur, die Sie einführen, eine Abhängigkeit erfordert, können Sie sie zusammen mit der Architektur, von der sie abhängt, stapeln. Wenn die Abhängigkeit als erforderlich aufgeführt ist, wird sie zusammen mit Ihrer bereitstellbaren Architektur einbezogen, wenn ein Benutzer sie konfiguriert und bereitstellt.

Um die standardmäßige Sicherheit einer einsatzfähigen Architektur zu fördern, die Sie einführen, können Sie andere Architekturen hinzufügen, die den Sicherheitsanforderungen entsprechen. Wenn die anderen einsatzfähigen Architekturen wie empfohlen einbezogen werden, kann sichergestellt werden, dass die Benutzer in Ihrem Unternehmen die Architektur auf eine bestimmte Art und Weise mit diesen Sicherheitsleitplanken einsetzen. Empfohlene Architekturen sind standardmäßig enthalten, können aber vom Benutzer entfernt werden.

Sie können eine einsatzfähige Architektur auch erweitern, um mehr Anpassungsoptionen für Benutzer bereitzustellen, damit diese die Vorteile eines erweiterten Anwendungsfalls nutzen können. Vielleicht lässt sich Ihre Architektur gut mit einer anderen einsatzfähigen Architektur kombinieren, die nicht benötigt wird, um eine Abhängigkeit zu erfüllen oder die Vorschriften einzuhalten. Sie können die verteilbare Architektur als optional hinzufügen, und die Benutzer können sich dafür entscheiden, sie einzubeziehen, wenn sie Ihre verteilbare Architektur zu einem Projekt hinzufügen.

Vorbereitende Schritte

Wenn Sie die Schritte zum Einbinden Ihrer verteilbaren Architektur in einen privaten Katalog abgeschlossen haben, werden Sie aufgefordert, die Versionsdetails zu konfigurieren. Gehen Sie zu Erweitern Sie Ihre Architektur, um andere einsatzfähige Architekturen zusammen mit derjenigen zu stapeln, die Sie gerade einführen.

Wenn Sie Ihre einsatzfähige Architektur bereits integriert haben, bearbeiten Sie die Version in Ihrem privaten Katalog und gehen Sie dann zu Architektur erweitern.

Sie bevorzugen die Arbeit mit Code? In der Manifestdatei des Katalogs können Sie Details zu anderen verteilbaren Architekturen angeben, die Sie mit der Architektur, die Sie einbinden möchten, kombinieren möchten. Legen Sie die Eigenschaft dependency_version_2 auf true fest und verwenden Sie das Array dependencies, um anzugeben, welche Architekturen Sie mit derjenigen, die Sie einbinden möchten, einschließen möchten. Weitere Informationen über die Strukturierung des Katalogmanifests finden Sie unter Lokale Bearbeitung der Manifestdatei.

Hinzufügen von einsatzfähigen Architekturen

Wenn Sie eine einsatzfähige Architektur einführen, können Sie sie durch Stapeln mit anderen Architekturen erweitern. Legen Sie eine Beziehung fest, wenn Sie andere Architekturen hinzufügen, und definieren Sie dann Variablen für die Benutzer, die sie über die Architekturen hinweg konfigurieren können, die Sie zusammen stapeln wollen. Führen Sie die folgenden Schritte aus:

Wenn Sie eine einsatzfähige Architektur in einen Katalog einbinden, klicken Sie im Abschnitt Architektur erweitern auf Hinzufügen.
Verwenden Sie das Menü Produkt, um die bereitstellbare Architektur auszuwählen, die Sie hinzufügen möchten. Sie können jede einsatzfähige Architektur auswählen, auf die Ihr Konto über Ihre Kataloge hinweg Zugriff hat.
Wählen Sie eine Beziehungsoption für die bereitzustellende Architektur, die Sie hinzufügen möchten. Die Architektur ist entweder erforderlich und kann nicht entfernt werden. Es ist optional und die Nutzer können wählen, ob sie es einschließen oder nicht. Oder es wird empfohlen und ist standardmäßig enthalten, aber die Benutzer können es auch entfernen. Weitere Informationen finden Sie unter Angeben einer Beziehung.
Optional: Wenn Sie zwei oder mehr einsatzfähige Architekturen hinzufügen, die je nach den Präferenzen des Benutzers austauschbar sind, wählen Sie sie in der Tabelle " Architektur erweitern" aus und klicken Sie auf Als austauschbar gruppieren. Die Benutzer können je nach ihren Bedürfnissen auswählen, welche Architektur sie verwenden möchten.
Wenn Sie mit dem Hinzufügen von einsatzfähigen Architekturen fertig sind, klicken Sie auf Weiter > Variablen definieren, um Variablen für Ihre Benutzer zu definieren. Von dort aus können Sie die einsatzfähigen Architekturen miteinander verbinden, damit die Benutzer die Eingaben über eine einzige Schnittstelle konfigurieren können, anstatt die Architekturen einzeln zu konfigurieren. Weitere Informationen finden Sie unter Definieren von Variablen für Ihre Benutzer.

Angeben einer Beziehung

Wenn Sie einsatzfähige Architekturen zusammen mit der Architektur, die Sie einführen, stapeln, werden Sie aufgefordert, eine Beziehung anzugeben. Wie ist die Beziehung zwischen der einsatzfähigen Architektur, die Sie hinzufügen, und der Gesamtlösung, die Sie in Ihren privaten Katalog einbinden? Sie können zwischen drei Optionen wählen: Erforderlich, Optional und Empfohlen. In der folgenden Tabelle wird beschrieben und erläutert, wie sich die einzelnen Optionen auf die Anpassung der End-to-End-Lösung auswirken, wenn ein Benutzer die Architektur einem Projekt aus dem privaten Katalog hinzufügt:

Beziehungsoptionen erklärt
Option	Beschreibung
Erforderlich	Wird aufgenommen, wenn ein Benutzer Ihre Architektur zu einem Projekt hinzufügt. Der Benutzer kann die erforderlichen Architekturen nicht entfernen, da sie für das bestimmungsgemäße Funktionieren Ihrer Gesamtlösung notwendig sind.
Optionale	Standardmäßig nicht enthalten. Benutzer können optionale Architekturen einbeziehen, wenn sie die Vorteile eines erweiterten Anwendungsfalls nutzen möchten.
Empfohlen	Standardmäßig enthalten, aber die Benutzer können sie auf Wunsch entfernen. Vielleicht möchten Sie beispielsweise sichere Bereitstellungen fördern, indem Sie IBM Cloud Secrets Manager als Empfehlung zu Ihrer bereitstellbaren Architektur hinzufügen. Secrets Manager ist dann standardmäßig enthalten, wenn ein Benutzer Ihre bereitstellbare Architektur zu einem Projekt hinzufügt. Wenn sie jedoch ein anderes Tool für die Verwaltung von Geheimnissen verwenden oder Secrets Manager nicht benötigen, kann der Benutzer es ausschließen.

Definieren von Variablen für Ihre Benutzer

Nachdem Sie Ihre einsatzfähige Architektur durch das Stapeln anderer Architekturen mit ihr erweitert haben, müssen Sie Variablen für Ihre Benutzer definieren. Ziel ist es, die einsatzfähigen Architekturen miteinander zu verknüpfen, damit die Benutzer die Eingaben über eine einzige Schnittstelle konfigurieren können, anstatt die Architekturen einzeln zu konfigurieren. Bedenken Sie dabei die folgenden Punkte:

Welche Eingaben innerhalb der einsatzfähigen Architekturen müssen die Benutzer konfigurieren? Diese Eingaben müssen zu Ihrem Produkt hinzugefügt werden, damit die Benutzer sie konfigurieren können, ohne die einzelnen Architekturen einzeln zu bearbeiten. Wählen Sie dazu Zum Produkt hinzufügen.
Welche einsatzfähigen Architekturen müssen mit Verweisen auf Eingänge oder Ausgänge verknüpft werden? Wenn z. B. eine Eingabe in einer Architektur von der Ausgabe einer anderen abhängt, fügen Sie eine Referenz in die Eingabe ein, um sie mit der Ausgabe zu verbinden. Wählen Sie dazu Reference a variable.

Nur Eingaben, die Sie zu Ihrem Produkt hinzufügen, können auf eine Ausgabe verweisen. Wenn Sie eine Architektur hinzugefügt haben und einer ihrer Eingänge auf einen Ausgang einer anderen Architektur verweisen muss, wählen Sie Für diesen Eingang Zum Produkt hinzufügen. Wählen Sie dann Variable referenzieren für die von Ihnen hinzugefügte Eingabe. Von dort aus können Sie die Architektur auswählen, die die Ausgabe enthält. Wählen Sie als Variablentyp Ausgabe und dann den Namen der Ausgabe, auf die die Eingabe verweisen soll.
Sind alle erforderlichen Eingaben für die Benutzer gelöst? Für erforderliche Eingaben, die dem Produkt nicht hinzugefügt werden, geben Sie einen festen Wert oder einen Verweis an, um diese Eingaben aufzulösen. Auf diese Weise werden die Architekturen innerhalb dieser End-to-End-Lösung miteinander verbunden, und die Benutzer können sie leichter konfigurieren und einsetzen.

In der Konsole können keine Standardwerte angegeben werden. Verwenden Sie die Eigenschaft default_value innerhalb des Arrays configuration in der Katalogmanifestdatei, um Standardwerte festzulegen. Weitere Informationen finden Sie unter Lokale Bearbeitung Ihrer Manifestdatei.
Benötigen Benutzer zusätzliche Informationen über eine Variable, um sie zu konfigurieren? Wenn Sie Ihrem Produkt eine Eingabevariable hinzufügen, können Sie die Art und Weise ändern, in der die Eingabe für die Benutzer angezeigt wird. Oft kann es sinnvoll sein, einen neuen Namen für eine Variable oder eine Beschreibung anzugeben, insbesondere wenn zwei ähnliche Variablen enthalten sind. Wenn die Architektur, die Sie einführen, beispielsweise eine region Eingabe enthält und Sie eine region Eingabe aus einer Infrastrukturarchitektur hinzufügen, sollten Sie die Eingabe region-infrastructure nennen, wenn Sie sie zu Ihrem Produkt hinzufügen. Ein aussagekräftiger Name hilft zu erkennen, wo der Eingang verwendet wird, und erleichtert die Konfiguration.

Alle Eingaben, die Sie zu Ihrem Produkt hinzugefügt haben, sind in der Tabelle der Eingabevariablen enthalten. Wenn Sie eine hinzugefügte Variable entfernen müssen, wählen Sie sie aus und klicken Sie auf Löschen.

Nächste Schritte

Nachdem die Variablen für Ihre Benutzer definiert sind, fahren Sie mit dem Onboarding Ihrer einsatzfähigen Architektur fort. Wenn Sie fertig sind, können Benutzer, die Zugriff auf Ihren privaten Katalog haben, Ihre einsatzfähige Architektur zu einem Projekt hinzufügen. Wenn sie dies tun, können sie es anpassen, indem sie auswählen, welche Architekturen sie einbeziehen möchten, basierend auf den Angaben, die Sie während des Einführungsprozesses gemacht haben.