Elección de la mejor opción de flujo de trabajo de CI/CD de Fabric para usted

Este artículo presenta a los desarrolladores de Fabric diferentes opciones para construir procesos CI/CD en Fabric, basadas en escenarios comunes de clientes. Este artículo se centra más en la Implementación continua (CD) del proceso de CI/CD. Para obtener más información sobre la parte de CI (integración continua), véase Proceso de desarrollo en Microsoft Fabric.

Aunque en este artículo se describen varias opciones distintas, muchas organizaciones toman un enfoque híbrido.

Requisitos previos

Para crear un proceso de CI/CD mediante las opciones de este artículo, necesita:

Note

La opción 3 usa las canalizaciones de implementación de Fabric. Para usar esa opción, también necesita acceso a la característica de canalizaciones de implementación y permiso para crear y administrar una canalización.

Proceso de desarrollo

El proceso de desarrollo es el mismo en todos los escenarios de implementación y es independiente de cómo publicar nuevas actualizaciones en producción. Cuando los desarrolladores trabajan con el control de código fuente, deben trabajar en un entorno aislado. En Fabric, ese entorno puede ser un IDE en la máquina local (como Power BI Desktop o VS Code) o en un área de trabajo diferente de Fabric. Puedes encontrar información sobre las diferentes consideraciones para el proceso de desarrollo en el proceso de desarrollo en Microsoft Fabric.

Diagrama que muestra cajas centradas de feature y de espacios de trabajo de desarrollo, sincronización bidireccional de Git con sus ramas, ramificación con un plan de despliegue opcional y una PR de feature a dev.

Git sync soporta tanto confirmar cambios del espacio de trabajo en Git como la actualización de un espacio de trabajo desde Git. La flecha de PR muestra la dirección en la que fusionas los cambios de características en la rama de desarrollo compartida, no una operación de sincronización bidireccional.

Proceso de lanzamiento

El proceso de lanzamiento se inicia una vez completadas las nuevas actualizaciones y la solicitud de incorporación de cambios (PR) se combina en la rama compartida del equipo (por ejemplo, Principal, Desarrollo etc.). Desde este punto, hay diferentes opciones para crear un proceso de versión en Fabric.

En la tabla siguiente se resumen las opciones que le ayudarán a elegir. Muchos equipos combinan más de uno.

Option Fuente de verdad Qué despliega cada etapa Mecanismo de implementación Configuración por fase Más adecuado para
1 - Ramas Git por etapa Git La propia rama primaria del entorno de ensayo integración de Git, fabric-cicd o APIs de Fabric Items Definiciones específicas de etapa, parametrización de fabric-cicd o conjuntos de valores de Variable Library Equipos que promueven cambios a través de una rama separada para cada etapa
2 - Commit compartido de lanzamiento Git (Dev para trabajos en curso, Main para lanzamientos)¹ La misma etiqueta de lanzamiento en Main, primero en Test, luego en Prod tras validación y aprobación fabric-cicd o API de definiciones de artículos de importación masiva parametrización de fabric-cicd, scripts personalizados y conjuntos de valores de la biblioteca de variables Equipos que despliegan una versión compartida para Test y Prod en lugar de mantener una rama por etapa
3 - Canalizaciones de despliegue área de trabajo de Fabric (Git solo a través de dev) El contenido del espacio de trabajo de la etapa anterior Fabric UI o API de canalizaciones de implementación Reglas de implementación y enlace automático Equipos que prefieren una implementación de código bajo y nativa de Fabric entre áreas de trabajo
4 - CI/CD para ISV Git (Dev para trabajos continuos, Main para lanzamientos) La misma etiqueta de lanzamiento en Main, primero en Test compartido, luego en el espacio de trabajo Prod de cada cliente tras validación y aprobación fabric-cicd o API de definiciones de artículos de importación masiva (por espacio de trabajo del cliente) Parámetros de lanzamiento por cliente ISV que administran muchas áreas de trabajo por cliente

¹ En la opción 2, solo el espacio de trabajo Dev está conectado a Git. Los espacios de trabajo Test y Prod no están conectados a Git. Empujar una etiqueta release en Main activa una canalización que despliega esa versión en Test. Tras una validación y aprobación exitosas, la pipeline despliega la misma etiqueta y commit SHA en Prod.

Estas opciones no requieren una estrategia de ramificación específica, como Gitflow o desarrollo basado en troncos. Lo importante es que cada etapa despliegue un commit conocido y versionado, y que el Prod reciba el mismo contenido que tú probaste.

