Ressourcen aus einem Schematics-Arbeitsbereich in ein Projekt verschieben

Sie können den Lebenszyklus einer Unternehmensarchitektur verwalten, indem Sie Ressourcen aus einem IBM Cloud® Schematics-Arbeitsbereich in ein IBM Cloud®-Projekt verschieben. Während Sie einen Schematics-Arbeitsbereich für die Verwendung von Terraform-Architekturen und bereitstellbaren Architekturen verwenden, können Sie ein Projekt verwenden, um den gesamten Lebenszyklus im richtigen Maß zu verwalten. Nachdem Sie diese Aufgabe ausgeführt haben, haben Sie eine Kachel für eine bereitstellbare Architektur in Ihrem privaten Katalog und können den Lebenszyklus Ihrer bereitstellbaren Architektur von einem Projekt aus verwalten.

Während dieses Prozesses können Sie mithilfe der CLI-Befehle ibmcloud catalog utility create-product-from-workspace und ibmcloud project config-create einen Katalog und ein Projekt erstellen, die miteinander verknüpft sind, und dann die Schematics-Arbeitsbereichsressourcen in das Projekt verschieben.

Beobachten und erlernen Sie den Prozess zum Verschieben implementierter Ressourcen in ein Projekt.

Lernvideo

Videomitschrift

Ich bin Gili Mendel, ein STSM mit dem IBM Cloud-Entwicklungsteam. Ich werde Ihnen zeigen, wie Sie einen Schematics-Arbeitsbereich in die IBM Cloud implementierbare Architektur oder ein Projekt verschieben.

Ein Schematics-Arbeitsbereich ist die Art und Weise, wie Sie eine Terraform-Automatisierung auf dem IBM Cloudausführen. Der Arbeitsbereich enthält einen Link zu einem Git-Repository, aus dem die Terraform-Vorlage abgerufen wird. Sie enthält auch die Schablonenvariable und den Ressourcenstatus, wenn sie erstellt wird.

Es ist eine großartige Möglichkeit, die Terraform- IaaS-Automatisierung in der Cloud auszuführen, ohne ein hoch verfügbares IBM Cloud® Object Storage-Bucket für den Status mit den intimen Integrationen in Cloudressourcenprovider zu verwalten.

Dieser Ansatz wird jedoch nicht skaliert, wenn Sie mehrere Automatisierungen steuern. Die Verwaltung der Ressourcen und das Rollout einer neuen Version der Vorlage kann eine schwierige Aufgabe sein.

Obwohl ein Unternehmen die Terraform-Automatisierung nutzt, dreht sich alles um bereitstellbare Architekturen. Sie veröffentlichen eine Referenzarchitektur mit einem Konformitätsspeicherbedarf, Kostenvoranschlägen und einer Terraform-Vorlage, die die Bereitstellung der Architektur automatisiert.

Das Repository Git wird verwendet, um die Architektur und ihre Automatisierungen zu iterieren und zu erstellen. Es kann für Benutzer, die die Architektur implementieren, sichtbar sein. Die Architektur selbst hat einen Lebenszyklus, der Versionsupgrades enthält.

Schritt 1: Verwenden Sie die Befehlszeilenschnittstelle für das Katalogmanagement, um eine implementierbare Architektur aus dem vorhandenen Arbeitsbereich und dem Lebenszyklus zu erstellen, der zum Veröffentlichen der neuen Versionen für den Arbeitsbereich erforderlich ist.

Schritt 2: Verwenden Sie die Projekt-CLI, um den Arbeitsbereich so zu ändern, dass er von einem Projekt als implementierbare Architektur verwaltet wird. Daher können diese Ressourcen als einzelne implementierbare Architekturversionskonfiguration behandelt und über ein Administratorkonto in vielen Umgebungen verwaltet werden. Die Versionsmigration, die Kosten und der Konformitätsbedarf sind einfacher und beziehen die bereitgestellte Architektur mit ein.

Vorbereitende Schritte

