pulumi-arm-to-pulumi

Sobre pulumi-arm-to-pulumi

Um fluxo de trabalho estruturado para converter ou migrar modelos do Azure ARM (Azure Resource Manager), Bicep ou código do Azure para o Pulumi, incluindo a importação de recursos existentes do Azure para o gerenciamento do Pulumi. Ele deve ser carregado sempre que tal migração, conversão ou importação for solicitada e revisará qualquer plano de migração já elaborado antes do carregamento da habilidade, a fim de alinhá-lo aos seus requisitos.

Os critérios de sucesso são rigorosos: todo recurso ARM deve constar no programa do Pulumi ou ser explicitamente justificado no relatório; a saída deve ser estruturalmente válida e capaz de uma visualização bem-sucedida no Pulumi; e, ao importar recursos existentes, a visualização deve mostrar zero diferenças (sem criações, atualizações, substituições ou exclusões), com quaisquer diferenças resolvidas por meio de um fluxo de trabalho de resolução de visualização. Sempre é gerado um relatório formal de migração adequado para uma solicitação de pull, abrangendo o mapeamento de recursos de ARM para Pulumi, decisões sobre provedores, diferenças comportamentais e etapas manuais.

O fluxo de trabalho prossegue em ordem. A coleta de informações verifica as credenciais do Azure (usando um ambiente ESC e o comando `az login`) e analisa o modelo ARM com o `jq` para extrair tipos de recursos, parâmetros, variáveis, matrizes `dependsOn`, loops de cópia e condicionais, criando opcionalmente um inventário de recursos com os comandos `az resource list` e `show`. A conversão de código é manual, já que não há um conversor ARM automatizado; o padrão é o provedor azure-native, com o provedor classic azure como alternativa, preservando todas as condições, loops e dependências na linguagem escolhida pelo usuário. A importação opcional de recursos utiliza a opção de importação inline de recursos com IDs de recursos do Azure que seguem um caminho previsível de assinatura, grupo de recursos e provedor, validando-os em seguida para verificar se há zero diferenças. Por fim, a configuração da pilha é ajustada para corresponder aos parâmetros do ARM. As referências complementares `arm-conversion-patterns.md` e `arm-import.md` fornecem os padrões de mapeamento detalhados e os procedimentos de importação e depuração com diferenças nulas.

Perguntas frequentes

Existe uma ferramenta automatizada para converter modelos ARM?

Não. A habilidade indica que a conversão de ARM para Pulumi requer tradução manual e que você é responsável pela conversão completa, embora os padrões de referência orientem o mapeamento.

Qual provedor Pulumi devo usar?

Use @pulumi/azure-native como padrão para cobertura completa da API do Azure Resource Manager e recorra ao provedor clássico @pulumi/azure quando o azure-native não oferecer algum recurso ou for necessária uma abstração mais simples.

O que significa validação de importação com “zero-diff”?

Após importar recursos existentes, a visualização do Pulumi não deve mostrar nenhuma criação, atualização, substituição ou exclusão. Quaisquer diferenças são resolvidas com o fluxo de trabalho de resolução de visualização descrito em arm-import.md.

Como as credenciais do Azure são configuradas?

Por meio de um ambiente ESC que forneça credenciais, usando o comando `pulumi env run` com `az login` (entidade de serviço e token federado) e, em seguida, verificando com `az account show`. A skill pergunta qual ambiente ESC deve ser usado caso nenhum seja especificado.

O que é entregue ao final de uma migração?

Um relatório formal de migração adequado para uma solicitação de pull, incluindo o mapeamento de recursos de ARM para Pulumi, decisões sobre provedores, diferenças comportamentais, quaisquer etapas ausentes ou manuais e instruções de validação.

Todos os arquivos