Automatização do Azure tipos de runbook

A funcionalidade Automatização do Azure Process Automation suporta vários tipos de runbooks, conforme definido na tabela seguinte. Para conhecer o ambiente de automatização do processo, consulte a execução do Runbook em Automatização do Azure.

Tipo Descrição
Gráficos O runbook gráfico baseado no Windows PowerShell e criado e editado completamente no editor gráfico em portal do Azure.
Fluxo de trabalho gráfica PowerShell Livro gráfico baseado em Windows PowerShell Workflow e criado e editado completamente no editor gráfico em portal do Azure.
PowerShell Livro textual baseado em Windows PowerShell scripts.
Fluxo de Trabalho do PowerShell Livro textual baseado em Windows PowerShell scripts do fluxo de trabalho.
Python Livro textual baseado em Python scripts.

Tenha em conta as seguintes considerações ao determinar qual o tipo de utilização para um determinado livro de bordo.

Livros gráficos

Pode criar e editar livros gráficos e gráficos de fluxo de trabalho PowerShell utilizando o editor gráfico no portal do Azure. No entanto, não é possível criar ou editar este tipo de livro com outra ferramenta. Principais características dos livros gráficos:

  • Exportado para ficheiros na sua conta Demôm automação e depois importado para outra conta de Automação.
  • Gerar código PowerShell.
  • Convertido para ou a partir de livros gráficos de fluxo de trabalho PowerShell durante a importação.

Vantagens

  • Utilize a autoria de inserção visual-link-configure modelo.
  • Concentre-se na forma como os dados fluem através do processo.
  • Visualmente representam processos de gestão.
  • Inclua outros livros de ensaio como livros infantis para criar fluxos de trabalho de alto nível.
  • Incentivar a programação modular.

Limitações

  • Não se pode criar ou editar fora do portal do Azure.
  • Pode exigir uma atividade de código que contenha o código PowerShell para executar uma lógica complexa.
  • Não pode converter-se num dos formatos de texto, nem pode converter um livro de texto para formato gráfico.
  • Não é possível visualizar ou editar diretamente o código PowerShell que o fluxo de trabalho gráfico cria. Pode ver o código que cria em quaisquer atividades de código.
  • Não se pode publicar livros num Fissiário Híbrido Linux. Consulte os recursos do seu datacenter ou nuvem utilizando o Hybrid Runbook Worker.
  • Os livros gráficos não podem ser assinados digitalmente.

Livros powerShell

Os livros powerShell são baseados em Windows PowerShell. Edita diretamente o código do livro de texto utilizando o editor de texto no portal do Azure. Também pode usar qualquer editor de texto offline e importar o livro de bordo para Automatização do Azure.

A versão PowerShell é determinada pela versão Runtime especificada (ou seja, a pré-visualização da versão 7.1 ou 5.1). O serviço Automatização do Azure suporta o tempo de funcionamento mais recente do PowerShell.

A mesma caixa de areia Azure e Hybrid Runbook Worker podem executar livros powerShell 5.1 e PowerShell 7.1 lado a lado.

Nota

No momento da execução do runbook, se selecionar a versão runtime como 7.1 (pré-visualização), são utilizados os módulos PowerShell que visam a versão de tempo de execução 7.1 e se selecionar a Versão Runtime como 5.1, são utilizados os módulos PowerShell que visam a versão de tempo de execução 5.1.

Certifique-se de que seleciona a versão de tempo de execução certa para módulos.

Por exemplo: se estiver a executar um livro de execução para um cenário de automatização SharePoint na versãoRuntime 7.1 (pré-visualização), em seguida, importe o módulo na versão Runtime7.1 (pré-visualização); se estiver a executar um livro de execução para um cenário de automatização SharePoint na versão Runtime5.1, em seguida, importe o módulo na versão Runtime5.1. Neste caso, veria duas entradas para o módulo, uma para a versãoruntime 7.1 (pré-visualização) e outra para 5.1.

séries de livros.

Atualmente, o PowerShell 5.1 e o 7.1 (pré-visualização) são suportados.

Vantagens

  • Implementar toda a lógica complexa com o código PowerShell sem as outras complexidades do Fluxo de Trabalho PowerShell.
  • Comece mais rápido que os livros de fluxo de trabalho powerShell, uma vez que não precisam de ser compilados antes de serem executados.
  • Corra em Azure e em Hybrid Runbook Workers tanto para Windows como Linux.

