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 :

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é :

  1. Ouvrez Dataform pour inspecter le nouveau code créé dans le dépôt :

    1. Dépôt Dataform créé.
    2. Espace de travail de développement Dataform créé.
    3. Code compilé et synchronisé.
  2. Exécutez les actions Dataform :

    1. Ouvrez l'espace de travail Dataform.
    2. Cliquez sur Démarrer l'exécution.
    3. Cliquez sur Actions à exécuter.
    4. Cliquez sur Toutes les actions.
    5. Cliquez sur Démarrer l'exécution.

    6. Surveillez l'exécution réussie de toutes les actions dans votre dépôt Dataform.

  3. 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.