Convenções de Nomeação de Runbooks

Nomes de arquivo no Github

Esperamos uma certa estrutura de arquivos e nomes no repositório compartilhado de runbooksarrow-up-right. RealmJoin importará essas pastas e arquivos do GitHub para a Conta de Automação do Azure do cliente.

Hífens ("-") serão convertidos em espaços. Pastas são usadas para separar runbooks em "contexto" e "categoria", por exemplo. user\general. Os nomes de arquivos devem descrever o propósito do script.

Todos os runbooks importados têm um prefixo de rjgit-, seguido pelo contexto, seja org, group, user depois a categoria, por exemplo _general_, _security_, _mail_ e o nome do próprio script como add-additional-alias.

Exemplo:

Um runbook no Github em user\general nomeado add-additional-alias.ps1 será mostrado como:

  • rjgit-user_general_add-additional-alias na Conta de Automação do Azure

  • "Adicionar Alias Adicional" no Portal RealmJoin em um objeto Usuário na categoria de runbook "General".

Categorias comuns

  • Geral

  • Segurança

  • Email

  • Informações do usuário

Você pode definir categorias adicionais, mas não contextos.

Qual é o propósito disso?

Isso permite preencher e nomear automaticamente os runbooks no Portal RealmJoin. Além disso, o rjgit- prefixo permite evitar conflitos de nomenclatura com runbooks locais/do cliente. Runbooks que não tiverem esse prefixo não serão alterados pela lógica de importação do RealmJoin.

Runbooks privados / específicos do cliente

Você pode hospedar runbooks privados (locais) em sua Conta de Automação do Azure. Esses runbooks aparecerão no Portal RealmJoin assim como os runbooks compartilhados. Runbooks locais não serão afetados pelo nosso processo de sincronização e não serão visíveis para outros clientes.

Para criar um runbook local, remova o rjgit- prefixo da convenção de nomenclatura mantendo o restante da estrutura de nomes intacta.

Exemplo: Você quer oferecer um runbook "Runbook Privado" no contexto de grupos do Azure AD e na categoria "General". Você o nomearia group_general_private-runbook na sua Conta de Automação do Azure.

Isto ficará assim no Azure Automation:

Nomes de runbooks no GitHub / Azure Automation

Será apresentado no Portal RealmJoin como:

Nomes de runbooks no Portal RealmJoin

Last updated

Was this helpful?