Bereitstellung

Auf dieser Seite werden Sie durch die Schritte zur Bereitstellung von Cortex Framework für Ihre Unternehmensdaten geführt.

Hinweis

Prüfen Sie, ob Sie die Voraussetzungen auf der Voraussetzungen Seite erfüllt haben, bevor Sie mit der Bereitstellung fortfahren.

Vor der Bereitstellung von Cortex Framework müssen relevante SAP ERP-Tabellen in BigQuery repliziert werden. Weitere Informationen finden Sie auf der Seite SAP ERP-Datenquelle.

Bereitstellung

Nachdem Sie Ihre Umgebung vorbereitet haben, können Sie die Bereitstellung ausführen. Verwenden Sie die uvSkripts von Cortex Framework, um Ihre Daten Assets zu erstellen und in Ihr Google Cloud Projekt zu übertragen. So wandeln Sie Ihre lokalen Konfigurationen in eine aktive, skalierbare Datenarchitektur um.

Konfiguration

Vor der Bereitstellung werden die Datenbasis- und Datenproduktebenen über einen zentralen Konfigurations-als-Code-Ansatz konfiguriert. Cortex Framework verwendet eine config/config.yaml-Datei, um die Bereitstellung von Cortex Framework zu konfigurieren. Diese Datei enthält die wesentliche Zuordnung zwischen Ihren Quelldaten und der Ziel Google Cloud umgebung. Durch die richtige Konfiguration weiß Cortex Framework genau, wo sich Ihre Rohdaten befinden und wo die resultierenden Ebenen materialisiert werden sollen.

Für eine erfolgreiche Bereitstellung von Cortex Framework müssen die folgenden Pflichtwerte hinzugefügt werden:

  • YOUR_BUILD_PROJECT_ID: Das Projekt, in dem die Bereitstellungsorchestrierung und die uv-Skripts ausgeführt werden.
  • YOUR_SOURCE_PROJECT_ID: Das Projekt, das Ihre Rohquelldaten enthält.
  • YOUR_TARGET_PROJECT_ID: Das Zielprojekt, in dem sich die verarbeiteten Datenprodukte und BigQuery-Datasets befinden.
  • YOUR_REPO_PROJECT_ID: Das Projekt, in dem das Dataform-Repository und die Bereitstellungsartefakte gehostet werden.

Detaillierte Informationen zur Konfigurationsdatei finden Sie unter Bereitstellungskonfiguration.

IAM-Rollen konfigurieren

Konfigurieren Sie die erforderlichen IAM-Berechtigungen (Identity and Access Management), um Cortex Framework Inhalte in den erforderlichen Google Cloud Projekten bereitzustellen.

Rollen für das Build-Projekt

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle BigQuery Data JobUser (roles/bigquery.jobUser) für Ihr Build-Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen von Cortex Framework benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Rollen für das Quellprojekt

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle BigQuery-Datenbetrachter (roles/bigquery.dataViewer) für Ihr Quellprojekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen von Cortex Framework benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Rollen für Zielprojekte

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihre Zielprojekte zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Bereitstellen von Cortex Framework benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Bereitstellung ausführen

Führen Sie den folgenden Befehl aus, um die Bereitstellung von Cortex Framework auszulösen. Bei diesem Vorgang werden die folgenden Aktionen ausgeführt:

  • Prüfen, ob alle Voraussetzungen erfüllt sind.
  • Verbindung zum Roh-Dataset herstellen und anhand der Schemainformationen die .sqlx-Skripts erstellen und kompilieren.
  • Das Dataform-Repository und den Arbeitsbereich erstellen und dann die kompilierten Artefakte mit dem Repository synchronisieren.
uv run cortex-build-and-deploy --config "config/config.yaml"

Befehlszeilen-Optionen

Die Befehlszeile uv run unterstützt die folgenden Aktionen:

  • uv run cortex-build: Kompiliert den Dataform-Arbeitsbereich und wandelt YAML-Konfigurationen und SQLX-/JS-Vorlagen in bereitstellbare Dataform-Assets um. Weitere Informationen finden Sie unter CLI Cortex build.
  • uv run cortex-deploy: Überträgt die kompilierten Assets in den Dataform-Zielarbeitsbereich. Weitere Informationen finden Sie unter CLI Cortex deploy.
  • uv run cortex-build-and-deploy: Kombiniert die Kompilierung und Übertragung der Build-Assets in den Dataform-Arbeitsbereich. Weitere Informationen finden Sie unter CLI Cortex build and deploy.

Pipeline für Datenbasis und Datenprodukte ausführen

Nach Abschluss der Bereitstellung müssen Sie im letzten Schritt alle Aktionen im Dataform-Repository ausführen. Wenn Sie die Pipeline im Dataform-Arbeitsbereich ausführen, wird die logische Transformation von Rohdaten in strukturierte, KI-fähige Datenprodukte initiiert, die sofort für die geschäftliche Nutzung bereit sind. Gehen Sie so vor:

  1. Rufen Sie Dataform auf.
  2. Achten Sie darauf, dass Sie sich im richtigen Projekt befinden.
  3. Klicken Sie auf den Namen des erstellten Repositorys.
  4. Klicken Sie auf den Namen des Arbeitsbereichs.
  5. Klicken Sie auf Ausführung starten.
  6. Klicken Sie auf Aktionen ausführen.
  7. Wählen Sie Alle Aktionen aus. Sie können auch die gewünschten Schritte auswählen.
  8. Klicken Sie auf Ausführung starten.

Prüfen Sie, ob die Bereitstellung erfolgreich war:

  1. Klicken Sie auf Ausführungen.
  2. Prüfen Sie, ob der Status „Erfolgreich abgeschlossen“ lautet.
  3. Klicken Sie auf den Link zur Ausführung, um weitere Informationen zu erhalten.

Sie können sich jetzt die in BigQuery bereitgestellten Daten-Assets im Dataset ansehen, das in der Konfigurationsdatei konfiguriert ist. Beispiel: CORTEX_SAP_DATAFOUNDATION und CORTEX_SAP_DATAPRODUCTS.