Plantillas del Administrador de Recursos vinculadas con CI/CD

SE APLICA A: Azure Data Factory Azure Synapse Analytics

Sugerencia

Data Factory en Microsoft Fabric es la próxima generación de Azure Data Factory, con una arquitectura más sencilla, inteligencia artificial integrada y nuevas características. Si no está familiarizado con la integración de datos, comience con Fabric Data Factory. Las cargas de trabajo de ADF existentes pueden actualizarse a Fabric para acceder a nuevas funcionalidades en ciencia de datos, análisis en tiempo real e informes.

Si ha configurado la integración continua y entrega continua (CI/CD) para las factorías de datos, puede que supere los límites de la plantilla de Azure Resource Manager a medida que la fábrica crece más. Por ejemplo, un límite es el número máximo de recursos de una plantilla de Resource Manager. Para dar cabida a grandes fábricas al generar la plantilla de Resource Manager completa para una factoría, Data Factory ahora genera plantillas de Resource Manager vinculadas. Con esta característica, la carga de fábrica completa se divide en varios archivos, de modo que no te veas limitado por los límites.

Búsqueda de las plantillas vinculadas

Si ha configurado Git, las plantillas vinculadas se generan y guardan junto con las plantillas de Resource Manager completas de la rama adf_publish en una nueva carpeta denominada linkedTemplates:

Carpeta de plantillas vinculadas de Resource Manager

Las plantillas de Resource Manager vinculadas normalmente constan de una plantilla base y un conjunto de plantillas secundarias vinculadas a la base. La plantilla principal se denomina ArmTemplate_master.json y las plantillas secundarias se denominan con el patrón ArmTemplate_0.json, ArmTemplate_1.json, etc.

Uso de plantillas vinculadas

Para usar plantillas vinculadas en lugar de la plantilla de Resource Manager completa, actualice la tarea de CI/CD para que apunte a ArmTemplate_master.json en lugar de ArmTemplateForFactory.json (la plantilla de Resource Manager completa). Resource Manager también requiere que cargue las plantillas vinculadas en una cuenta de almacenamiento para que Azure pueda acceder a ellas durante la implementación. Para obtener más información, consulta Implementación de plantillas vinculadas de Resource Manager con VSTS.

Puesto que se trata de una plantilla vinculada, la tarea de implementación de ARM requiere la URL de la cuenta de almacenamiento y el token de SAS. El token de SAS es necesario incluso si service Principle tiene acceso al blog, ya que las plantillas vinculadas se implementan dentro de Azure sin contexto del usuario. Para lograrlo, la plantilla vinculada generada por los pasos de CI/CD requiere los parámetros containerURI y containerSasToken. Se recomienda enviar el token de SAS como un secreto, ya sea como una variable segura o desde un servicio como Azure Key Vault.

No se olvide de agregar los scripts de Data Factory en la canalización de CI/CD antes y después de la tarea de implementación.

Si no ha configurado Git, puede acceder a las plantillas vinculadas a través de Export ARM Template en la lista Plantilla de ARM.

Al implementar los recursos, debe especificar si la implementación es una actualización incremental o una actualización completa. La diferencia entre estos dos modos es cómo Resource Manager controla los recursos existentes en el grupo de recursos que no están en la plantilla. Revisar Modos de implementación.

Consideraciones sobre los entornos de ejecución de integración compartidos y autohospedados

Advertencia

Al implementar plantillas ARM vinculadas en un entorno que utiliza un tiempo de ejecución de integración (IR) vinculado (compartido) y autohospedado, la implementación de Resource Manager sobrescribirá la configuración del IR vinculado con una definición de IR autohospedado sin nodos registrados. Esto hace que el entorno de ejecución de integración deje de estar disponible, lo que interrumpirá todos los servicios vinculados que dependen de él. Esto ocurre porque las plantillas ARM vinculadas generadas durante la publicación siempre exportan los tiempos de ejecución de integración como recursos Microsoft.DataFactory/factories/integrationRuntimes independientes, sin tener en cuenta las relaciones de los tiempos de ejecución de integración vinculados en los entornos de destino.

Para evitar esto, agregue un paso en la canalización de CI/CD para quitar las definiciones de recursos de IR de los archivos de plantilla vinculados antes del paso de implementación de Resource Manager. Si el entorno de destino usa un nombre de IR diferente al de la factoría de origen, agregue un paso de cambio de nombre después de la eliminación. La interfaz de recursos compartida en el entorno de destino permanece intacta y todos los servicios vinculados continúan resolviéndose correctamente después de la implementación.

Contenido relacionado

  • Last updated on