Criação de runbook por meio do VS Code na Automação do Azure

  • Artigo

Este artigo explica sobre a extensão do Visual Studio que você pode usar para criar e gerenciar runbooks.

A Automação do Azure fornece uma nova extensão do VS Code para criar e gerenciar runbooks. Usando essa extensão, você pode executar todas as operações de gerenciamento de runbook, como, criar e editar runbooks, disparar um trabalho, acompanhar a saída de trabalhos recentes, vincular um agendamento, gerenciamento de ativos e depuração local.

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
  • Visual Studio Code.
  • Os módulos do PowerShell e os pacotes do Python usados pelo runbook devem ser instalados localmente no computador para executar o runbook localmente.

Sistemas operacionais compatíveis

A matriz de teste inclui os seguintes sistemas operacionais:

  1. Windows Server 2022 com Windows PowerShell 5.1 e PowerShell Core 7.2.7
  2. Windows Server 2019 com Windows PowerShell 5.1 e PowerShell Core 7.2.7
  3. macOS 11 com o PowerShell Core 7.2.7
  4. Ubuntu 20.04 com o PowerShell Core 7.2.7

Observação

  • A extensão deve funcionar em qualquer lugar no VS Code e dá suporte a PowerShell 7.2 ou superior. Para o Windows PowerShell, há suporte apenas para a versão 5.1.
  • O PowerShell Core 6 é de fim de vida útil e não tem suporte.

Principais recursos

  • integração simplificada – Você pode entrar usando uma conta do Azure de maneira simples e segura.
  • Vários idiomas – dá suporte a todas as pilhas de runtime de Automação, como PowerShell 5, PowerShell 7, Python 2 e Runbooks do Python 3.
  • Suporte – Dá suporte à execução de teste de trabalho, publicação de trabalho de Automação e acionamento de trabalho no Azure e em trabalhadores híbridos. Você pode executar runbooks localmente.
  • Dá suporte a parâmetros posicionais do Python e parâmetros do PowerShell para disparar o trabalho.
  • Webhooks simplificados – você pode criar um webhook, iniciar um trabalho por meio de um webhook de maneira mais simples. Além disso, há suporte para vincular uma agenda a um Runbook.
  • Gerenciar ativos de automação – você pode executar a operação de criação, atualização e exclusão em ativos, incluindo certificados, variáveis, credenciais e conexões.
  • Exibir propriedades – você pode exibir as propriedades e selecionar o grupo de hybrid worker para executar trabalhos híbridos e exibir os últimos 10 trabalhos executados.
  • Depurar localmente – você pode depurar os scripts do PowerShell localmente.
  • Comparação de runbook – você pode comparar o runbook local com o publicado ou a cópia do runbook de rascunho.

Principais recursos da v1.0.8

  • Configurações de configuração de diretório local – você pode definir o diretório de trabalho que deseja salvar runbooks localmente.

    • Alterar Diretório:Caminho Base – use o caminho de diretório alterado ao reabrir o IDE do Visual Studio Code. Para alterar o diretório usando a Paleta de Comandos, use Ctrl+Shift+P -> selecione Alterar Diretório. Para alterar o caminho base das configurações de configuração de extensão, selecione o ícone Gerenciar na barra de atividades à esquerda e vá para Configurações > Extensões > Automação do Azure > Diretório:Caminho Base.
    • Alterar Diretório:Estrutura de pastas – você pode alterar a estrutura de pastas do diretório local de vscodeAutomation/accHash para subscription/resourceGroup/automationAccount. Selecione Gerenciar ícone na barra de atividades à esquerda e vá para Configurações > Extensões > Automação do Azure > Diretório:Estrutura de Pastas. Você pode alterar a configuração padrão de vscodeAutomation/accHash para o formato assinatura/resourceGroupe/automationAccount.

      Observação

      Se sua conta de automação estiver integrada ao controle do código-fonte, você poderá fornecer o caminho da pasta do runbook do repositório GitHub como o caminho do diretório. Por exemplo: alterar o diretório para C:\abc armazenaria runbooks em C:\abc\vscodeAutomation.. ou C:\abc//subscriptionName//resourceGroupName//automationAccountName//runbookname.ps1.

  • Operações de gerenciamento de runbook – você pode criar runbook, buscar runbook de rascunho, buscar runbook publicado, abrir runbook local no editor, comparar runbook local com uma cópia de runbook publicada ou rascunho, carregar como rascunho, publicar runbook e excluir runbook de sua conta de Automação.

  • operações de execução de runbook – você pode executar uma versão local de trabalhos de Automação, como Iniciar trabalhos de Automação, Iniciar trabalho de teste de Automação, exibir saídas de trabalho e executar a versão local do Runbook do PowerShell no modo de depuração, permitindo que você adicione pontos de interrupção no script.

    Observação

    Atualmente, oferecemos suporte ao uso de cmdlets internos, como Get-AutomationVariable apenas com ativos não criptografados.

  • Trabalhar com agendas, ativos e webhooks – você pode exibir as propriedades de um agendamento, excluir agendamento, agendar link para vincular uma agenda a um runbook.

  • Adicionar webhook – Você pode adicionar um webhook ao runbook.

  • Atualizar propriedades de ativos – você pode criar, atualizar, exibir propriedades de ativos como Certificados, Conexões, Credenciais, Variáveis e Exclusão de ativos da extensão.

Limitações

Atualmente, não há suporte para os seguintes recursos:

  • Criação de novos agendamentos.
  • Adicionando novos certificados em ativos.
  • Carregue pacotes de módulos (PowerShell e Python) da extensão.
  • Sincronização automática de runbooks locais com a conta de Automação do Azure. Você precisará executar a operação no runbook Fetch ou Publicar.
  • Gerenciamento de grupos de trabalho híbridos.
  • Runbook gráfico e fluxos de trabalho.
  • Para Python, não fornecemos nenhuma opção de depuração. Recomendamos que você instale qualquer extensão de depurador em seu script Python.
  • Atualmente, oferecemos suporte apenas aos ativos não criptografados na execução local.

Próximas etapas