Deployment

En esta página, se te guiará por los pasos de implementación de Cortex Framework para los datos de tu empresa.

Antes de comenzar

Asegúrate de haber completado los requisitos previos que se describen en la página Requisitos previos antes de continuar con la implementación.

Antes de implementar Cortex Framework, se deben replicar las tablas pertinentes de SAP ERP en BigQuery. Para obtener más información, consulta la página de la fuente de datos de SAP ERP.

Deployment

Con tu entorno preparado, ya puedes ejecutar la implementación. Usa las secuencias de comandos uv de Cortex Framework para compilar y enviar tus recursos de datos a tu Google Cloud proyecto, transformando tus configuraciones locales en una arquitectura de datos activa y escalable.

Configuración

Antes de la implementación, las capas de base de datos y de productos de datos se configuran a través de un enfoque centralizado de configuración como código. Cortex Framework usa un archivo config/config.yaml para configurar la implementación de Cortex Framework. Este archivo contiene la asignación esencial entre tus datos de origen y el entorno Google Cloud de destino. La configuración adecuada garantiza que Cortex Framework sepa exactamente dónde encontrar tus datos sin procesar y dónde materializar las capas resultantes.

Para que la implementación de Cortex Framework sea exitosa, se deben agregar estos valores obligatorios:

  • YOUR_BUILD_PROJECT_ID: Es el proyecto en el que se ejecutan la organización de la implementación y las secuencias de comandos uv.
  • YOUR_SOURCE_PROJECT_ID: Es el proyecto que contiene tus datos de origen sin procesar.
  • YOUR_TARGET_PROJECT_ID: Es el proyecto de destino en el que residirán los productos de datos procesados y los conjuntos de datos de BigQuery.
  • YOUR_REPO_PROJECT_ID: Es el proyecto que aloja el repositorio de Dataform y los artefactos de implementación.

Para obtener información detallada sobre el archivo de configuración, consulta Configuración de la implementación.

Configura los roles de IAM

Configura los permisos de Identity and Access Management (IAM) necesarios para implementar el contenido de Cortex Framework en los proyectos requeridos Google Cloud .

Roles para el proyecto de compilación

Para obtener los permisos que necesitas para compilar Cortex Framework, pídele a tu administrador que te otorgue el rol de IAM de BigQuery Data JobUser (roles/bigquery.jobUser) en tu proyecto de compilación. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Roles para el proyecto de origen

Para obtener los permisos que necesitas para implementar Cortex Framework, pídele a tu administrador que te otorgue el rol de IAM de BigQuery Data Viewer (roles/bigquery.dataViewer) en tu proyecto de origen. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Roles para proyectos de destino

Para obtener los permisos que necesitas para implementar Cortex Framework, pídele a tu administrador que te otorgue los siguientes roles de IAM en tus proyectos de destino:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Ejecuta la implementación

Ejecuta el siguiente comando para activar la implementación de Cortex Framework. Este proceso realizará las siguientes acciones:

  • Verifica que se hayan completado todos los requisitos previos.
  • Se conecta al conjunto de datos sin procesar y, según la información del esquema, compila y compila las secuencias de comandos .sqlx.
  • Crea el repositorio y el espacio de trabajo de Dataform y, luego, sincroniza los artefactos compilados con el repositorio.
uv run cortex-build-and-deploy --config "config/config.yaml"

Opciones de línea de comandos

La interfaz de línea de comandos (CLI) uv run admite estas acciones:

  • uv run cortex-build: Ejecuta la compilación del espacio de trabajo de Dataform, traduciendo las configuraciones de YAML y las plantillas SQLX/JS en recursos de Dataform implementables. Para obtener más información, consulta la compilación de Cortex de la CLI.
  • uv run cortex-deploy: Envía los recursos compilados al espacio de trabajo de Dataform de destino. Para obtener más información, consulta la implementación de Cortex de la CLI.
  • uv run cortex-build-and-deploy: Combina la compilación y el envío de los recursos de compilación al espacio de trabajo de Dataform. Para obtener más información, consulta la compilación y la implementación de Cortex de la CLI.

Ejecuta la canalización de la base de datos y los productos de datos

Una vez que se completa la implementación, el paso final es ejecutar todas las acciones en el repositorio de Dataform. Cuando ejecutas la canalización dentro del espacio de trabajo de Dataform, inicias la transformación lógica de los datos sin procesar en productos de datos estructurados y listos para la IA, listos para el uso empresarial inmediato. Lleva a cabo los pasos siguientes:

  1. Ve a Dataform.
  2. Asegúrate de estar en el proyecto correcto.
  3. Haz clic en el nombre del repositorio creado.
  4. Haz clic en el nombre del espacio de trabajo.
  5. Haz clic en Iniciar ejecución.
  6. Haz clic en Ejecutar acciones.
  7. Selecciona Todas las acciones. También puedes seleccionar los pasos que te interesan.
  8. Haz clic en Iniciar ejecución.

Verifica el éxito de la implementación:

  1. Haz clic en Ejecuciones.
  2. Verifica que el estado se haya completado correctamente.
  3. Haz clic en el vínculo de ejecución para obtener más detalles.

Ahora puedes revisar los recursos de datos de BigQuery implementados en el conjunto de datos configurado en el archivo de configuración. Por ejemplo, CORTEX_SAP_DATAFOUNDATION y CORTEX_SAP_DATAPRODUCTS.