Compartilhar via

Gerenciar o ambiente de runtime e runbooks associados

  • Artigo

Este artigo fornece informações sobre como criar o ambiente do runtime e executar várias operações por meio do portal do Azure e da API REST.

Pré-requisitos

Uma conta de Automação do Azure em região pública com suporte (exceto Índia Central, Norte da Alemanha, Norte da Itália, Israel Central, Polônia Central, EA Central e nuvens do governo).

Alternar entre o ambiente do runtime e a experiência antiga

Experiência de ambiente do runtime

  1. Selecione Visão geral e, em seguida, selecione Experimentar a experiência de ambiente do runtime.

    A captura de tela mostra como experimentar a experiência de ambiente do runtime.

  2. Em Automação de processos, você tem os Ambientes de runtime (versão prévia) e os módulos e os pacotes do Python em recursos compartilhados são removidos, pois o ambiente de runtime permite o gerenciamento de pacotes necessários durante a execução do runbook.

    A captura de tela mostra as opções de menu ao alternar para a experiência de ambiente do runtime.

  3. Para reverter para a experiência de gerenciamento de módulos e pacotes antiga, selecione Visão geral no painel esquerdo e, em seguida, selecione Alternar para experiência antiga.

    A captura de tela mostra como navegar até a experiência anterior.

Experiência antiga

  1. Acesse a sua conta de Automação, em Automação de processos, os Ambientes do runtime (versão prévia) são removidos e, em recursos compartilhados, Módulos e Pacotes do Python podem ser vistos.

    A captura de tela mostra as opções de menu quando as configurações padrão são restauradas.

Observação

As atualizações de runbook persistem entre a experiência de ambiente de runtime nova e a experiência antiga. Todas as alterações feitas no ambiente do runtime vinculadas a um runbook seriam mantidas durante a execução do runbook na experiência antiga.

Gerenciar ambiente do runtime

Criar ambiente do runtime

  1. Entre no portal do Azure e selecione sua conta de Automação.

  2. Em Automação de processos, selecione Ambientes do runtime (versão prévia) e, em seguida, selecione Criar.

  3. Em Noções básicas, forneça os seguintes detalhes:

    1. O Nome do ambiente do runtime. Isso deve começar alfabeticamente e pode conter apenas alfabetos, números, sublinhados e traços.

    2. Na lista suspensa Idioma, selecione o idioma de script para o ambiente do runtime.

      • Escolha o PowerShell para linguagem de script do PowerShell ou Python para linguagem de script do Python.

    3. Selecione a Versão do runtime para o idioma de script.

      • Para o PowerShell – escolha 5.1, 7.2
      • Para Python – escolha 3.8, 3.10 (versão prévia)

    4. Forneça a descrição apropriada.

      A captura de tela mostra as entradas na guia Noções básicas da criação de ambiente do runtime.

  4. Selecione Avançar e na guia Pacotes, carregue os pacotes necessários durante a execução do runbook. O pacote do Az PowerShell é carregado por padrão para todos os ambientes do runtime do PowerShell, que inclui todos os cmdlets para gerenciar recursos do Azure. É possível escolher a versão do pacote Az na lista suspensa. Selecione Nenhum se não desejar que o Pacote seja carregado durante a execução do runbook.

    A captura de tela mostra as seleções na guia pacotes de criação de ambiente do runtime.

    Observação

    Há suporte para comandos da CLI do Azure (versão prévia) em runbooks associados ao ambiente de runtime do PowerShell 7.2. Os comandos da CLI do Azure versão 2.56.0 estão disponíveis como um pacote padrão no ambiente do runtime do PowerShell 7.2.

  5. Para carregar mais pacotes necessários durante a execução do runbook. Selecione Adicionar um arquivo para adicionar os arquivos armazenados localmente em seu computador ou selecione Adicionar por meio da galeria para carregar pacotes da galeria do PowerShell.

    A captura de tela mostra como adicionar arquivos do computador local ou carregar por meio da galeria.

    Observação

    • A importação de um pacote pode demorar um pouco. Você pode importar arquivos no tamanho total máximo de 100 MB.
    • Usar arquivos .zip para tipos de runbook do PowerShell, conforme mencionado aqui
    • Para pacotes do Python 3.8, use arquivos .whl direcionados ao cp38-amd64.
    • Para pacotes do Python 3.10 (versão prévia), use arquivos .whl direcionados ao sistema operacional Linux cp310.

  6. Selecione Avançar e, na guia Analisar + Criar, verifique se as configurações estão corretas. Ao selecionar Criar, o Azure executa a validação nas configurações de ambiente do runtime escolhidas. Se a validação for aprovada, será possível continuar a criar outro ambiente do runtime e o portal indicará as configurações que precisam ser modificadas.