Stellen Sie sicher, dass der IBM Cloud® Schematics-Arbeitsbereich erstellt und die Ressourcen in Ihrem Account bereitgestellt werden. Das Projekt und der Arbeitsbereich müssen sich in demselben Account befinden.
Setzen Sie eine GIT_TOKEN-Umgebungsvariable, um sich mit Ihrem Git Quellcode-Repository zu authentifizieren. Führen Sie beispielsweise export GIT_TOKEN="enter your GIT TOKEN" aus. Das Token benötigt die Berechtigung, diese Git bezogenen Aufgaben abzuschließen, wenn Sie bereitgestellte Ressourcen in Ihr Projekt verschieben.
Richten Sie eine Authentifizierungsmethode ein, um das Projekt mit dem Katalog zu verbinden. Sie können eine der folgenden Methoden verwenden:
- Legen Sie die Umgebungsvariable IC_API_KEY fest, um auf Ihr IBM Cloud-Konto zuzugreifen. Führen Sie beispielsweise IC_API_KEY="Your API key" aus.
- Verwenden Sie Ihre trusted-profile-id-Details für den Zugriff auf Ihr IBM Cloud-Konto. Weitere Informationen finden Sie unter ID des vertrauenswürdigen Profils suchen. Eine vertrauenswürdige Profil-ID könnte beispielsweise ähnlich wie Profile-1bd5eala-000-4a6666-00000 aussehen.
Stellen Sie sicher, dass die Projekt-und Katalogmanagement-CLI-Plug-ins aktuell sind. Führen Sie den Befehl ibmcloud plugin list aus, um die aktuelle Version der CLI-Plug-ins anzuzeigen.
Erstellen Sie ein Projekt für die Produktionsbereitstellung und notieren Sie den Namen und die ID des Projekts, in das Sie die Ressourcen verschieben möchten.
Stellen Sie sicher, dass der Projektservice in Ihrem Konto berechtigt ist, mit anderen IBM Cloud-Services zu kommunizieren. Weitere Informationen finden Sie unter Zugriff zwischen dem Projektservice und anderen IBM Cloud-Services erteilen.

Erstellen einer implementierbaren Architektur aus dem Arbeitsbereich Schematics

Überspringen Sie diesen Abschnitt, wenn Sie bereits über eine bereitstellbare Architektur in Ihrem Arbeitsbereich von Schematics verfügen.

Wenn Sie Software mithilfe eines Schematics-Arbeitsbereichs oder über einen privaten Katalog implementiert haben, können Sie die bereitgestellten Ressourcen mithilfe des Befehls ibmcloud catalog utility create-product-from-workspace in ein Projekt verschieben.

Der Befehl führt die folgenden Tasks im Zusammenhang mit Gitaus:

Klont das implementierbare Architekturrepository.
Überträgt die Manifestdatei ibm_catalog.json mit Push-Operation an eine neue Verzweigung.
Erstellt ein Platzhalterarchitekturdiagramm (architecture-diagram-placeholder.drawio.svg)
Erstellt ein Git-Release im Repository.
Stellt das Freigabe-Asset URL zur Verfügung.

Der Befehl führt auch die folgenden IBM Cloud-bezogenen Aufgaben aus:

Erstellt einen privaten Katalog in IBM Cloud
Erstellt ein Projekt, in dem Sie Entwicklung und Tests durchführen.
Verknüpft das Projekt und den Katalog mithilfe einer vertrauenswürdigen Profil-ID oder einem API-Schlüssel.
Erstellt die Produktkachel im privaten Katalog.
Führt das Onboard der Produktversion in den neuen privaten Katalog durch.
Markiert die Version als zur gemeinsamen Nutzung bereit.
Schließt das Onboarding des Arbeitsbereichs und der implementierbaren Architektur durch Verschieben des Arbeitsbereichs in den Katalog ab.
Zeigt die Projekt-ID, die Katalog-ID, die Angebots-ID und den Versionslocator an.

Führen Sie die folgenden Schritte aus, um eine implementierbare Architektur zu erstellen und alle implementierten Ressourcen in eine Projektkonfiguration zu verschieben:

Führen Sie den Befehl ibmcloud catalog utility create-product-from-workspace aus.
```
ibmcloud catalog utility create-product-from-workspace [--workspace-id ID] [--api-key KEY] [--trusted-profile-id ID] [--catalog-label LABEL] [--offering-label LABEL] [--project-name NAME] [--project-resource-group GROUP] [--target-version VERSION] [--variation-label LABEL]
```
--api-key und --trusted-profile-id schließen sich gegenseitig aus. Sie benötigen nur den einen oder den anderen. Der Parameter --project-name erstellt das Projekt, in dem Sie die Entwicklung und Tests durchführen. Aus Gründen der Einfachheit kann es sinnvoll sein, den Namen mit Ihrer Arbeitsbereichs-ID zu benennen.

Siehe das folgende Beispiel für die Optionen des Befehls utility create-product-from-workspace.
```
ibmcloud catalog utility create-product-from-workspace --workspace-id us-south.workspace.move.xxxx --api-key $IC_API_KEY --catalog-label myCatalog --offering-label myOffering --project-name myProject --project-resource-group Default --target-version 1.0.0 --variation-label test_standard
```
Wenn die Ausführung des Befehls abgeschlossen ist, gibt die Eingabeaufforderung OK zurück.
Überprüfen Sie die Ergebnisse in Git, indem Sie das Commit, das Repository und das neue Release anzeigen. Sie können die Datei .tgz mit den Versionen anzeigen.
Überprüfen Sie die Ergebnisse in der IBM Cloud-Konsole:
1. Rufen Sie Verwalten > Kataloge > Private Kataloge auf.
2. Wählen Sie den neuen privaten Katalog aus.
3. Wählen Sie das neue Produkt in Ihrem privaten Katalog und anschließend die Registerkarte Versionen aus. Stellen Sie sicher, dass Sie Version 1.0.0 (oder eine ähnliche Version) Ihrer implementierbaren Architektur haben. Wenn Sie Ihren privaten Katalog aufrufen, sehen Sie dieselbe bereitstellbare Architektur in einer Kachel.
4. Klicken Sie auf das Symbol Navigationsmenü > Projekte und sehen Sie sich das neue Projekt an.
5. Wählen Sie die Registerkarte Konfigurationen aus, um die implementierbare Architektur anzuzeigen. Sehen Sie, dass er sich im draft-Status befindet.