Limitações - versão 5.1

  • Deves estar familiarizado com a escrita da PowerShell.
  • Os runbooks não podem usar o processamento paralelo para executar várias ações paralelamente.
  • Os runbooks não podem usar postos de controlo para retomar o livro de contas se houver um erro.
  • Pode incluir apenas livros de powerShell, workflow powerShell e runbooks gráficos como livros infantis utilizando o cmdlet Start-AzAutomationRunbook , que cria um novo emprego.
  • Os runbooks não podem usar a declaração de #Requires PowerShell, não é suportado na caixa de areia Azure ou em Trabalhadores De Runbook Híbridos e pode fazer com que o trabalho falhe.

Edições conhecidas - versão 5.1

Seguem-se os problemas atuais com os livros de execução PowerShell:

  • Os livros powerShell não conseguem recuperar um ativo variável não encriptado com um valor nulo.
  • Os livros powerShell não conseguem recuperar um ativo variável com *~* o nome.
  • Uma operação Get-Process em loop num manual powerShell pode colidir após cerca de 80 iterações.
  • Um livro de execução PowerShell pode falhar se tentar escrever uma grande quantidade de dados para o fluxo de saída de uma só vez. Normalmente, pode trabalhar em torno deste problema, tendo a saída do runbook apenas a informação necessária para trabalhar com objetos grandes. Por exemplo, em vez de utilizar Get-Process sem limitações, pode ter a saída de cmdlet apenas os parâmetros necessários como em Get-Process | Select ProcessName, CPU.

Limitações - 7.1 (pré-visualização)

  • Os Automatização do Azure cmdlets internos da PowerShell não são suportados num Trabalhador de Runbook Híbrido Linux. Deve importar o automationassets módulo no início do seu Python runbook para aceder às funções de recursos partilhados (ativos) da conta Automation.
  • Para a versão de tempo de execução PowerShell 7, as atividades do módulo não são extraídas para os módulos importados.
  • O tipo de parâmetro de runbook PSCredential não é suportado na versão de tempo de execução PowerShell 7.
  • O PowerShell 7.x não suporta fluxos de trabalho. Veja isto para mais detalhes.
  • Atualmente, o PowerShell 7.x não suporta os livros de execução assinados.
  • A integração do controlo de origem não suporta o PowerShell 7.1. Além disso, os runbooks PowerShell 7.1 no controlo de fontes são criados na conta Dem automação como Runtime 5.1.

Questões Conhecidas - 7.1 (pré-visualização)

  • A execução de scripts infantis utilizando .\child-runbook.ps1 não é suportada nesta pré-visualização. Solução alternativa: Utilize Start-AutomationRunbook (cmdlet interno) ou Start-AzAutomationRunbook (do módulo Az.Automation ) para iniciar outro livro de bordo a partir do livro de bordo dos pais.
  • As propriedades do runbook que definem a preferência por registo não são suportadas no tempo de execução do PowerShell 7.
    Solução alternativa: Definir explicitamente a preferência no início do runbook como abaixo -
        $VerbosePreference = "Continue"
    
        $ProgressPreference = "Continue"
    
  • Evite importar Az.Accounts o módulo para a versão 2.4.0 para o tempo de execução do PowerShell 7, uma vez que pode haver um comportamento inesperado usando esta versão em Automatização do Azure.
  • Poderá encontrar problemas de formatação com fluxos de saída de erro para o trabalho em execução no tempo de funcionamento do PowerShell 7.
  • Quando importa um módulo PowerShell 7.1 que depende de outros módulos, poderá descobrir que o botão de importação é cinzento mesmo quando a versão PowerShell 7.1 do módulo dependente está instalada. Por exemplo, a versão 4.20.0 do Az.Compute tem uma dependência de Az.Accounts sendo >= 2.6.0. Este problema ocorre quando um módulo dependente equivalente no PowerShell 5.1 não satisfaz os requisitos da versão. Por exemplo, a versão 5.1 do Az.Accounts foi < de 2.6.0.
  • Quando inicia o runbook PowerShell 7 utilizando o webhook, converte automaticamente o parâmetro de entrada webhook para um JSON inválido.

Livros de fluxo de trabalho PowerShell

Os livros de fluxo de trabalho PowerShell são livros de texto baseados no fluxo de trabalho Windows PowerShell. Edita diretamente o código do livro de texto utilizando o editor de texto no portal do Azure. Também pode usar qualquer editor de texto offline e importar o livro de bordo para Automatização do Azure.

Nota

O PowerShell 7.1 não suporta os livros de fluxo de trabalho.