Na página Ambientes do runtime (versão prévia), você pode exibir o ambiente do runtime recém-criado da sua conta de Automação. Se não encontrar os ambientes do runtime recém-criados na lista, selecione Atualizar.

Exibir o ambiente do runtime

Obtenha as propriedades de ambiente do runtime a partir da conta de Automação.

GET 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>?api-version=2023-05-15-preview

Listar os ambientes do runtime

Para listar todos os ambientes do runtime da conta de Automação:

  1. Na conta de Automação, em Automação de processos, selecione Ambientes do runtime (versão prévia).

    A captura de tela mostra como exibir a lista de todos os ambientes do runtime.

Exibir os componentes do pacote Az PowerShell

Para exibir todos os pacotes de componentes do pacote do Az PowerShell, execute o cmdlet Get-Module -ListAvailable em um runbook do PowerShell.

A saída do trabalho mostraria todos os pacotes de componentes e suas versões.

A captura de tela mostra os componentes do pacote do PowerShell.

Excluir o ambiente do runtime

Para excluir o ambiente do runtime da conta de Automação, siga estas etapas:

  1. Na conta de Automação, em Automação de processos, selecione Ambientes do runtime (versão prévia).

  2. Selecione o ambiente do runtime que você deseja excluir.

  3. Selecione Excluir para excluir o ambiente do runtime.

    A captura de tela mostra como excluir o ambiente do runtime.

Atualizar o ambiente do runtime

A linguagem de runtime e a versão de runtime são propriedades imutáveis. No entanto, é possível atualizar a versão dos módulos e adicionar ou remover pacotes no ambiente do runtime. Os runbooks vinculados ao ambiente do runtime são atualizados automaticamente com as novas configurações.

  1. Na conta de Automação, em Automação de processos, selecione Ambientes do runtime (versão prévia).

  2. Selecione o ambiente do runtime que você deseja atualizar.

  3. Selecione a versão na lista suspensa para atualizar a versão dos pacotes existentes.

  4. Selecione Salvar.

    A captura de tela mostra como atualizar o ambiente do runtime.

  5. Selecione Adicionar um arquivo para carregar pacotes do computador local ou Adicionar por meio da galeria para carregar pacotes da Galeria do PowerShell.

    A captura de tela mostra como carregar pacotes durante a atualização de ambiente do runtime.

    Observação

    Você pode adicionar até 10 pacotes por vez ao ambiente do runtime. Certifique-se de salvar depois de adicionar 10 pacotes.

Gerenciar runbooks vinculados ao ambiente do runtime

Criar Runbook

É possível criar um novo runbook do PowerShell configurado com o ambiente do runtime.

Pré-requisito

  • Verifique se você criou um ambiente do runtime antes de criar um runbook.

Para criar um novo runbook vinculado ao ambiente do runtime, siga estas etapas:

  1. Em sua conta de Automação, em Automação de Processos, selecione Runbooks.

  2. Selecione Criar.

  3. Na guia Noções básicas, você pode criar um novo runbook ou carregar um arquivo do computador local ou da galeria do PowerShell.

    1. Fornecer um Nome para o runbook. Isso deve começar com uma letra e pode conter apenas letras, números, sublinhados e traços.

    2. Na lista suspensa do Tipo de runbook, selecione o tipo de runbook que você deseja criar.

    3. Selecione o Ambiente do runtime a ser configurado para o runbook. Você pode selecionar em ambientes do runtime existentes ou Criar um novo e vincular ao runbook. A lista de ambientes do runtime é preenchida com base no Tipo de runbook selecionado na etapa b.

    4. Forneça a descrição apropriada.

      A captura de tela mostra como criar runbook no ambiente do runtime.

    Observação

    Para o Tipo de runbook do PowerShell, apenas o ambiente do runtime do PowerShell seria listado para seleção. Para o Tipo de runbook do Python, somente os ambientes do runtime do Python seriam listados para seleção.

  4. Adicione Marcas ao runbook, analise as configurações e selecione Criar para criar um novo runbook.

