Partilhar via

Criação de runbooks 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 runbooks, como criar e editar runbooks, disparar um trabalho, acompanhar a saída de trabalhos recentes, vincular uma agenda, gerenciamento de ativos e depuração local.

Pré-requisitos

  • Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
  • Visual Studio Code.
  • Os módulos do PowerShell e os pacotes Python usados pelo runbook devem ser instalados localmente na máquina para executar o runbook localmente.

Sistemas operativos suportados

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 PowerShell Core 7.2.7
  4. Ubuntu 20.04 com PowerShell Core 7.2.7

Nota

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

Principais Funcionalidades    

  • Integração simplificada – Você pode entrar usando uma conta do Azure de forma simples e segura.
  • Vários idiomas - Suporta toda a pilha de tempo de execução de automação, como PowerShell 5, PowerShell 7, Python 2 e Python 3 Runbooks.
  • Capacidade de suporte- Suporta a execução de teste de trabalho, publicação de trabalho de automação e acionamento de trabalho no Azure e trabalhadores híbridos. Você pode executar runbooks localmente.
  • Suporta parâmetros posicionais Python e parâmetros do PowerShell para acionar o trabalho.
  • Webhooks simplificado – Você pode criar um webhook, iniciar um trabalho através de um webhook de forma mais simples. Além disso, suporte para vincular uma programação a um Runbook.
  • Gerenciar ativos de automação – Você pode executar operações 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 Grupo de trabalhadores híbridos para executar trabalhos híbridos e exibir os últimos 10 trabalhos recentes executados.
  • Depurar localmente - Você pode depurar os scripts do PowerShell localmente.
  • Comparação de runbook - Você pode comparar o runbook local com a cópia publicada ou de rascunho.

Principais características da v1.0.8

  • Definições de configuração do diretório local - Você pode definir o diretório de trabalho que deseja salvar runbooks localmente.

    • Change Directory:Base Path - Você usa o caminho de diretório alterado quando reabre o Visual Studio Code IDE. Para alterar o diretório usando a Paleta de Comandos, use Ctrl+Shift+P -> selecione Alterar Diretório. Para alterar o caminho base das definições de configuração da extensão, selecione o ícone Gerenciar na barra de atividades à esquerda e vá para Configurações > Extensões > Azure Automation > Directory:Base Path.
    • Change Directory:Folder Structure - Você pode alterar a estrutura de pastas do diretório local de vscodeAutomation/accHash para subscription/resourceGroup/automationAccount. Selecione o ícone Gerenciar na barra de atividades à esquerda e vá para Configurações > Extensões > Azure Automation > Directory:Folder Structure. Você pode alterar a configuração padrão do formato vscodeAutomation/accHash para subscription/resourceGroupe/automationAccount .

      Nota

      Se sua conta de automação estiver integrada ao controle do código-fonte, você poderá fornecer o caminho da pasta 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 de rascunho, carregar como rascunho, publicar runbook e excluir runbook de sua conta de automação.

  • Operações de execução do Runbook - Você pode executar uma versão local dos 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.

    Nota

    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 uma agenda, excluir agenda, vincular agendamento 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, os seguintes recursos não são suportados:

  • Criação de novos horários.
  • 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ê terá que executar a operação para buscar ou publicar runbook.
  • Gestão de grupos de trabalhadores 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, suportamos apenas os ativos não criptografados em execução local.

Próximos passos