Vantagens

  • Implementar toda a lógica complexa com o código de fluxo de trabalho PowerShell.
  • Utilize postos de controlo para retomar o funcionamento se houver um erro.
  • Utilize o processamento paralelo para fazer múltiplas ações em paralelo.
  • Pode incluir outros livros gráficos e runbooks powerShell Workflow como livros infantis para criar fluxos de trabalho de alto nível.

Limitações

  • Deve estar familiarizado com o fluxo de trabalho powerShell.
  • Os livros devem lidar com a complexidade adicional do fluxo de trabalho PowerShell, como objetos desercializados.
  • Os livros de execução demoram mais tempo a iniciar do que os livros powerShell, uma vez que devem ser compilados antes de serem executados.
  • Só pode incluir os livros powerShell como livros infantis utilizando o Start-AzAutomationRunbook cmdlet.
  • Os runbooks não podem funcionar com um Trabalhador de Runbook Híbrido Linux.

Python livros

Python os livros compilam-se abaixo dos Python 2 e Python 3. Python 3 runbooks estão atualmente em pré-visualização. Pode editar diretamente o código do livro de texto utilizando o editor de texto no portal do Azure. Também pode usar um editor de texto offline e importar o livro de bordo para Automatização do Azure.

Python 3 livros são suportados nas seguintes infraestruturas globais do Azure:

  • Azure global
  • Azure Government

Vantagens

  • Utilize as robustas bibliotecas Python.
  • Pode correr em Azure ou em Hybrid Runbook Workers.
  • Para Python 2, os Trabalhadores do Runbook Híbrido do Windows são suportados com python 2.7 instalado.
  • Para Python 3 Cloud Jobs, Python versão 3.8 é suportada. Scripts e pacotes de qualquer versão 3.x podem funcionar se o código for compatível em diferentes versões.
  • Para Python 3 trabalhos híbridos em máquinas Windows, pode optar por instalar qualquer versão 3.x que queira utilizar.
  • Para Python 3 trabalhos híbridos em máquinas Linux, dependemos da versão Python 3 instalada na máquina para executar a DSC OMSConfig e o Linux Hybrid Worker. As diferentes versões devem funcionar se não houver alterações nas assinaturas de métodos ou contratos entre versões de Python 3.

Limitações

  • Deves estar familiarizado com Python guiões.
  • Para utilizar bibliotecas de terceiros, deve importar os pacotes para a conta Automation.
  • A utilização do cmdlet Start-AutomationRunbook no PowerShell/PowerShell Workflow para iniciar um Python 3 runbook (pré-visualização) não funciona. Pode utilizar o cmdlet Start-AzAutomationRunbook a partir do módulo Az.Automation ou do cmdlet Start-AzureRmAutomationRunbook do módulo AzureRm.Automation para contornar esta limitação. 
  • Automatização do Azure não suporta sys.stderr.
  • O pacote automationasses Python não está disponível no pypi.org, pelo que não está disponível para importação para uma máquina Windows.

Várias versões de Python

Para um Trabalhador de Runbook do Windows, ao executar um livro de Python 2 procura primeiro a variável PYTHON_2_PATH ambiental e valida se aponta para um ficheiro executável válido. Por exemplo, se a pasta de instalação estiver C:\Python2, verificará se C:\Python2\python.exe é um caminho válido. Se não for encontrado, então procura a variável ambiental PATH para fazer uma verificação semelhante.

Para Python 3, procura primeiro a PYTHON_3_PATH variável env e depois volta para a variável ambientalPATH.

Ao utilizar apenas uma versão do Python, pode adicionar o caminho de instalação à PATH variável. Se pretender utilizar ambas as versões no Runbook Worker, desapasse PYTHON_2_PATH e PYTHON_3_PATH a localização do módulo para essas versões.

Problemas conhecidos

No que diz na nuvem, Python 3 postos de trabalho às vezes falham com uma mensagem invalid interpreter executable pathde exceção. Poderá ver esta exceção se o trabalho for atrasado, a partir de mais de 10 minutos, ou utilizar o Start-AutomationRunbook para iniciar Python 3 livros. Se o trabalho for atrasado, reiniciar o livro deve ser suficiente. Os trabalhos híbridos devem funcionar sem qualquer problema se utilizarem os seguintes passos:

  1. Crie uma nova variável ambiente chamada PYTHON_3_PATH e especifique a pasta de instalação. Por exemplo, se a pasta de instalação for C:\Python3, então este caminho tem de ser adicionado à variável.
  2. Reinicie a máquina depois de definir a variável ambiente.

Passos seguintes