Convenções de Nomenclatura

Nomes de ficheiros no Github

Esperamos uma certa estrutura de ficheiros e nomenclatura no repositório partilhado de runbooks. O RealmJoin importará essas pastas e ficheiros do GitHub para a Conta de Automação do Azure dos clientes.

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

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

city!=Stuttgart

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 RealmJoin num objeto Utilizador na categoria de runbook "General".

Categorias comuns

• Geral

• Segurança

• Email

• Informações do Utilizador

Pode definir categorias adicionais, mas não contextos.

Qual é o propósito disto?

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

Runbooks privados / específicos do cliente

Pode alojar runbooks privados (locais) na sua Conta de Automação do Azure. Estes runbooks aparecerão no Portal RealmJoin tal como os runbooks partilhados. Runbooks locais não serão alterados pelo nosso processo de sincronização e não serão visíveis a outros clientes.

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

Exemplo: Pretende oferecer um runbook "Private Runbook" 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