Déploiement de démonstration
Le déploiement de démonstration offre une expérience simplifiée à l'aide d'un exemple d'ensemble de données prédéfini. Il fournit un workflow de bout en bout pour déployer les pipelines Dataform de Cortex Framework à des fins d'orchestration et pour initialiser les ensembles de données BigQuery correspondants avec des exemples de données.
Avant de commencer
Avant de poursuivre avec le déploiement de démonstration, assurez-vous d'avoir rempli les conditions préalables décrites sur la Prerequisites page.
Obtenir les rôles et autorisations IAM requis
Obtenez les autorisations Identity and Access Management (IAM) requises pour déployer Cortex Framework contenu dans le projet cible Google Cloud .
Rôles pour le projet cible
Pour obtenir les autorisations nécessaires pour déployer Cortex Framework, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet cible :
- Utilisateur de tâche BigQuery (
roles/bigquery.jobUser) - Éditeur de données BigQuery (
roles/bigquery.dataEditor) - Éditeur Dataform (
roles/dataform.editor) - Administrateur Service Usage (
roles/serviceusage.serviceUsageAdmin)
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Facultatif : Obtenir les rôles IAM requis pour un déploiement de démonstration à l'aide d'un compte de service
Les rôles suivants ne sont requis qu'en cas de déploiement de démonstration avec le paramètre facultatif --service_account activé. Fournir un compte de service lors du déploiement de démonstration simplifie l'exécution des pipelines de données après le déploiement, en créant une configuration de planification de l'exécution des workflows. Ces rôles ne sont pas requis pour les déploiements sans la configuration --service_account.
Pour obtenir les autorisations nécessaires pour déployer la version de démonstration de Cortex Framework, demandez à votre administrateur de vous accorder le rôle IAM Créateur de jetons de compte de service (roles/iam.serviceAccountTokenCreator) sur votre projet source et votre projet cible.
Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.
Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.
Déploiement
Procédez comme suit pour créer un environnement Python virtuel, synchroniser les dépendances et déclencher les pipelines de données. N'oubliez pas d'utiliser
les scripts uvde Cortex Framework pour créer et envoyer vos assets de données
à votre Google Cloud projet, en transformant vos configurations locales
en une architecture de données évolutive et en direct. Pour en savoir plus, consultez la section
uv installation
dans la section Conditions préalables.
Exécuter le déploiement de démonstration
Exécutez la commande suivante pour déclencher le déploiement. Ce processus effectuera les actions suivantes :
- Vérifiez que toutes les conditions préalables sont remplies.
- Chargez des exemples de données dans un ensemble de données BigQuery pour servir de couche brute à des fins de démonstration.
- Créez des pipelines Dataform pour traiter les exemples de données via les couches de données de Cortex Framework.
- Créez le dépôt et l'espace de travail Dataform, puis synchronisez les artefacts compilés avec le dépôt.
- Créez une planification de workflow et déclenchez l'exécution initiale du workflow Dataform.
Pour un déploiement de démonstration sans compte de service, exécutez la commande suivante :
uv run cortex-demo --project_id=PROJECT_ID
Pour un déploiement de démonstration avec un compte de service, exécutez la commande suivante :
uv run cortex-demo --project_id=PROJECT_ID \
--service_account="SA_DF_RUN@PROJECT_ID.iam.gserviceaccount.com"
Pour en savoir plus, consultez la section Emplacements BigQuery compatibles et Régions Dataform compatibles.
Déploiement de démonstration de la CLI : vous pouvez éventuellement afficher une liste des paramètres possibles
en exécutant la commande uv run cortex-demo -h. Pour en savoir plus, consultez la section
Déploiement de démonstration de Cortex Framework à l'aide de la CLI.
Validation
Une fois le déploiement terminé :
Ouvrez Dataform pour inspecter le nouveau code créé dans le dépôt :
- Dépôt Dataform créé.
- Espace de travail de développement Dataform créé.
- Code compilé et synchronisé.
Exécutez les actions Dataform :
- Ouvrez l'espace de travail Dataform.
- Cliquez sur Démarrer l'exécution.
- Cliquez sur Actions à exécuter.
- Cliquez sur Toutes les actions.
Cliquez sur Démarrer l'exécution.
Surveillez l'exécution réussie de toutes les actions dans votre dépôt Dataform.
Accédez à la console BigQuery pour afficher les ensembles de données créés, puis vérifiez le schéma et les données. Ensembles de données créés :
cortex_demo_sap_ecc_raw: cet ensemble de données contient les données brutes du système source (dans cet exemple, SAP S/4HANA).cortex_demo_sap_ecc_data_foundation: cet ensemble de données représente la couche de base de données, où les données brutes de la couche brute sont traitées par CDC.cortex_demo_data_product: cet ensemble de données contient les produits de données de démonstration, des vues ou des tables affinées et hautes performances conçues pour être utilisées par les utilisateurs finaux.