Vorbereitende Schritte

Bevor Sie Ihre verteilbare Architektur in Betrieb nehmen können, müssen Sie die folgenden Voraussetzungen erfüllen.

• Herunterladen Visual Studio Code
• Stellen Sie sicher, dass Sie ein nutzungsabhängiges Konto oder ein Abonnementkonto nutzen. Weitere Informationen finden Sie unter Kontotyp anzeigen.
• Vergewissern Sie sich, dass Sie den erforderlichen Zugriff haben, um mit privaten Katalogen und einsatzfähigen Architekturen zu arbeiten.
  • Managerrolle im IBM Cloud Schematics Dienst
  • Bearbeiterrolle für den Katalogverwaltungsservice
  • Rolle eines Anzeigeberechtigten für alle Ressourcengruppen in Ihrem Konto
  • SecretsReader Rolle auf dem Secrets Manager Dienst, wenn Sie Ihre sicheren Werte in einer Instanz von Secrets Manager speichern wollen
  • Leserrolle im Workload Protection Dienst
  • Andere Rollen, die für bestimmte Ressourcen in Ihrer angepassten verteilbaren Architektur erforderlich sind.
• Stellen Sie sicher, dass Sie den Quellcode für Ihre einsatzfähige Architektur in einem GitHub gespeichert haben. Hilfe bei der Aufnahme Ihres Quellcodes in ein Repository finden Sie unter Einrichten eines Quellcode-Repositorys.
• Ein Terraform-Modul in einem öffentlichen oder privaten GitHub-Repository, das in einen lokalen Ordner geklont wird. Zum Experimentieren können Sie einen Fork dieses Beispiel-Terraform-Moduls erstellen. Wenn Ihr Repository privat ist, benötigen Sie ein persönliches Zugriffstoken mit den Berechtigungen repo und read:user.

Die VS Code-Erweiterung erhalten

Um die Erweiterung zu erhalten, öffnen Sie VS Code, gehen Sie zu Erweiterungen, suchen Sie nach und wählen Sie IBM Cloud Deployable Architecture Builder zum Herunterladen aus. Nachdem Sie das Programm heruntergeladen haben, können Sie der Anleitung folgen oder die folgenden Schritte ausführen. Wenn sich die Komplettlösung nicht automatisch öffnet, können Sie die Befehlspalette verwenden. Gehen Sie zu Ansicht > Befehlspalette. Suchen Sie nach Walkthrough, klicken Sie auf Willkommen: Komplettlösung öffnen..., dann wählen Sie Erste Schritte mit IBM Cloud Deployable Architecture Builder.

Onboarding Ihrer einsatzfähigen Architektur

Wenn Sie Ihre einsatzfähige Architektur zum ersten Mal validieren, durchlaufen Sie die Schritte zum Onboarding in IBM Cloud. Führen Sie die folgenden Schritte aus, um Ihre einsatzfähige Architektur einzubinden:

1. Melden Sie sich bei Ihrem IBM Cloud-Konto an.
   1. Um sich bei Ihrem Konto anzumelden, klicken Sie auf Ansicht und wählen Sie Befehlspalette.
   2. Suchen Sie im Suchfeld nach IBM Cloud - Log in.
   3. Wählen Sie IBM Cloud- Log in und melden Sie sich mit einem API-Schlüssel, einer föderierten ID oder einem Benutzernamen und einem Passwort an.
   4. (Optional) Sie können Ihre Anmeldeumgebung ändern. Klicken Sie auf Siehe, wählen Sie Befehlspalette, suchen Sie nach IBM Cloud - Log in, und wählen Sie IBM Cloud- Log in > Change login environment. Wählen Sie im Menü Produktion oder Staging.
2. Stellen Sie sicher, dass Sie über VS Code bei GitHub angemeldet sind.
   1. Wählen Sie das Symbol > Anmelden bei den Synchronisierungseinstellungen.
   2. Wählen Sie Ihr Konto aus.
   3. Klicken Sie auf Visual-Studio-Code autorisieren.
3. Klonen Sie Ihr Repo und fügen Sie es zu einem VS Code-Arbeitsbereich hinzu.
   1. Klonen Sie Ihr Repository für verteilbare Architekturen von GitHub.
   2. Um es zu Ihrem Arbeitsbereich in VS Code hinzuzufügen, klicken Sie auf Datei > Ordner zum Arbeitsbereich hinzufügen... und wählen Sie dann das Repo aus Ihren Dateien aus.
4. Fügen Sie die Katalogmanifestdateien zum Terraform-Modul hinzu.
   1. Um das Katalogmanifest hinzuzufügen, klicken Sie mit der rechten Maustaste auf den Modulordner in Ihrem Arbeitsbereich.
   2. Wählen Sie IBM Cloud > Manifestdateien der verteilbaren Architektur hinzufügen.
5. Einbindung und Validierung Ihrer einsatzfähigen Architektur.
   1. Klicken Sie mit der rechten Maustaste auf die ibm_catalog.json Datei, und wählen Sie IBM Cloud > Validieren Sie eine einsatzfähige Architektur auf IBM Cloud.
   2. Wählen Sie den Repositionszweig aus. Sie können auch auf + klicken und den Namen eines neu zu erstellenden Dokuments eingeben.
   3. Wählen Sie einen vorhandenen privaten Katalog aus. Sie können auch auf + klicken und den Namen eines neu zu erstellenden Dokuments eingeben.
   4. Geben Sie die Angebotsversion ein.
   5. Wählen Sie ein bestehendes Projekt aus. Sie können auch auf + klicken und den Namen eines neuen Eintrags eingeben, der dann für Sie erstellt wird.
   6. Geben Sie Ihren IBM Cloud API-Schlüssel für das Konto ein, für das die Ressourcen bereitgestellt werden sollen.
   7. Geben Sie den relativen Pfad für das Architekturdiagramm ein. Wenn Sie kein Diagramm haben, ist ein Platzhalter vorgesehen.
   8. (Optional) Wenn das GitHub-Repository privat oder in GitHub Enterprise ist, geben Sie Ihr persönliches Zugriffstoken ein.
   9. Die YAML-Eingabedatei wird geöffnet. Bearbeiten Sie die Werte unter der Eigenschaft inputs und speichern Sie die Datei.
   10. Weiter klicken

Wenn die Validierung beginnt, wird ein Ausgabekanal geöffnet, der die Validierungsprotokolle anzeigt. Wenn dies nicht der Fall ist, wählen Sie in der Ansicht " Ausgabe" den Kanal DA Validation aus dem Menü. Die Validierung kann einige Minuten dauern.