Projektkonfiguration erstellen

Der Befehl ibmcloud project config-create erstellt eine Projektkonfiguration, die den Arbeitsbereich Schematics unter einem Projekt ausführt, in dem Sie dann eine weitere Version aus dem Projekt erstellen und die implementierbare Architektur nach Bedarf ändern können.

Bevor Sie mit diesem Abschnitt beginnen, müssen Sie sicherstellen, dass Sie über eine implementierbare Architektur in einem privaten Katalog und einem aktiven Schematics-Arbeitsbereich verfügen und den zugehörigen CRN kennen. Sie können den CRN des Arbeitsbereichs entweder über die Ressourcenliste in der IBM Cloud-Konsole oder über die Befehlszeilenschnittstelle suchen.

IBM Cloud-Konsole: Klicken Sie in der IBM Cloud-Konsole auf das Symbol Navigationsmenü > Ressourcenliste > Entwicklertools > Suchen Sie den Arbeitsbereich und kopieren Sie den CRN.
IBM Cloud-CLI: Führen Sie den Befehl ibmcloud schematics workspace get aus, um die CRN-Details des Arbeitsbereichs abzurufen. Führen Sie beispielsweise ibmcloud schematics workspace get --id workspace-id --output destination folder --json output.json aus, um die CRN-Details für den Arbeitsbereich Schematics abzurufen.

Gehen Sie wie folgt vor, um eine Projektkonfiguration hinzuzufügen und die Schematics-Arbeitsbereichsressourcen in das Projekt zu verschieben:

Führen Sie den Befehl ibmcloud project config-create aus.
```
ibmcloud project config-create --project-id PROJECT-ID [--schematics-workspace-crn SCHEMATICS-WORKSPACE-CRN] [--definition-name DEFINITION-NAME] [--definition-locator-id DEFINITION-LOCATOR-ID]
```
Der Wert für --project-id ist die ID des Projekts, das Sie im Schritt "Bevor Sie beginnen" für Ihre Produktionsbereitstellung erstellt haben. Der Wert für --definition-locator-id ist derselbe wie der Versionslokator aus dem vorherigen Abschnitt.

Sehen Sie sich das folgende Beispiel für project config-create-Befehlsoptionen an.
```
ibmcloud project config-create --project-id myProdProject --schematics-workspace-crn MyWorkspaceCRN --definition-name production-deployment --definition-locator-id myVersionLocator
```
Wenn die Ausführung des Befehls abgeschlossen ist, gibt die Eingabeaufforderung den Namen, den Status und den Typ zurück.
Stellen Sie sicher, dass Ihre Terraform-Vorlagen in Ihrem Projekt bereitgestellt werden:
1. Klicken Sie in der Konsole IBM Cloud auf das Symbol Navigationsmenü > Projekte.
2. Wählen Sie Ihr Projekt aus, das Sie zuerst für die Produktion der Implementierung erstellt haben, und wechseln Sie zur Registerkarte Konfigurationen.
3. Klicken Sie auf das Symbol Aktionen > Letzte Implementierung anzeigen.
4. Klicken Sie im Abschnitt "Implementierung erfolgreich" auf Änderungen erfolgreich implementiert > Protokolle, um alle implementierten Ressourcen im Projekt anzuzeigen.

Die Schematics-Arbeitsbereichsbereitstellung ist jetzt in den Protokollen enthalten, die sich innerhalb des neuen Projekts befinden.

Wenn Sie die Ergebnisse mithilfe der Befehlszeilenschnittstelle (CLI) überprüfen möchten, führen Sie den Befehl ibmcloud project get oder ibmcloud project list aus, um zu überprüfen, ob Ihr Arbeitsbereich erfolgreich in Ihr Projekt verschoben wurde.

Nächste Schritte

Führen Sie die folgenden Schritte aus, um den Rest des Prozesses für die implementierbare Architektur abzuschließen:

Konfigurieren Sie Bereitstellungsdetails für die implementierbare Architektur.
Definieren Sie den IAM-Zugriff.
Fügen Sie ein Architekturdiagramm, Voraussetzungen und Hervorhebungen hinzu.
Fügen Sie Konformitätsinformationen (Steuerelemente) hinzu.
Wiederholen Sie die Validierung, um einen Kostenvoranschlag zu erhalten.

Weitere Informationen zum Ausführen der Schritte finden Sie unter Angepasste implementierbare Architektur in Ihrem privaten Katalog integrieren.

Weitere Informationen finden Sie unter Unternehmensarchitektur übernehmen.