Las opciones 1 y 2 difieren en cómo organizas y promocionas los lanzamientos, no en una elección exclusiva de herramientas. Ambas opciones pueden usar APIs fabric-cicd o Fabric Items y parametrización específica del entorno. La opción 1 promueve cambios a través de ramas de entorno separadas. La Opción 2 utiliza una etiqueta release en Main para activar el despliegue del mismo commit en Test y, tras validación y aprobación, en Prod.

Un plan de despliegue no es una opción de flujo de trabajo separada. Puedes usar un plan con operaciones Git compatibles en la opción 1, con pipelines de despliegue en la opción 3, o llamando directamente a la API de Definiciones de Elementos de Importación Masiva en las opciones 1, 2 y 4. La fabric-cicd biblioteca no soporta planes de despliegue, incluso cuando usas su modo de importación masiva. El plan controla el orden de despliegue, las dependencias y las acciones, mientras que el flujo de trabajo seleccionado continúa definiendo la fuente de verdad, qué despliega cada etapa y la configuración de la etapa.

Opción 1 - Despliegues basados en definiciones desde las ramas Git por etapa

Diagrama con espacio de trabajo separado y filas de rama Git. Los PRs promueven cambios de las ramas de característica a las de desarrollo, prueba y producción, y cada etapa despliega su propia rama usando integración con Git o APIs de Items.

Con esta opción, todos los despliegues se originan desde Git. Cada etapa tiene una rama primaria dedicada: Dev, Test y Prod en este ejemplo. Las PRs promocionan los cambios entre esas ramas, y cada espacio de trabajo recibe las definiciones de la rama de su etapa. Puedes desplegar con integración de Git, fabric-cicd o APIs de Fabric Items. Cuando usas fabric-cicd o APIs de Items, el espacio de trabajo objetivo no necesita una conexión Git. La característica definitoria es la rama separada para cada etapa, no la herramienta de despliegue.

Una vez que una solicitud de cambios (PR) a la rama Desarrollo se aprueba y combina:

  1. Actualizar el espacio de trabajo Dev desde la rama Dev , por ejemplo, con integración de Git. Ejecuta pruebas unitarias y cualquier operación posterior al despliegue necesaria.
  2. Crea una PR para la rama Test con los cambios que quieres promover. Puedes usar una rama de lanzamiento para hacer cherry-pick de esos cambios. Aplica los procesos de revisión y aprobación de tu equipo.
  3. Despliega un commit específico desde la rama Test al espacio de trabajo Test usando integración de Git, fabric-cicd o APIs de Fabric Items. Aplica una configuración específica de cada etapa y realiza pruebas automáticas o manuales.
  4. Crea una PR para la rama Prod que promueva los cambios validados. Revisa las definiciones resultantes para asegurarte de que coinciden con la versión probada, salvo en configuraciones intencionadas específicas de cada etapa. Si añades otros cambios, validalos en Test antes de la promoción.
  5. Tras la aprobación, despliega la rama Prod en el espacio de trabajo Prod utilizando la herramienta de despliegue que hayas seleccionado. Realiza las comprobaciones post-despliegue y las operaciones de ingesta de datos necesarias.

Algunas dependencias de elementos se vinculan automáticamente mediante IDs lógicos. Otros necesitan parametrización o actualizaciones post-despliegue. Para más detalles, véase Entender la vinculación de dependencias en el despliegue entre espacios de trabajo.

¿Qué componentes pueden usarse para implementar la opción #1?

  • Integración con git: conecta cada espacio de trabajo a su rama de staging. Actualízalo a través de la interfaz de Fabric o automatiza las actualizaciones con las APIs de Fabric Git.
  • Fabric-CICD: Consulta la rama de la etapa y publica sus definiciones de elementos con parámetros específicos del entorno. El espacio de trabajo de destino no necesita una conexión Git.
  • APIs de Fabric Items: Despliega definiciones desde la rama del entorno de ensayo llamando a Create item y Update item definition, o a la Bulk Import Item Definitions API. Cuando llamas directamente a las APIs, tu automatización prepara las definiciones y la configuración específica de cada etapa.

Para ejemplos de implementación, consulta el tutorial de fabric-cicd y Azure DevOps o la API de CI/CD de Fabric con Importación Masiva de Definiciones de Elementos.

