Prerequisiti

Questa pagina illustra i prerequisiti per il deployment di Cortex Framework. Prima di procedere al deployment della demo o al deployment di produzione, prenditi un po' di tempo per configurare ogni prerequisito prima di procedere.

Artefatti di installazione

Clona il repository di Google Cloud Cortex Framework: https://github.com/GoogleCloudPlatform/cortex-framework:

git clone https://github.com/GoogleCloudPlatform/cortex-framework
cd cortex-framework

Installa uv

uv è un gestore di pacchetti Python estremamente veloce, scritto in Rust. Cortex Framework lo utilizza per avere ambienti di deployment di build coerenti, isolati e ad alte prestazioni e per ridurre il tempo di installazione.

Nota: se esegui questo comando da Cloud Shell, uv è già installato e puoi saltare il passaggio di installazione

Installa il pacchetto del gestore uv per gli ambienti virtuali Python. Consulta le istruzioni di installazione di uv.

Sincronizza le dipendenze richieste

Esegui il seguente comando per la sincronizzazione delle dipendenze e per l' attivazione di un ambiente virtuale Python:

uv sync

Configura l'interfaccia a riga di comando di Google Cloud SDK

Nota: se esegui i comandi gcloud per la prima volta nel tuo ambiente locale o se riscontri problemi di autenticazione, utilizza questi comandi per assicurarti che Google Cloud SDK sia autenticato.

gcloud auth login
gcloud auth application-default login

Preparail tuo Google Cloud progetto per l'hosting di Dataform

Prima di eseguire il deployment, devi avere accesso a un Google Cloud progetto con un account di fatturazione collegato.

Nota: questo progetto viene utilizzato come progetto predefinito per l'esecuzione dei comandi gcloud e per l'hosting del repository Dataform. Non viene utilizzato automaticamente come progetto di destinazione nel deployment di Cortex Framework. I progetti di deployment (ad esempio i progetti di build, di origine e di destinazione) vengono configurati separatamente nella configurazione del deployment (ad esempio nel file config/config.yaml).

Ora configura l'ambiente Google Cloud CLI in modo che punti al tuo progetto specifico Google Cloud .

# Set current project and quota project
gcloud config set project PROJECT_ID
gcloud auth application-default set-quota-project PROJECT_ID

Abilita Google Cloud i servizi

In questa sezione abiliteremo i seguenti Google Cloud servizi nel tuo Google Cloud progetto:

• API BigQuery
• API Dataform
• API Cloud Resource Manager

Abilita questi Google Cloud servizi utilizzando Cloud Shell eseguendo il seguente comando nel terminale:

Sostituisci PROJECT_ID con l'ID progetto.

gcloud config set project PROJECT_ID

gcloud services enable cloudresourcemanager.googleapis.com \
                       bigquery.googleapis.com \
                       dataform.googleapis.com \
                       --project=PROJECT_ID

Passaggi successivi

Sei pronto per creare ed eseguire il deployment? Consulta le seguenti guide per avviare il deployment:

• Deployment della demo: esegui il deployment dei dati di esempio in pochi minuti per vedere Cortex Framework in azione.
• Deployment di produzione: segui le istruzioni passo passo per configurare ed eseguire il deployment di Cortex Framework per i dati aziendali.