Panoramica del deployment

Questa pagina ti guida attraverso i passaggi di deployment di Cortex Framework per i dati aziendali.

Prima di iniziare

Prima di continuare con il deployment, assicurati di aver completato i prerequisiti descritti nella pagina Prerequisiti.

Prima di eseguire il deployment di Cortex Framework, le tabelle SAP ERP pertinenti devono essere replicate in BigQuery. Per saperne di più, consulta la pagina Origine dati SAP ERP.

Deployment

Ora che l'ambiente è pronto, puoi eseguire il deployment. Utilizza gli script uvdi Cortex Framework per creare ed eseguire il push degli asset di dati nel tuo Google Cloud progetto, trasformando le configurazioni locali in un'architettura di dati live e scalabile.

Configurazione

Prima del deployment, i livelli di base dati e prodotto di dati vengono configurati tramite un approccio centralizzato di configurazione come codice. Cortex Framework utilizza un file config/config.yaml per configurare il deployment di Cortex Framework. Questo file contiene la mappatura essenziale tra i dati di origine e l'ambiente di destinazione Google Cloud. Una configurazione corretta garantisce che Cortex Framework sappia esattamente dove trovare i dati non elaborati e dove materializzare i livelli risultanti.

Per un deployment di Cortex Framework riuscito, è necessario aggiungere questi valori obbligatori:

  • YOUR_BUILD_PROJECT_ID: il progetto in cui vengono eseguiti l'orchestrazione del deployment e gli script uv.
  • YOUR_SOURCE_PROJECT_ID: il progetto contenente i dati di origine non elaborati.
  • YOUR_TARGET_PROJECT_ID: il progetto di destinazione in cui risiederanno i prodotti di dati elaborati e i set di dati BigQuery.
  • YOUR_REPO_PROJECT_ID: il progetto che ospita il repository Dataform e gli artefatti di deployment.

Per informazioni dettagliate sul file di configurazione, consulta Configurazione del deployment.

Configura i ruoli IAM

Configura le autorizzazioni Identity and Access Management (IAM) richieste per eseguire il deployment dei contenuti di Cortex Framework nei progetti richiesti Google Cloud .

Ruoli per il progetto di build

Per ottenere le autorizzazioni necessarie per creare Cortex Framework, chiedi all'amministratore di concederti il ruolo IAM Utente job dati BigQuery (roles/bigquery.jobUser) nel progetto di build. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Ruoli per il progetto di origine

Per ottenere le autorizzazioni necessarie per eseguire il deployment di Cortex Framework, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore dati BigQuery (roles/bigquery.dataViewer) nel progetto di origine. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Ruoli per i progetti di destinazione

Per ottenere le autorizzazioni necessarie per eseguire il deployment di Cortex Framework, chiedi all'amministratore di concederti i seguenti ruoli IAM nei progetti di destinazione:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Esegui il deployment

Esegui il comando seguente per attivare il deployment di Cortex Framework. Questo processo eseguirà le seguenti azioni:

  • Verifica che tutti i prerequisiti siano stati completati.
  • Si connette al set di dati non elaborati e, in base alle informazioni sullo schema, crea e compila gli script .sqlx.
  • Crea il repository e l'area di lavoro Dataform, quindi sincronizza gli artefatti compilati con il repository.
uv run cortex-build-and-deploy --config "config/config.yaml"

Opzioni della riga di comando

L'interfaccia a riga di comando (CLI) uv run supporta queste azioni:

  • uv run cortex-build: esegue la compilazione dell'area di lavoro Dataform, traducendo le configurazioni YAML e i modelli SQLX/JS in asset Dataform di cui è possibile eseguire il deployment. Per saperne di più, consulta la sezione Build di Cortex CLI.
  • uv run cortex-deploy: esegue il push degli asset compilati nell'area di lavoro Dataform di destinazione. Per saperne di più, consulta la sezione Deployment di Cortex CLI.
  • uv run cortex-build-and-deploy: combina la compilazione e il push degli asset di build nell'area di lavoro Dataform. Per saperne di più, consulta la sezione Build e deployment di Cortex CLI.