¿Cuándo debe considerar la posibilidad de usar la opción 1?

  • Cuando quiera usar el repositorio de Git como fuente única de la verdad y el origen de todas las implementaciones.
  • Cuando quieres una rama primaria separada para cada etapa, con revisión basada en pull requests y promoción entre etapas.
  • Cuando se quiera gestionar definiciones específicas de cada etapa en Git, o aplicar configuraciones específicas del entorno con la herramienta de despliegue que se haya seleccionado.

Opción 2 - Despliegues basados en una definición a partir de un commit de lanzamiento compartido

Diagrama que muestra una etiqueta de release sobre la rama main que desencadena el despliegue a Test, con pruebas exitosas y aprobación que habilita el despliegue de la misma etiqueta y del mismo commit SHA a Prod a través de las API de elementos.

Con esta opción, los desarrolladores trabajan en una rama Dev conectada al espacio de trabajo Dev. La rama principal es la rama de lanzamiento: contiene solo los cambios que decides publicar. Los espacios de trabajo de Test y Prod no están conectados a Git. Subir una etiqueta de versión en Main activa un flujo de trabajo de Acciones de GitHub o una pipeline de Azure DevOps. Despliega la versión etiquetada en Test, ejecuta validaciones y espera la aprobación de producción antes de desplegar la misma etiqueta y el SHA del commit en Prod. La pipeline puede usar un entorno de compilación para ejecutar pruebas unitarias y ajustar definiciones de elementos antes de subirlas. Por ejemplo, podrías cambiar las conexiones de fuentes de datos, referencias a otros elementos o valores de parámetros para la etapa objetivo. No todas las dependencias de los ítems requieren estos cambios. Algunos se vinculan automáticamente mediante IDs lógicos cuando se despliegan en un nuevo espacio de trabajo. Para más detalles, véase Entender la vinculación de dependencias en el despliegue entre espacios de trabajo.

El flujo de liberación funciona de la siguiente manera:

  1. Los desarrolladores fusionan los PR aprobados en la rama Dev, y el espacio de trabajo Dev se actualiza desde Git.
  2. Para preparar una versión, crea una PR que haga cherry-pick de los cambios que quieres lanzar de Dev a Main. La RP debe incluir los mismos procesos de revisión y aprobación que cualquier otro PR de tu equipo u organización.
  3. Por ejemplo, crea una etiqueta release en el commit elegido en Mainv1.5.0. Haz push de la etiqueta para activar un flujo de trabajo de Acciones de GitHub o un pipeline de Azure DevOps configurado para etiquetas de release.
  4. La canalización resuelve la etiqueta en un commit SHA, registra ambos, extrae ese commit, ejecuta pruebas unitarias y ajusta la configuración para Test. Sube esas definiciones de elementos al espacio de trabajo Test usando fabric-cicd o la Bulk Import Item Definitions API. Para más detalles, véase ¿Qué componentes pueden usarse para implementar la opción #2?. Realiza pruebas automatizadas o manuales tras el despliegue. Si la validación falla, se detiene la promoción a Prod.
  5. Después de que la validación se complete correctamente, la pipeline espera en una puerta de aprobación de producción configurada. Utiliza una verificación de aprobación de entorno de GitHub o una verificación de aprobación de entorno Azure DevOps.
  6. Tras la aprobación, despliega la misma etiqueta de release y el mismo commit SHA registrado en Prod. Solo la configuración por etapa, como conjuntos de valores de Biblioteca de Variables o archivos de parámetros, difiere de Test. Realiza comprobaciones específicas de producción y activa cualquier ingestión de datos que requiera el cambio para minimizar la indisponibilidad de los consumidores.

Importante

Despliega en producción el commit exacto que probaste en Test. Reutiliza el SHA de commit registrado, incluso si Main avanza. No muevas ni reutilices una etiqueta de liberación para señalar otro commit.

Si la validación falla, primero haz la corrección en Dev y luego aplica el commit en Main. Crea una nueva etiqueta de release y repite la pipeline, incluyendo la validación de pruebas. Este enfoque también garantiza que futuras versiones de Dev incluyan la corrección.

Para la trazabilidad, configura los trabajos de despliegue para que se dirijan a los entornos correspondientes de GitHub o Azure DevOps. Incluye la etiqueta release y el commit SHA resuelto en cada registro de despliegue para que puedas identificar qué versión llegó a Test y Prod. Una etiqueta Git por sí sola no registra dónde se desplegó una versión.

