Gerenciar o ambiente de runtime e runbooks associados

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.

   

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.

   

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.

   

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.

   

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

Portal do Azure

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.

      

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.

   

   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.

   

   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.

REST API

É possível criar um novo ambiente do runtime para o PowerShell 7.2 com o módulo Az PowerShell na Automação

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

{ 
  "properties": { 
    "runtime": { 
        "language": "PowerShell",  
        "version": "7.2" 
        }, 
        "defaultPackages": { 
            "Az": "7.3.0" 
        } 
     }, 
    "name": "<runtimeEnvironmentName>" 
} 

Carregar um pacote Az.Accounts no ambiente do runtime.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runtimeEnvironments/<runtimeEnvironmentName>/packages/Az.Accounts?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "contentLink": { 
        "uri": "https://psg-prod-eastus.azureedge.net/packages/az.accounts.2.12.4.nupkg" 
    } 
  } 
} 

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:

Portal do Azure

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

   

REST API

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

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.

Excluir o ambiente do runtime

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

Portal do Azure

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.

   

REST API

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

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.

Portal do Azure

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.

   

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

   

   Observação

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

REST API

Atualize a versão do módulo Az de um ambiente do runtime existente:

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

  "properties": { 

        "defaultPackages": { 

            "Az": "9.0.0" 

        } 

     } 

} 

Gerenciar runbooks vinculados ao ambiente do runtime

Criar Runbook

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

Portal do Azure

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.

      

   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.

REST API

Pré-requisito

• Configurar um ambiente do runtime do PowerShell e fornecer como uma entrada para a criação de runbook.

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

{ 
  "properties": { 
        "runbookType": "PowerShell", 
        "runtimeEnvironment": <runtimeEnvironmentName>, 
        "publishContentLink": { 
            "uri": "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-automation-runbook-getvms/Runbooks/Get-AzureVMTutorial.ps1" 
        } 
    }, 
   "location": "East US"
} 

Observação

APIs semelhantes também funcionam para o tipo de runbook do Python.

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.

Portal do Azure

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.

4. Selecione o ambiente do runtime na lista suspensa à qual você deseja vincular os runbooks.

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.

REST API

Atualizar o ambiente do runtime vinculado a um runbook.

PATCH 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "type": "PowerShell" 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
  } 
} 

Observação

As chamadas de Exibição/Exclusão para runbook permanecem iguais e podem ser referenciadas Runbook – Automação da API REST do Azure | Microsoft Learn.

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.

Portal do Azure

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.

   

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.

   

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.

REST API

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.

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/runbooks/<runbookName>/draft/testJob?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runtimeEnvironment": "<runtimeEnvironmentName>" 
    "runOn": "" 
  } 
} 

Criar trabalho na nuvem

Portal do Azure

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

REST API

Os trabalhos herdam o ambiente do runtime do runbook. Execute um trabalho da nuvem de um runbook publicado:

PUT 
https://management.azure.com/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.Automation/automationAccounts/<accountName>/jobs/<jobName>?api-version=2023-05-15-preview 
{ 
  "properties": { 
    "runbook": { 
      "name": "<runbookName>" 
    }, 
    "runOn": "" 
  } 
} 

Observação

As chamadas de criação/exibição do trabalho permanecem iguais e podem ser referenciadas a partir da API REST do Trabalho (Automação do Azure) | Microsoft Learn.

Vincular runbooks existentes a ambientes do runtime gerados pelo sistema

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

• Para obter uma visão geral do Ambiente do runtime.
• Para solucionar problemas com a execução do runbook, confira Solução de problemas de runbook.