Deployment della demo

Il deployment della demo offre un'esperienza semplificata utilizzando un set di dati di esempio predefinito. Fornisce un workflow end-to-end per eseguire il deployment delle pipeline Dataform di Cortex Framework per l'orchestrazione e per inizializzare i set di dati BigQuery corrispondenti con dati di esempio.

Prima di iniziare

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

Ottenere i ruoli e le autorizzazioni IAM richiesti

Ottieni le autorizzazioni IAM (Identity and Access Management) richieste per eseguire il deployment dei contenuti di Cortex Framework all'interno del progetto di destinazione Google Cloud .

Ruoli per il progetto di destinazione

Per ottenere le autorizzazioni necessarie per eseguire il deployment di Cortex Framework, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto 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.

(Facoltativo) Ottenere i ruoli IAM richiesti per un deployment della demo utilizzando un account di servizio

I seguenti ruoli sono obbligatori solo in caso di deployment della demo con il parametro facoltativo --service_account abilitato. Fornire un account di servizio durante il deployment della demo semplifica l'esecuzione delle pipeline di dati dopo il deployment, tramite la creazione della configurazione di pianificazione dell'esecuzione dei workflow. Questi ruoli non sono obbligatori per i deployment senza la configurazione --service_account.

Per ottenere le autorizzazioni necessarie per eseguire il deployment della demo di Cortex Framework, chiedi all'amministratore di concederti il ruolo IAM Service Account Token Creator (roles/iam.serviceAccountTokenCreator) nel progetto di origine e 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.

Deployment

Segui questi passaggi per creare un ambiente Python virtuale, sincronizzare le dipendenze e attivare le pipeline di dati. Ricorda di utilizzare 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. Per saperne di più, consulta l'installazione di uv nella sezione Prerequisiti.

Eseguire il deployment della demo

Esegui il seguente comando per attivare il deployment. Questa procedura eseguirà le seguenti azioni:

  • Verifica che tutti i prerequisiti siano stati completati.
  • Carica i dati di esempio in un set di dati BigQuery da utilizzare come livello non elaborato a scopo dimostrativo.
  • Crea pipeline Dataform per l'elaborazione dei dati di esempio tramite i livelli di dati di Cortex Framework.
  • Crea il repository e lo spazio di lavoro Dataform, quindi sincronizza gli artefatti compilati con il repository.
  • Crea la pianificazione del workflow e attiva l'esecuzione iniziale del workflow Dataform.

Per il deployment della demo senza un account di servizio, esegui il seguente comando:

uv run cortex-demo --project_id=PROJECT_ID

Per il deployment della demo con un account di servizio, esegui il seguente comando:

uv run cortex-demo --project_id=PROJECT_ID \
    --service_account="SA_DF_RUN@PROJECT_ID.iam.gserviceaccount.com"

Per saperne di più, consulta Località BigQuery supportate e Regioni Dataform supportate.

Deployment della demo dell'interfaccia a riga di comando: se vuoi, puoi visualizzare un elenco dei possibili parametri eseguendo il comando uv run cortex-demo -h. Per saperne di più, consulta Deployment della demo di Cortex Framework tramite l'interfaccia a riga di comando.

Verifica

Al termine del deployment:

  1. Apri Dataform per esaminare il nuovo codice creato nel repository:

    1. Repository Dataform creato.
    2. Spazio di lavoro di sviluppo Dataform creato.
    3. Codice compilato e sincronizzato.

  2. Esegui le azioni Dataform:

    1. Apri lo spazio di lavoro Dataform.
    2. Fai clic su Avvia esecuzione.
    3. Fai clic su Esegui azioni.
    4. Fai clic su Tutte le azioni.

    5. Fai clic su Avvia esecuzione.

    6. Monitora l'esecuzione corretta di tutte le azioni nel repository Dataform.

  3. Vai alla console BigQuery per visualizzare i set di dati creati e verificare lo schema e i dati. Set di dati creati:

    • cortex_demo_sap_ecc_raw: questo set di dati contiene i dati non elaborati del sistema di origine (in questo esempio, SAP S/4HANA).
    • cortex_demo_sap_ecc_data_foundation: questo set di dati rappresenta il livello di base dei dati, in cui i dati non elaborati del livello non elaborato vengono elaborati tramite CDC.
    • cortex_demo_data_product: questo set di dati contiene i prodotti di dati di esempio: visualizzazioni o tabelle ottimizzate e ad alte prestazioni progettate per l'utilizzo da parte degli utenti finali.