For the complete documentation index, see llms.txt. This page is also available as Markdown.

Convenções de nomenclatura de runbooks

Convenções de nomenclatura de runbooks do RealmJoin: como o contexto e a categoria mapeiam os nomes de runbooks do repositório partilhado para o Azure Automation e o portal.

Nomes de arquivos no GitHub

Esperamos uma determinada estrutura de arquivos e de nomenclatura no repositório compartilhado de runbooks. O RealmJoin importará estas pastas e arquivos do GitHub para a conta de Automação do Azure do cliente.

Os travessões ("-") serão convertidos em espaços. As pastas são usadas para separar runbooks em "contexto" e "categoria", por ex. user\general. Os nomes dos arquivos devem descrever o propósito do script.

Todos os runbooks importados têm o prefixo rjgit-, seguido pelo contexto, seja org, group, user ou device 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 chamado add-additional-alias.ps1 será exibido como:

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

  • "Add Additional Alias" no portal do RealmJoin em um objeto User na categoria de runbook "General".

Categorias comuns

  • Geral

  • Segurança

  • E-mail

  • 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 do RealmJoin. Além disso, o rjgit- prefixo permite evitar conflitos de nomenclatura com runbooks locais/do cliente. Os 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) na sua conta de Automação do Azure. Esses runbooks aparecerão no portal do RealmJoin assim como os runbooks compartilhados. Os runbooks locais não serão afetados pelo nosso processo de sincronização e não ficarão visíveis para outros clientes.

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

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

Isso ficará assim no Azure Automation:

Nomes de runbooks no GitHub / Azure Automation

Ele será apresentado no portal do RealmJoin como:

Nomes de runbooks no portal do RealmJoin

Última atualização

Isto foi útil?