Conventions de nommage des runbooks

Conventions de nommage des runbooks RealmJoin : comment le contexte et la catégorie mappent les noms de runbooks du dépôt partagé vers Azure Automation et le portail.

Noms de fichiers dans GitHub

Nous attendons une certaine structure de fichiers et de nommage dans le dépôt partagé de runbooks. RealmJoin importera ces dossiers et fichiers depuis GitHub dans le compte Azure Automation du client.

Les tirets («-») seront convertis en espaces. Les dossiers servent à séparer les runbooks en «contexte» et «catégorie», par ex. user\general. Les noms de fichiers doivent décrire le but du script.

Tous les runbooks importés ont un préfixe de rjgit-, suivi du contexte, soit org, groupe, utilisateur ou appareil puis de la catégorie, par exemple _general_, _security_, _mail_ et le nom du script lui-même, comme add-additional-alias.

Exemple :

Un runbook dans GitHub dans user\general nommé add-additional-alias.ps1 sera affiché comme suit :

• rjgit-user_general_add-additional-alias dans le compte Azure Automation
• "Add Additional Alias" dans le portail RealmJoin sur un objet utilisateur dans la catégorie de runbook «General».

Catégories courantes

• Général
• Sécurité
• Courrier
• Informations utilisateur

Vous pouvez définir des catégories supplémentaires, mais pas de contextes.

Quel est le but de cela ?

Cela permet de remplir et de nommer automatiquement les runbooks dans le portail RealmJoin. De plus, le rjgit- préfixe permet d’éviter les conflits de nommage avec les runbooks locaux/client. Les runbooks ne comportant pas ce préfixe ne seront pas modifiés par la logique d’import de RealmJoin.

Runbooks privés / spécifiques au client

Vous pouvez héberger des runbooks privés (locaux) dans votre compte Azure Automation. Ces runbooks apparaîtront dans le portail RealmJoin, tout comme les runbooks partagés. Les runbooks locaux ne seront pas modifiés par notre processus de synchronisation et ne seront pas visibles par les autres clients.

Pour créer un runbook local, supprimez le rjgit- préfixe de la convention de nommage tout en conservant le reste de la structure de nommage intact.

Exemple : vous souhaitez proposer un runbook «Private Runbook» dans le contexte des groupes Azure AD et de la catégorie «General». Vous le nommeriez group_general_private-runbook dans votre compte Azure Automation.

Cela ressemblera à ceci dans Azure Automation :

Noms des runbooks dans GitHub / Azure Automation

Il sera présenté dans le portail RealmJoin comme suit :

Noms des runbooks dans le portail RealmJoin