¿Qué componentes se pueden usar para implementar la opción 2?

  • Fabric-cicd : una biblioteca de Python diseñada para su uso con áreas de trabajo de Microsoft Fabric. Esta biblioteca admite automatizaciones de CI/CD (Integración Continua/Despliegue Continuo) enfocado en código para integrar sin problemas áreas de trabajo en un marco de despliegue. Para ver un ejemplo completo de un extremo a otro, siga nuestro tutorial fabric-cicd y Azure DevOps. Fabric-CICD soporta dos modos de publicación:
  • Bulk-Import-Item-Definitions-API : la API admite la creación de nuevos elementos y la actualización de los existentes, al tiempo que se basa en el control de dependencias integrado de Fabric para asegurarse de que los elementos se implementan en el orden correcto. Esto permite implementaciones coherentes y repetibles en entornos de prueba y producción sin intervención manual. Para ver un tutorial de ejemplo, siga nuestra API Fabric CI/CD con definiciones de elementos de importación masiva.

¿Cuándo debe considerar la posibilidad de usar la opción 2?

  • Cuando necesitas una parametrización específica del entorno de las definiciones de ítems antes del despliegue. La característica de parametrización fabric-cicd utiliza un parameter.yml archivo para reemplazar valores de cada entorno objetivo, incluyendo los identificadores de conexión y los identificadores de lakehouse, sin mantener definiciones separadas de elementos para cada etapa. Soporta operaciones de búsqueda y reemplazo, reemplazo de valores seleccionados por rutas JSON y resolución dinámica de IDs de elementos del espacio de trabajo de destino. Esta capacidad también está disponible en la opción 1 cuando se usa fabric-cicd. La integración de Git por sí sola no proporciona esta sustitución en el tiempo de despliegue.
  • Cuando quiera usar Git como única fuente de verdad y origen de todas las implementaciones.
  • Cuando quieras elegir qué cambios entran en cada versión, y desplegar una versión etiquetada y probada en Prod.

Opción 3: Implementación mediante canalizaciones de implementación de Fabric

Diagrama con filas separadas de espacio de trabajo y Git. Los espacios de trabajo de características y desarrollo se sincronizan con las ramas de Git, mientras que las canalizaciones de despliegue promueven el contenido del espacio de trabajo de Dev a Test y a Prod sin ramas de Test o Prod.

Con esta opción, Git solo se conecta hasta la fase de desarrollo. Desde la fase de desarrollo, las implementaciones se producen directamente entre las áreas de trabajo de Desarrollo/Pruebas/Producción, usando canalizaciones de implementación de Fabric. Puedes desplegar entre etapas directamente desde la interfaz de Fabric, o usar las APIs de las canalizaciones de despliegue para orquestar el despliegue como parte de tu pipeline de lanzamiento de Azure, o un flujo de trabajo de GitHub. Estas API permiten al equipo compilar un proceso de compilación y versión similar al de otras opciones, usando pruebas automatizadas (que pueden realizarse en el propio área de trabajo, o antes de la fase de desarrollo), aprobaciones, etc.

Cuando el despliegue requiere una orden específica, elementos relacionados o acciones, puedes adjuntar un plan de despliegue a un despliegue entre etapas. Las reglas de despliegue y el autobinding continúan gestionando la configuración específica de cada etapa.

Cuando apruebas y fusionas una PR a la rama conectada al espacio de trabajo de desarrollo:

  1. Actualiza el espacio de trabajo Dev desde Git usando la interfaz de Fabric o las APIs de Fabric Git. Ejecuta las operaciones y pruebas necesarias tras la actualización.
  2. Despliega los cambios de Dev a Test usando pipelines de despliegue Fabric, ya sea desde la interfaz de Fabric o a través de las APIs de pipelines de despliegue. Realiza pruebas automáticas o manuales en Test antes de promover los cambios a Prod.
  3. Después de que las pruebas pasen y el gestor de versiones lo apruebe, despliega el contenido validado de Test a Prod. No actualices el contenido seleccionado en Test entre la validación y el despliegue en Prod sin volver a probarlo.

Puedes realizar estos pasos desde la interfaz de Fabric o automatizarlos con APIs en Azure Pipelines o Acciones de GitHub. No necesitas pipelines externos de build y release para el flujo de trabajo basado en la interfaz.

