Migrar do Orchestrator para a Automatização do Azure (Beta)

  • Artigo

Os runbooks no System Center 2012 - Orchestrator são baseados em atividades de pacotes de integração escritos especificamente para o Orchestrator , enquanto os runbooks na Automação do Azure são baseados no Windows PowerShell. Os runbooks gráficos na Automação do Azure têm uma aparência semelhante aos runbooks do Orchestrator, com suas atividades representando cmdlets do PowerShell, runbooks filho e ativos. Além de converter runbooks em si, você deve converter os pacotes de integração com as atividades que os runbooks usam para módulos de integração com cmdlets do Windows PowerShell.

A Automação de Gerenciamento de Serviços (SMA) armazena e executa runbooks em seu datacenter local, como o Orchestrator, e usa os mesmos módulos de integração da Automação do Azure. O Runbook Converter converte runbooks do Orchestrator em runbooks gráficos, que não são suportados no SMA. Você ainda pode instalar o Módulo de Atividades Padrão e os Módulos de Integração do System Center Orchestrator no SMA, mas deve reescrever manualmente seus runbooks.

Baixe o kit de ferramentas de migração do Orchestrator

A primeira etapa da migração é baixar o System Center Orchestrator Migration Toolkit. Este kit de ferramentas inclui ferramentas para ajudá-lo na conversão de runbooks do Orchestrator para a Automação do Azure.

Importar o módulo Atividades Padrão

Importe o Módulo de Atividades Padrão para a Automação do Azure. Isso inclui versões convertidas de atividades padrão do Orchestrator que runbooks gráficos convertidos podem usar.

Importar módulos de integração do Orchestrator

A Microsoft fornece pacotes de integração para a criação de runbooks para automatizar componentes do System Center e outros produtos. Alguns desses pacotes de integração são atualmente baseados em OIT, mas atualmente não podem ser convertidos em módulos de integração devido a problemas conhecidos. Importe os Módulos de Integração do System Center Orchestrator para a Automação do Azure para os pacotes de integração usados por seus runbooks que acessam o System Center. Este pacote inclui versões convertidas dos pacotes de integração que podem ser importados para a Automação do Azure e a Automação do Gerenciamento de Serviços.

Converter pacotes de integração

Use o Conversor de Pacotes de Integração para converter quaisquer pacotes de integração criados usando o Orchestrator Integration Toolkit (OIT) em módulos de integração baseados em PowerShell que podem ser importados para a Automação do Azure ou para a Automação de Gerenciamento de Serviços. Quando executa o Conversor do Integration Pack, é-lhe apresentado um assistente que lhe permite selecionar um ficheiro de pacote de integração (.oip). Em seguida, o assistente lista as atividades incluídas nesse pacote de integração e permite que você selecione quais atividades migrar. Quando você conclui o assistente, ele cria um módulo de integração que inclui um cmdlet correspondente para cada uma das atividades do pacote de integração original.

Nota

Não é possível usar o Integration Pack Converter para converter pacotes de integração que não foram criados com o OIT. Há também alguns pacotes de integração fornecidos pela Microsoft que atualmente não podem ser convertidos com essa ferramenta. As versões convertidas desses pacotes de integração são fornecidas para download para que possam ser instaladas na Automação do Azure ou na Automação do Gerenciamento de Serviços.

Parâmetros

Todas as propriedades de uma atividade no pacote de integração são convertidas em parâmetros do cmdlet correspondente no módulo de integração. Os cmdlets do Windows PowerShell têm um conjunto de parâmetros comuns que podem ser usados com todos os cmdlets. Por exemplo, o parâmetro -Verbose faz com que um cmdlet produza informações detalhadas sobre sua operação. Nenhum cmdlet pode ter um parâmetro com o mesmo nome de um parâmetro comum. Se uma atividade tiver uma propriedade com o mesmo nome de um parâmetro comum, o assistente solicitará que você forneça outro nome para o parâmetro.

Monitorar atividades

