¿Qué es un plan de despliegue en Microsoft Fabric? (versión preliminar)

Un plan de despliegue de Microsoft Fabric es un elemento de espacio de trabajo que añade el orden explícito de los elementos y acciones automatizadas a una operación de despliegue. Utiliza un plan para desplegar los elementos en una secuencia específica. También puedes usarlo para ejecutar un cuaderno, una tubería de datos u otro elemento compatible antes o después de que se despliegue un ítem.

Un plan de despliegue funciona con estas herramientas de despliegue:

• Integración de Git
• Tuberías de despliegue
• API de REST compatibles

En este artículo, herramienta de despliegue se refiere a cualquiera de estas herramientas soportadas. No se ejecuta un plan por sí solo. Lo conectas cuando inicias una operación con una herramienta de despliegue.

Cuándo utilizar un plan de despliegue

Utiliza un plan de despliegue cuando:

No necesitas un plan de despliegue cuando el orden estándar de la herramienta de despliegue es suficiente y no se requieren acciones.

Componentes del plan de despliegue

Un plan de despliegue contiene los siguientes componentes:

Para tipos de acciones soportadas y comportamiento de acciones, véase Acciones del plan de despliegue.

Cómo funciona un plan de despliegue

Cada operación de despliegue combina tres entradas:

• Elementos seleccionados: Los elementos seleccionados para la operación.
• Plan de despliegue: El orden explícito y las acciones asociadas a esos elementos.
• Linaje Fabric: Las dependencias que Fabric detecta entre los objetos.

Determinar el alcance del despliegue

La herramienta de despliegue determina la fuente, el objetivo y los elementos de la operación. Adjuntar un plan no sustituye esa selección. Los elementos seleccionados que no están en un grupo de despliegue siguen desplegándose usando el comportamiento estándar de la herramienta.

Adjuntar un plano no selecciona automáticamente los elementos a los que se refiere. En una superficie de despliegue selectivo, selecciona los elementos que quieres desplegar y asegúrate de que los elementos requeridos por las acciones del plan estén disponibles en el espacio de trabajo objetivo cuando se ejecuten.

Un plan de despliegue controla el despliegue y las acciones de los ítems. No despliega configuraciones a nivel de espacio de trabajo como identidades de espacios de trabajo, conexiones, enlaces de gateway o configuraciones de Spark. Configurar el espacio de trabajo objetivo antes de una acción depende de esas configuraciones.

Resolver el orden de despliegue

Fabric combina dependencias explícitas entre grupos de despliegue con dependencias detectadas por el linaje. Un plan puede añadir un orden que la línea de origen no representa, pero no elimina dependencias que Fabric detecta.

Para un escenario detallado que muestre cómo los elementos seleccionados, las dependencias del plan, la línea de identidad y las acciones en tiempo de ejecución funcionan conjuntamente, véanse ejemplos de planes de despliegue.

Ejecutar grupos de despliegue y acciones

Para cada grupo de despliegue, Fabric ejecuta sus acciones previas al despliegue, despliega el elemento del grupo y luego ejecuta sus acciones posteriores al despliegue. Las dependencias entre grupos y acciones determinan su orden. La posición de un elemento en el expediente de planos no define su orden.

Adjuntar un plano es opcional. Sin un plan, la herramienta de despliegue seleccionada utiliza su comportamiento estándar.

Adjuntar un plan de despliegue

Puedes adjuntar un plan cuando usas una operación de integración de Git soportada, despliegues contenido a través de una tubería de despliegue o llamas a una API REST soportada. El archivo adjunto solo se aplica a esa operación. Para las superficies soportadas y el comportamiento de selección de planos, véase Adjuntar un plan de despliegue.

Crear y redactar un plan de despliegue

Crea un plan en el canvas del plan de despliegue, donde añades grupos de despliegue, defines su orden y configuras acciones. Para las instrucciones, véase Crear un plan de despliegue.

Un plan de despliegue es un elemento del espacio de trabajo. Cuando el espacio de trabajo esté conectado a Git, confirma el plan junto con los elementos a los que hace referencia para que el plan pueda avanzar en tu proceso de CI/CD.

Si una operación falla

La operación se detiene cuando falla un ítem o acción y no revierte el trabajo completado. Para el comportamiento de fallos y los pasos de resolución, consulte Planes de despliegue de resolución de problemas.

Consideraciones y limitaciones

Limitaciones del plan general de despliegue

• No puedes usar un solo plan para desplegar en más de un espacio de trabajo en una sola ejecución.
• Solo puedes adjuntar un plan de despliegue a una operación de despliegue.

Limitaciones para adjuntar un plan

• Un anexo de plano solo se aplica a la operación actual. No puedes configurar un plan como estándar para futuros despliegues ni programar el plan en sí. Si una herramienta de despliegue programa una operación, la operación debe adjuntar el plan cada vez que se ejecuta.
• No puedes adjuntar un plan a una operación de importación de un solo artículo.
• La fabric-cicd biblioteca no soporta planes de despliegue.

Limitaciones durante un despliegue

• No puedes desplegar grupos de despliegue independientes en paralelo.
• Un despliegue fallido no se revierte. Los elementos que ya se han desplegado permanecen en el espacio de trabajo objetivo, y los posteriores no se despliegan.

Limitaciones para las acciones del plan

• Solo las combinaciones compatibles de elemento y tipo de tarea pueden ejecutarse como acciones previas o posteriores al despliegue. Consulta Tipos de objetos que puedes ejecutar como acción.
• No puedes usar el mismo elemento de Dataflow Gen2 en más de una acción de un plan. Su tarea de actualización no puede ejecutarse en más de una instancia simultáneamente, así que el lienzo le avisa cuando añade la segunda instancia, y esta se bloquea durante la implementación.
• No puedes devolver más de 512 KB en una acción de función de datos de usuario. La producción mayor se trunca. La acción sigue teniendo éxito.
• No puedes hacer que una acción espere a que los servicios a los que suministra datos se pongan al día. Una acción se completa cuando la acción en sí termina, por lo que la siguiente acción puede comenzar antes de que los datos que generó puedan consultarse.
• No puedes usar un plan de despliegue para cambiar el conjunto de valores activos de una Biblioteca de Variables durante el despliegue. Las referencias a variables se resuelven según el conjunto de valores que ya está activo en el espacio de trabajo de destino. En un espacio de trabajo objetivo recién creado, el valor predeterminado está activo hasta que selecciones y guardes otro conjunto de valores. Para más información, consulte CI/CD de la biblioteca de variables.

Limitaciones para la creación de planes

• No puedes añadir más de un elemento a un grupo de despliegue.
• El lienzo solo soporta diseño automático.

Límites de tamaño del plan de despliegue

Un plan que supere cualquiera de estos límites se rechaza al guardarlo. Los límites se aplican siempre que se guarda un plan, por lo que se aplican tanto al canvas, a la API REST, a una consulta de Git como a herramientas externas.

Contenido relacionado

• Crear un plan de implementación
• Ejemplos de planes de despliegue
• Introducción al CI/CD en Microsoft Fabric
• Introducción a la integración de Git
• Introducción a las canalizaciones de implementación
• Elige un flujo de trabajo de CI/CD en Fabric
• Comprender la vinculación de dependencias en el despliegue entre espacios de trabajo