Esse runbook está vinculado ao ambiente do runtime selecionado. Todos os pacotes no ambiente do runtime escolhido estariam disponíveis durante a execução do runbook.

Atualizar runbook

Você pode atualizar o runbook alterando o ambiente do runtime vinculado ao runbook. É possível escolher um ou vários runbooks para atualização. O runbook no status de execução não seria afetado alterando o ambiente do runtime vinculado a esse runbook.

  1. Em sua conta de Automação, em Automação de Processos, selecione Runbooks.

  2. Marque a caixa de seleção dos runbooks que você deseja atualizar.

  3. Selecione Atualizar. A captura de tela mostra como atualizar o runbook no ambiente de runtime.

  4. Selecione o ambiente do runtime na lista suspensa à qual você deseja vincular os runbooks. A captura de tela mostra como vincular o runbook no ambiente de runtime.

  5. Selecione Atualizar para atualizar os runbooks selecionados com o novo ambiente do runtime.

Verifique se o runbook é executado conforme o esperado após a atualização. Se o runbook não fornecer o resultado esperado, será possível atualizar novamente o ambiente do runtime para a experiência antiga seguindo as etapas de 1 a 4.

Observação

As atualizações de runbook persistem entre a experiência de ambiente de runtime nova e a experiência antiga. Quaisquer alterações feitas no ambiente de runtime vinculado a um runbook persistiam durante a execução do runbook na experiência antiga.

Testar atualização do runbook

Execute um trabalho de teste para um runbook com um ambiente do runtime diferente. Esse cenário é útil quando um runbook precisa ser testado com um ambiente do runtime antes da atualização.

Você pode atualizar runbooks alterando o ambiente do runtime vinculado a esse runbook. É recomendável testar a execução do runbook antes de publicar as alterações. É para garantir que o runbook funcione conforme o esperado.

Para testar a execução do runbook antes de publicar alterações no ambiente do runtime, siga estas etapas:

  1. Acesse a página Runbooks e selecione o runbook para o qual você deseja atualizar o ambiente do runtime.

    A captura de tela mostra como ir para a página Runbooks para selecionar o runbook.

  2. Na página Editar runbook, selecione Editar no portal para abrir o editor de texto.

  3. O campo de ambiente do runtime mostra a configuração existente. Selecione o novo ambiente do runtime na lista suspensa.

    A captura de tela mostra como selecionar o novo ambiente do runtime.

  4. Selecione o painel de teste para testar a execução do runbook com o ambiente do runtime atualizado. Clique em Iniciar para iniciar o teste de execução.

  5. Feche o painel de teste e faça as alterações necessárias no código do runbook ou no ambiente do runtime, se necessário.

  6. Selecione Publicar para atualizar o ambiente do runtime vinculado ao runbook.

  7. Selecione Sim para substituir a versão publicada anteriormente e confirmar as alterações.

Criar trabalho na nuvem

Atualmente, os runbooks vinculados ao ambiente do runtime seriam executados no Azure.

Todos os runbooks existentes em sua conta de Automação do Azure seriam automaticamente vinculados a ambientes do runtime gerados pelo sistema. Esses ambientes do runtime gerados pelo sistema são criados com base na linguagem runtime, versão e Módulos/Pacotes presentes em sua respectiva conta de Automação do Azure. Saiba mais. Para atualizar os runbooks existentes, altere o ambiente do runtime seguindo as etapas mencionadas aqui.

Próximas etapas