¿Cuándo debe considerar la posibilidad de usar la opción 3?

  • Cuando tu equipo prefiere la experiencia integrada de despliegue de Fabric y sus capacidades se adaptan a tus necesidades de despliegue. Puedes desplegar entre espacios de trabajo desde la interfaz de Fabric sin mantener pipelines de lanzamiento externos, y usar APIs para automatización cuando sea necesario. Este enfoque también puede adaptarse a equipos con experiencia limitada con herramientas DevOps, como Azure Pipelines o Acciones de GitHub.
  • Cuando utilice el control de código fuente solo para fines de desarrollo y prefiera implementar los cambios directamente entre las fases de la canalización de versiones.
  • Cuando las reglas de implementación, la autovinculación y otras API disponibles son suficientes para administrar las configuraciones entre las fases del flujo de versión.
  • Cuando quiera usar otras funcionalidades de las canalizaciones de implementación de Fabric, como la visualización de cambios en Fabric, el historial de implementaciones, etc.
  • Considere que, además, las canalizaciones de implementación en Fabric tienen una estructura lineal y requieren otros permisos para crear y administrar las canalizaciones.

Opción 4: CI/CD para ISV en Fabric (administrando múltiples clientes o soluciones)

Diagrama que muestra una etiqueta de lanzamiento que activa el despliegue compartido de pruebas, seguido de validación y aprobación antes de desplegar la misma etiqueta y SHA en múltiples espacios de trabajo de producción del cliente con parámetros específicos del cliente.

Esta opción es diferente de las demás. Es más relevante para los proveedores de software independientes (ISV) que crean aplicaciones SaaS para sus clientes sobre Fabric. Los ISV suelen tener un área de trabajo independiente para cada cliente y pueden tener hasta varios cientos o miles de áreas de trabajo. Cuando la estructura de análisis que se proporciona a cada cliente es similar y predefinida, recomendamos tener un proceso centralizado de desarrollo y pruebas que se separe para cada cliente solo en la fase de Producción.

Esta opción se basa en la opción #2:

  1. Los desarrolladores trabajan en la rama Dev y el espacio de trabajo Dev, y seleccionan cuidadosamente los cambios que quieren lanzar de Dev a Main, como se describe en la opción #2.
  2. Crea y empuja una etiqueta release en el commit elegido en Main, por ejemplo v1.5.0. La etiqueta activa un flujo de trabajo de Acciones de GitHub o un pipeline de Azure DevOps.
  3. La tubería resuelve la etiqueta en un commit SHA, registra ambos, ejecuta pruebas unitarias y ajusta las definiciones etiquetadas para Test compartido. Los despliega utilizando fabric-cicd o la Bulk Import Item Definitions API, como se describe en la opción #2. Realiza pruebas automatizadas o manuales tras el despliegue. Si falla la validación, detén la promoción, arregla el problema en Dev, lleva la solución a Main y crea una nueva etiqueta para otra ejecución.
  4. Una vez que la validación tenga éxito y se conceda la aprobación de producción configurada, despliega la misma etiqueta y SHA del commit registrado en el espacio de trabajo Prod de cada cliente. Aplica parámetros y conexiones específicos para cada cliente antes del despliegue o a través de APIs posteriores al despliegue. Los despliegues de clientes independientes pueden ejecutarse en paralelo. Registra la etiqueta, el commit SHA y el objetivo del cliente en el historial de despliegue del entorno para que la versión desplegada de cada cliente sea rastreable.

¿Cuándo debe considerar la posibilidad de usar la opción 4?

  • Es un ISV que desarrolla aplicaciones sobre Fabric.
  • Usa diferentes áreas de trabajo para cada cliente con el fin de administrar los múltiples inquilinos de su aplicación.
  • Para lograr una mayor separación, o para realizar pruebas específicas para diferentes clientes, es posible que desee implementar multitenencia en etapas anteriores de desarrollo o pruebas. En ese caso, tenga en cuenta que con varios inquilinos el número de áreas de trabajo necesarias crece significativamente.

Resumen

Este artículo resume las principales opciones de CI/CD para un equipo que quiere crear un proceso automatizado de CI/CD en Fabric. Aunque exponemos cuatro opciones, las limitaciones de la vida real y la arquitectura de la solución podrían prestarse a opciones híbridas o completamente diferentes. Puede usar este artículo para guiarse por las diferentes opciones y cómo compilarlas, pero no está obligado a elegir solo una de ellas.

Algunos escenarios o elementos específicos pueden tener limitaciones que le impidan adoptar cualquiera de estos escenarios.

Lo mismo sucede con las herramientas. Aunque mencionamos diferentes herramientas aquí, puede elegir otras herramientas que pueden proporcionar el mismo nivel de funcionalidad. Tenga en cuenta que Fabric tiene una mejor integración con algunas herramientas, por lo que elegir otras dan lugar a más limitaciones que necesitan soluciones alternativas diferentes.