Partilhar via

Usar runbooks e módulos existentes

  • Artigo

Em vez de criar seus próprios runbooks e módulos na Automação do Azure, você pode acessar cenários que já foram criados pela Microsoft e pela comunidade. Você pode obter runbooks do PowerShell e Python relacionados ao Azure na Galeria de Runbooks no portal do Azure e módulos e runbooks (que podem ou não ser específicos do Azure) na Galeria do PowerShell. Também pode contribuir para a comunidade partilhando cenários que desenvolve.

Nota

O Centro de Scripts TechNet está sendo desativado. Todos os runbooks do Centro de Scripts na galeria de Runbooks foram movidos para nossa organização do GitHub de Automação Para obter mais informações, consulte Runbooks de automação do Azure migrando para o GitHub.

Importar runbooks do GitHub com o portal do Azure

Nota

  • A opção Procurar galeria no portal do Azure tem uma experiência de utilizador melhorada.
  • Na folha Runbook de Automação de Processos>, você pode importar runbooks pela opção Importar um runbook ou Procurar galeria e a página Runbooks exibe duas novas colunas - Versão em tempo de execução e Tipo de runbook.

  1. No portal do Azure, abra a sua conta da Automatização.

  2. Selecione a folha Runbooks em Process Automation.

  3. Clique em Importar um runbook na página Runbooks .

    Captura de tela da seleção de um runbook da opção de importação de runbook.

  4. Na página Importar um runbook, você pode importar um arquivo armazenado em sua máquina local ou do GitHub usando Procurar arquivo ou Procurar da galeria, respectivamente.

  5. Selecione o arquivo.

  6. Insira o Nome, a versão do tempo de execução e a Descrição.

  7. Clique em Importar.

    Captura de tela mostrando a seleção de um runbook do arquivo ou galeria.

  8. Como alternativa, selecione Procurar Galeria na página Runbooks para navegar pelos runbooks disponíveis.

    Captura de tela da seleção da opção de galeria de navegação na folha runbook.

  9. Você pode usar os filtros acima da lista para restringir a exibição por editor, tipo e classificação. Localize o item de galeria desejado e selecione-o para visualizar seus detalhes.

    Navegando na galeria runbook.

  10. Clique em Selecionar para selecionar um runbook escolhido.

  11. Na página Importar um runbook, digite o Nome e selecione as versões de tempo de execução.

  12. O tipo de Runbook e a Descrição são preenchidos automaticamente.

  13. Clique em Importar.

    Importação de itens de galeria.

  14. O runbook aparece na guia Runbooks da conta Automação.

Importante

Você deve validar o conteúdo de quaisquer runbooks obtidos na Galeria do PowerShell. Tenha muito cuidado ao instalá-los e executá-los em um ambiente de produção.

A Galeria do PowerShell fornece vários runbooks da Microsoft e da comunidade que você pode importar para a Automação do Azure. Para usar um, baixe um runbook da galeria ou você pode importar runbooks diretamente da galeria ou de sua conta de Automação no portal do Azure.

Nota

Não há suporte para runbooks gráficos na Galeria do PowerShell.

Você só pode importar diretamente da Galeria do PowerShell usando o portal do Azure. Não é possível executar essa função usando o PowerShell. O procedimento é o mesmo mostrado em Importar runbooks do GitHub com o portal do Azure, exceto que a Origem será a Galeria do PowerShell.

Mostrando a seleção de origem da galeria de runbook.

Os módulos do PowerShell contêm cmdlets que você pode usar em seus runbooks. Os módulos existentes que você pode instalar na Automação do Azure estão disponíveis na Galeria do PowerShell. Pode iniciar esta galeria a partir do portal do Azure e instalar os módulos diretamente na Automação do Azure ou pode transferi-los e instalá-los manualmente.

Você também pode encontrar módulos para importar no portal do Azure. Eles estão listados para sua conta de automação nos módulos em Recursos compartilhados.

Importante

Não inclua a palavra-chave "AzureRm" em nenhum script projetado para ser executado com o módulo Az. A inclusão da palavra-chave, mesmo em um comentário, pode fazer com que o AzureRm carregue e, em seguida, entre em conflito com o módulo Az.