Os runbooks de monitor no Orchestrator começam com uma atividade de monitor e são executados continuamente aguardando serem invocados por um evento específico. A Automação do Azure não dá suporte a runbooks de monitor, portanto, nenhuma atividade de monitor no pacote de integração é convertida. Em vez disso, um cmdlet de espaço reservado é criado no módulo de integração para a atividade do monitor. Este cmdlet não tem funcionalidade, mas permite que qualquer runbook convertido que o use seja instalado. Este runbook não pode ser executado na Automação do Azure, mas pode ser instalado para que você possa modificá-lo.

O Orchestrator inclui um conjunto de atividades padrão que não estão incluídas em um pacote de integração, mas são usadas por muitos runbooks. O módulo Atividades Padrão é um módulo de integração que inclui um cmdlet equivalente para cada uma dessas atividades. Você deve instalar esse módulo de integração na Automação do Azure antes de importar qualquer runbook convertido que use uma atividade padrão.

Além de dar suporte a runbooks convertidos, os cmdlets no módulo de atividades padrão podem ser usados por alguém familiarizado com o Orchestrator para criar novos runbooks na Automação do Azure. Embora a funcionalidade de todas as atividades padrão possa ser executada com cmdlets, eles podem operar de forma diferente. Os cmdlets no módulo de atividades padrão convertido funcionam da mesma maneira que suas atividades correspondentes e usam os mesmos parâmetros. Isso pode ajudá-lo na transição para runbooks de Automação do Azure.

Converter runbooks do Orchestrator

O Orchestrator Runbook Converter converte runbooks do Orchestrator em runbooks gráficos que podem ser importados para a Automação do Azure. O Runbook Converter é implementado como um módulo do PowerShell com o cmdlet ConvertFrom-SCORunbook que faz a conversão. Quando você instala o conversor, ele cria um atalho para uma sessão do PowerShell que carrega o cmdlet.

Aqui estão as etapas básicas para converter um runbook e importá-lo para a Automação do Azure. Os detalhes do uso do cmdlet são fornecidos posteriormente nesta seção.

  1. Exporte um ou mais runbooks do Orchestrator.
  2. Obter módulos de integração para todas as atividades no runbook.
  3. Converta os runbooks do Orchestrator no arquivo exportado.
  4. Revise as informações nos logs para validar a conversão e determinar as tarefas manuais necessárias.
  5. Importe runbooks convertidos para a Automação do Azure.
  6. Crie todos os ativos necessários na Automação do Azure.
  7. Edite o runbook na Automação do Azure para modificar quaisquer atividades necessárias.

A sintaxe para ConvertFrom-SCORunbook é:

ConvertFrom-SCORunbook -RunbookPath <string> -Module <string[]> -OutputFolder <string>
  • RunbookPath - Caminho para o arquivo de exportação que contém os runbooks a serem convertidos.
  • Módulo - Lista delimitada por vírgulas de módulos de integração contendo atividades nos runbooks.
  • OutputFolder - Caminho para a pasta para criar runbooks gráficos convertidos.

O comando de exemplo a seguir converte os runbooks em um arquivo de exportação chamado MyRunbooks.ois_export. Esses runbooks usam os pacotes de integração do Ative Directory e do Data Protection Manager.

ConvertFrom-SCORunbook -RunbookPath "c:\runbooks\MyRunbooks.ois_export" -Module c:\ip\SystemCenter_IntegrationModule_ActiveDirectory.zip,c:\ip\SystemCenter_IntegrationModule_DPM.zip -OutputFolder "c:\runbooks"

Usar arquivos de log do Runbook Converter

O Runbook Converter cria os seguintes arquivos de log no mesmo local que o runbook convertido. Se os arquivos já existirem, eles serão substituídos por informações da última conversão.

Ficheiro Conteúdo
Runbook Converter - Progresso.log Etapas detalhadas da conversão, incluindo informações para cada atividade convertida com sucesso e aviso para cada atividade não convertida.
Runbook Converter - Resumo.log Resumo da última conversão, incluindo quaisquer avisos e tarefas de acompanhamento que você precisa executar, como a criação de uma variável necessária para o runbook convertido.

Exportar runbooks do Orchestrator

O Runbook Converter funciona com um arquivo de exportação do Orchestrator que contém um ou mais runbooks. Ele cria um runbook de Automação do Azure correspondente para cada runbook do Orchestrator no arquivo de exportação.

