pulumi-arm-to-pulumi

Acerca de pulumi-arm-to-pulumi

Un flujo de trabajo estructurado para convertir o migrar plantillas de Azure ARM (Azure Resource Manager), Bicep o código de Azure a Pulumi, incluida la importación de recursos existentes de Azure a la gestión de Pulumi. Está pensado para cargarse cada vez que se solicite dicha migración, conversión o importación, y revisará cualquier plan de migración ya elaborado antes de que se cargara la habilidad para adaptarlo a sus requisitos.

Los criterios de éxito son estrictos: cada recurso ARM debe aparecer en el programa de Pulumi o estar explícitamente justificado en el informe; el resultado debe ser estructuralmente válido y permitir una vista previa satisfactoria en Pulumi; y, al importar recursos existentes, la vista previa debe mostrar cero diferencias (sin creaciones, actualizaciones, sustituciones ni eliminaciones), resolviéndose cualquier diferencia mediante un flujo de trabajo de resolución de la vista previa. Siempre se genera un informe de migración formal adecuado para una solicitud de incorporación de cambios (pull request), que abarca la correspondencia de recursos de ARM a Pulumi, las decisiones sobre proveedores, las diferencias de comportamiento y los pasos manuales.

El flujo de trabajo se desarrolla en orden. La recopilación de información verifica las credenciales de Azure (utilizando un entorno ESC y «az login») y analiza la plantilla de ARM con «jq» para extraer tipos de recursos, parámetros, variables, matrices «dependsOn», bucles de copia y condiciones, creando opcionalmente un inventario de recursos con «az resource list» y «show». La conversión del código es manual, ya que no existe un conversor ARM automatizado; se utiliza por defecto el proveedor nativo de Azure, con el proveedor clásico de Azure como alternativa, conservando todas las condiciones, bucles y dependencias en el lenguaje elegido por el usuario. La importación opcional de recursos utiliza la opción de importación de recursos en línea con identificadores de recursos de Azure que siguen una ruta predecible de suscripción, grupo de recursos y proveedor, y a continuación comprueba que no haya diferencias. Por último, la configuración de la pila se ajusta para que coincida con los parámetros de ARM. Los archivos de referencia complementarios «arm-conversion-patterns.md» y «arm-import.md» proporcionan los patrones de mapeo detallados y los procedimientos de importación y depuración de diferencias nulas.

Preguntas frecuentes

¿Existe alguna herramienta automatizada para convertir plantillas de ARM?

No. La habilidad indica que la conversión de ARM a Pulumi requiere una traducción manual y que el usuario es responsable de la conversión completa, aunque los patrones de referencia sirven de guía para la correspondencia.

¿Qué proveedor de Pulumi debo utilizar?

Utiliza por defecto @pulumi/azure-native para obtener una cobertura completa de la API de Azure Resource Manager y recurre al proveedor clásico @pulumi/azure cuando azure-native no disponga de una característica o se necesite una abstracción más sencilla.

¿Qué significa la validación de importación «zero-diff»?

Tras importar recursos existentes, la vista previa de Pulumi no debe mostrar ninguna creación, actualización, sustitución ni eliminación. Cualquier diferencia se resuelve mediante el flujo de trabajo de resolución de la vista previa descrito en arm-import.md.

¿Cómo se configuran las credenciales de Azure?

A través de un entorno ESC que proporciona las credenciales, utilizando pulumi env run con az login (entidad de servicio y token federado) y, a continuación, verificándolas con az account show. La skill pregunta qué entorno ESC se debe utilizar si no se especifica ninguno.

¿Qué se entrega al final de una migración?

Un informe de migración formal adecuado para una solicitud de incorporación de cambios (pull request), que incluye la correspondencia de recursos de ARM a Pulumi, las decisiones sobre proveedores, las diferencias de comportamiento, cualquier paso que falte o que deba realizarse manualmente, y las instrucciones de validación.

Todos los archivos