A lista abaixo contém alguns runbooks que suportam cenários comuns. Para obter uma lista completa de runbooks criados pela equipe de Automação do Azure, consulte AzureAutomationTeam profile.

Contribua para a comunidade

Recomendamos vivamente que contribua e ajude a aumentar a comunidade de Automação do Azure. Compartilhe os incríveis runbooks que você construiu com a comunidade. As suas contribuições serão apreciadas!

Você pode adicionar novos runbooks do PowerShell ou Python à galeria Runbook com este fluxo de trabalho do GitHub.

  1. Crie um repositório público no GitHub e adicione o runbook e quaisquer outros arquivos necessários (como readme.md, descrição e assim por diante).

  2. Adicione o tópico azureautomationrunbookgallery para garantir que o repositório seja descoberto pelo nosso serviço, para que possa ser exibido na galeria Runbook de automação.

  3. Se o runbook que você criou for um fluxo de trabalho do PowerShell, adicione o tópico PowerShellWorkflow. Se for um runbook Python 3, adicione Python3. Nenhum outro tópico específico é necessário para runbooks do Azure, mas recomendamos que você adicione outros tópicos que possam ser usados para categorização e pesquisa na Galeria de Runbooks.

    Nota

    Confira runbooks existentes na galeria para coisas como formatação, cabeçalhos e tags existentes que você pode usar (como Azure Automation ou Linux Azure Virtual Machines).

Para sugerir alterações em um runbook existente, registre uma solicitação pull contra ele.

Se você decidir clonar e editar um runbook existente, a prática recomendada é dar-lhe um nome diferente. Se você reutilizar o nome antigo, ele aparecerá duas vezes na listagem da galeria Runbook.

Nota

Aguarde pelo menos 12 horas para sincronização entre o GitHub e a Galeria de Runbooks de Automação, tanto para runbooks atualizados quanto novos.

A Microsoft incentiva você a adicionar runbooks à Galeria do PowerShell que você acha que seriam úteis para outros clientes. A Galeria do PowerShell aceita módulos e scripts do PowerShell. Você pode adicionar um runbook carregando-o na Galeria do PowerShell.

  1. No portal do Azure, abra a sua conta da Automatização.

  2. Em Recursos Partilhados, selecione Módulos.

  3. Na página Módulos , selecione Procurar galeria para abrir a lista de módulos.

    Vista da galeria de módulos.

  4. Na página Procurar galeria, pode pesquisar pelos seguintes campos:

    • Nome do Módulo
    • Etiquetas
    • Autor
    • Nome do recurso Cmdlet/DSC

  5. Localize um módulo em que esteja interessado e selecione-o para ver os seus detalhes.

    Ao detalhar um módulo específico, você pode visualizar mais informações. Essas informações incluem um link de volta para a Galeria do PowerShell, quaisquer dependências necessárias e todos os cmdlets ou recursos DSC que o módulo contém.

    Vista detalhada de um módulo da galeria.

  6. Para instalar o módulo diretamente na Automação do Azure, clique em Importar.

  7. No painel Importar, você pode ver o nome do módulo a ser importado. Se todas as dependências estiverem instaladas, o botão OK será ativado. Se você estiver faltando dependências, você precisa importar essas dependências antes de poder importar este módulo.

  8. No painel Importar, clique em OK para importar o módulo. Enquanto a Automação do Azure importa um módulo para sua conta, ela extrai metadados sobre o módulo e os cmdlets. Essa ação pode levar alguns minutos, já que cada atividade precisa ser extraída.

  9. Você recebe uma notificação inicial de que o módulo está sendo implantado e outra notificação quando ele for concluído.

  10. Depois que o módulo é importado, você pode ver as atividades disponíveis. Você pode usar recursos de módulo em seus runbooks e recursos DSC.

Nota

Os módulos que suportam apenas o núcleo do PowerShell não têm suporte na Automação do Azure e não podem ser importados no portal do Azure ou implantados diretamente da Galeria do PowerShell.

Solicitar um runbook ou módulo

Você pode enviar solicitações para o User Voice. Se você precisar de ajuda para escrever um runbook ou tiver uma pergunta sobre o PowerShell, poste uma pergunta em nossa página de perguntas e respostas da Microsoft.

Próximos passos