Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Você pode usar o script do PowerShell do replicador de assinatura Azure Stack Hub para copiar recursos entre assinaturas Azure Stack Hub, em Azure Stack Hub selos ou entre Azure Stack Hub e Azure. O script do replicador lê e recria os recursos de Azure Resource Manager de diferentes assinaturas de Azure e Azure Stack Hub. Este artigo explica como o script funciona, como você pode usar o script e fornece uma referência para operações de script.
Você pode encontrar os scripts usados neste artigo no repositório GitHub padrões de borda inteligente Azure. Os scripts estão na pasta do replicador de assinatura .
Visão geral do replicador de assinatura
O replicador de assinatura Azure é modular. Essa ferramenta usa um processador principal que orquestra a replicação de recursos. Além disso, a ferramenta dá suporte a processadores personalizáveis que atuam como modelos para copiar diferentes tipos de recursos.
O processador principal consiste nos três scripts a seguir:
resource_retriever.ps1
Gera pastas para armazenar arquivos de saída.
Define o contexto para a assinatura de origem.
Recupera os recursos e os passa para resource_processor.ps1.
resource_processor.ps1
Processa o recurso passado por resource_retriever.ps1.
Determina qual processador personalizado usar e passa os recursos.
post_process.ps1
O Post processa a saída gerada pelo processador personalizado para prepará-la para ser implantada na assinatura de destino.
Gera o código de implantação para implantar os recursos na assinatura de destino.
Os três scripts controlam o fluxo de informações de maneira padrão para permitir maior flexibilidade. Adicionar suporte para recursos adicionais, por exemplo, não requer a alteração de nenhum código no processador principal.
Processadores personalizados, mencionados anteriormente, são ps1 arquivos que determinam como um determinado tipo de recurso deve ser processado. O nome de um processador personalizado sempre usa os dados de tipo em um recurso. Por exemplo, supondo que $vm contém um objeto de máquina virtual, executando $vm. O tipo gera Microsoft.Compute/virtualMachines. Isso significa que um processador para uma máquina virtual é nomeado virtualMachines_processor.ps1. O nome deve ser exatamente como aparece nos metadados do recurso, pois o processador principal o usa para determinar qual processador personalizado usar.
Um processador personalizado determina como um recurso deve ser replicado determinando quais informações são importantes e ditando como essas informações devem ser retiradas dos metadados do recurso. Em seguida, o processador personalizado usa todos os dados extraídos e os usa para gerar um arquivo de parâmetros que funciona com um modelo Azure Resource Manager para implantar o recurso na assinatura de destino. O script post_process.ps1 armazena esse arquivo de parâmetros na pasta Parameter_Files depois que ele é pós-processado.
Há uma pasta na estrutura de arquivos do Replicador chamada Standardized_ARM_Templates. Dependendo do ambiente de origem, as implantações usam um desses modelos de Resource Manager padronizados ou talvez seja necessário gerar um modelo de Resource Manager personalizado. Nesse caso, um processador personalizado deve chamar um gerador de modelo Resource Manager. No exemplo iniciado anteriormente, o nome de um gerador de modelo de Resource Manager para máquinas virtuais é virtualMachines_ARM_Template_Generator.ps1. O gerador de modelo de Resource Manager é responsável por criar um modelo de Resource Manager personalizado com base em quais informações estão nos metadados de um recurso. Por exemplo, se o recurso de máquina virtual tiver metadados especificando que ele é membro de um conjunto de disponibilidade, o gerador de modelo Resource Manager criará um modelo de Resource Manager com o código que especifica a ID do conjunto de disponibilidade do qual a máquina virtual faz parte. Dessa forma, quando a máquina virtual é implantada na nova assinatura, ela é adicionada automaticamente ao conjunto de disponibilidade após a implantação. Esses modelos de Resource Manager personalizados são armazenados na pasta Custom_ARM_Templates localizada dentro da pasta Standardized_ARM_Templates. O script post_processor.ps1 é responsável por determinar se uma implantação deve usar um modelo de Resource Manager padronizado ou personalizado e gerar o código de implantação correspondente.
O scriptpost-process.ps1 é responsável por limpar os arquivos de parâmetros e criar os scripts que o usuário usa para implantar os novos recursos. Durante a fase de limpeza, o script substitui todas as referências à ID da assinatura de origem, à ID do locatário e ao local pelos valores de destino correspondentes. Em seguida, ele gera o arquivo de parâmetros para a pasta Parameter_Files . Em seguida, ele determina se o recurso que está sendo processado usa um modelo de Resource Manager personalizado ou não e gera o código de implantação correspondente, que usa o cmdlet New-AzResourceGroupDeployment. Em seguida, o código de implantação é adicionado ao arquivo chamado DeployResources.ps1 armazenado na pasta Deployment_Files . Por fim, o script determina o grupo de recursos ao qual o recurso pertence e verifica o script DeployResourceGroups.ps1 para ver se o código de implantação para implantar esse grupo de recursos já existe. Caso contrário, o script adicionará código a esse script para implantar o grupo de recursos. Se isso acontecer, o script não fará nada.
Recuperação de API dinâmica
A ferramenta inclui a recuperação dinâmica da API, portanto, ela usa a versão mais recente da API do provedor de recursos disponível na assinatura de origem para implantar os recursos na assinatura de destino:
No entanto, a assinatura de destino pode ter uma versão mais antiga da API do provedor de recursos que não dá suporte à versão fornecida pela assinatura de origem. Nesse caso, ocorre um erro quando você executa a implantação. Para resolver esse erro, atualize os provedores de recursos na assinatura de destino para corresponder aos da assinatura de origem.
Implantações paralelas
A ferramenta requer um parâmetro chamado paralelo. Esse parâmetro usa um valor booliano que especifica se os recursos recuperados devem ser implantados em paralelo. Se você definir o valor como true, cada chamada para New-AzResourceGroupDeployment incluirá o sinalizador -asJob . O processo adiciona blocos de código que aguardam a conclusão de trabalhos paralelos entre conjuntos de implantações de recursos com base nos tipos de recursos. Ele garante que todos os recursos de um tipo sejam implantados antes de implantar o próximo tipo de recurso. Se você definir o valor do parâmetro paralelo como false, os recursos serão implantados em série.
Adicionar tipos de recursos adicionais
Adicionar novos tipos de recursos é simples. Crie um processador personalizado e um modelo de Resource Manager ou um gerador de modelo Resource Manager. Depois de concluir essas etapas, adicione o tipo de recurso ao ValidateSet para o parâmetro $resourceType e a matriz $resourceTypes em resource_retriever.ps1. Quando você adicionar o tipo de recurso à matriz $resourceTypes , adicione-o na ordem correta. A ordem da matriz determina a ordem em que os recursos são implantados, portanto, tenha as dependências em mente. Por fim, se o processador personalizado usar um gerador de modelo Resource Manager, adicione o nome do tipo de recurso à matriz $customTypes em post_process.ps1.
Executar Azure replicador de assinatura
Para executar a ferramenta Azure replicador de assinatura (v3), inicie resource_retriever.ps1 e forneça todos os parâmetros. Para o parâmetro resourceType , você pode escolher Todos em vez de um tipo de recurso. Se você selecionar Todos, resource_retriever.ps1 processará todos os recursos em uma ordem para que, quando a implantação for executada, os recursos dependentes sejam implantados primeiro. Por exemplo, as VNets são implantadas antes das máquinas virtuais, pois as máquinas virtuais exigem que uma VNet esteja em vigor para que elas sejam implantadas corretamente.
Quando o script termina de ser executado, há três novas pastas: Deployment_Files, Parameter_Files e Custom_ARM_Templates.
Note
Antes de executar qualquer um dos scripts gerados, defina o ambiente certo e entre na assinatura de destino (no novo Azure Stack Hub, por exemplo). Defina o diretório de trabalho como a pasta Deployment_Files .
Deployment_Files contém dois arquivos: DeployResourceGroups.ps1 e DeployResources.ps1. Quando você executa DeployResourceGroups.ps1, ele implanta os grupos de recursos. Quando você executa DeployResources.ps1, ele implanta todos os recursos que foram processados. Se você executar a ferramenta com Tudo ou Microsoft. Compute/virtualMachines como o tipo de recurso, DeployResources.ps1 solicita que você insira uma senha de administrador de máquina virtual que ela usa para criar todas as máquinas virtuais.
Exemplo
Executar o script.
Note
Não se esqueça de configurar o ambiente de origem e o contexto de assinatura para a instância do PS.
Examine as pastas recém-criadas:
Defina o contexto para a assinatura de destino, altere a pasta para Deployment_Files, implante os grupos de recursos (execute o
DeployResourceGroups.ps1script) e inicie a implantação do recurso (execute oDeployResources.ps1script).Execute
Get-Jobpara verificar o status. Get-Job | Receive-Job retornará os resultados.
Limpeza
Dentro da replicatorV3 pasta, o arquivo cleanup_generated_items.ps1 remove as pastas Deployment_Files, Parameter_Files e Custom_ARM_Templates e todo o conteúdo.
Operações do replicador de assinatura
O replicador de assinatura Azure (v3) pode replicar atualmente os seguintes tipos de recurso:
Microsoft.Compute/availabilitySets
Microsoft.Compute/maquinasVirtuais
Microsoft.Network/loadBalancers
Microsoft.Network/networkSecurityGroups
Microsoft. Network/publicIPAddresses
Microsoft.Network/routeTables
Microsoft.Network/virtualNetworks
Microsoft.Network/virtualNetworkGateways
Microsoft.Storage/storageAccounts
Quando você executa a ferramenta com All como o tipo de recurso, ela segue a ordem na lista a seguir ao replicar e implantar. Na lista a seguir, todos os recursos têm sua configuração replicada, como sku, oferta e outras configurações:
Microsoft.Network/virtualNetworks
- Replica: - Todos os espaços de endereço - Todas as sub-redes
Microsoft.Network/virtualNetworkGateways
- Replica: – Configuração de IP público – Configuração de sub-rede – Tipo de VPN – Tipo de gateway
Microsoft.Network/routeTables
Microsoft.Network/networkSecurityGroups
- Replica: – Todas as regras de segurança de entrada e saída
Microsoft. Network/publicIPAddresses
Microsoft.Network/loadBalancers
- Replica: - Endereços IP privados - Configuração de endereço IP público - Configuração de sub-rede
Microsoft.Compute/availabilitySets
- Replica: – Número de domínios de falha – Número de domínios de atualização
Microsoft.Storage/storageAccounts
Microsoft.Compute/maquinasVirtuais
- Replica:
- Discos de dados (sem dados)
- Tamanho da máquina virtual
– Sistema operacional
– Configuração da conta de armazenamento de diagnóstico
– Configuração de IP público
– Interface de rede
– Endereço IP privado da Interface de Rede
– Configuração do Grupo de Segurança de Rede
– Configuração do conjunto de disponibilidade
- Replica:
Note
Esse processo só cria discos gerenciados para o disco do sistema operacional e discos de dados. Atualmente, ele não dá suporte ao uso de contas de armazenamento.
Limitações
A ferramenta pode replicar recursos de uma assinatura para outra, desde que a assinatura de destino dê suporte a todos os tipos de recursos e opções que você está replicando da assinatura de origem. Para garantir a replicação bem-sucedida, verifique se as versões do provedor de recursos da assinatura de destino correspondem às da assinatura de origem.
Para garantir a replicação bem-sucedida, verifique se as versões do provedor de recursos da assinatura de destino correspondem às da assinatura de origem.
Quando você replica recursos de Azure comerciais para Azure comerciais ou de uma assinatura dentro de Azure Stack Hub para outra assinatura no mesmo Azure Stack Hub, você encontra problemas ao replicar contas de armazenamento. Esse problema ocorre porque os nomes das contas de armazenamento devem ser exclusivos em todos os Azure comerciais ou em todas as assinaturas em uma região ou instância Azure Stack Hub. Você pode replicar com êxito contas de armazenamento em diferentes instâncias de Azure Stack Hub porque as Pilhas são regiões ou instâncias separadas.