Para exportar um runbook do Orchestrator, clique com o botão direito do mouse no nome do runbook no Runbook Designer e selecione Exportar. Para exportar todos os runbooks em uma pasta, clique com o botão direito do mouse no nome da pasta e selecione Exportar.

Converter atividades de runbook

O Runbook Converter converte cada atividade no runbook do Orchestrator em uma atividade correspondente na Automação do Azure. Para as atividades que não podem ser convertidas, uma atividade de espaço reservado é criada no runbook com texto de aviso. Depois de importar o runbook convertido para a Automação do Azure, você deve substituir qualquer uma dessas atividades por atividades válidas que executam a funcionalidade necessária.

Todas as atividades do Orchestrator no Módulo de Atividades Padrão são convertidas. Existem algumas atividades padrão do Orchestrator que não estão neste módulo e não são convertidas. Por exemplo, não tem equivalente à Automação do Azure, Send Platform Event uma vez que o evento é específico do Orchestrator.

As atividades de monitoramento não são convertidas, pois não há equivalente a elas na Automação do Azure. As exceções são atividades de monitoramento em pacotes de integração convertidos que são convertidos para a atividade de espaço reservado.

Qualquer atividade de um pacote de integração convertido é convertida se você fornecer o caminho para o módulo de integração com o modules parâmetro. Para os Pacotes de Integração do System Center, você pode usar os Módulos de Integração do System Center Orchestrator.

Gerenciar recursos do Orchestrator

O Runbook Converter converte apenas runbooks, não outros recursos do Orchestrator, como contadores, variáveis ou conexões. Não há suporte para contadores na Automação do Azure. Variáveis e conexões são suportadas, mas você deve criá-las manualmente. Os arquivos de log informam se o runbook requer esses recursos e especificam os recursos correspondentes que você precisa criar na Automação do Azure para que o runbook convertido funcione corretamente.

Por exemplo, um runbook pode usar uma variável para preencher um determinado valor em uma atividade. O runbook convertido converte a atividade e especifica um ativo variável na Automação do Azure com o mesmo nome da variável Orchestrator. Esta ação é anotada no arquivo Runbook Converter - Summary.log que é criado após a conversão. Você deve criar manualmente esse ativo variável na Automação do Azure antes de usar o runbook.

Trabalhar com parâmetros de entrada do Orchestrator

Os runbooks no Orchestrator aceitam parâmetros de entrada com a Initialize Data atividade. Se o runbook que está sendo convertido incluir essa atividade, um parâmetro de entrada no runbook de Automação do Azure será criado para cada parâmetro na atividade. Uma atividade de controle de Script de Fluxo de Trabalho é criada no runbook convertido que recupera e retorna cada parâmetro. Todas as atividades no runbook que usam um parâmetro de entrada referem-se à saída dessa atividade.

A razão pela qual essa estratégia é usada é espelhar melhor a funcionalidade no runbook do Orchestrator. As atividades em novos runbooks gráficos devem referir-se diretamente aos parâmetros de entrada usando uma fonte de dados de entrada Runbook.

Invoque a atividade do Runbook

Os runbooks no Orchestrator iniciam outros runbooks com a Invoke Runbook atividade. Se o runbook que está sendo convertido incluir essa atividade e a Wait for completion opção estiver definida, uma atividade de runbook será criada para ela no runbook convertido. Se a Wait for completion opção não estiver definida, será criada uma atividade de Script de Fluxo de Trabalho que usa Start-AzAutomationRunbook para iniciar o runbook . Depois de importar o runbook convertido para a Automação do Azure, você deve modificar essa atividade com as informações especificadas na atividade.

Criar ativos do Orchestrator

O Runbook Converter não converte ativos do Orchestrator. Você deve criar manualmente todos os ativos necessários do Orchestrator na Automação do Azure.

Configurar o Hybrid Runbook Worker

O Orchestrator armazena runbooks em um servidor de banco de dados e os executa em servidores runbook, ambos em seu datacenter local. Os runbooks na Automação do Azure são armazenados na nuvem do Azure e podem ser executados em seu datacenter local usando um Runbook Worker híbrido. Configure um trabalhador para executar seus runbooks convertidos do Orchestrator, pois eles são projetados para serem executados em servidores locais e acessarem recursos locais.