Runbook の命名規則

GitHub のファイル名

当社は次のファイルおよび命名構造を想定しています 共有ランブックリポジトリ。RealmJoin はこれらのフォルダとファイルを GitHub から顧客の Azure Automation アカウントにインポートします。

ダッシュ（"-"）はスペースに変換されます。フォルダはランブックを「コンテキスト」と「カテゴリ」に分けるために使用されます。例： user\general。ファイル名はスクリプトの目的を示すべきです。

インポートされたすべてのランブックには次のプレフィックスが付きます rjgit-、続いてコンテキスト（いずれか） org, group, user その後にカテゴリ、例えば _general_, _security_, _mail_ およびスクリプト自体の名前（例） add-additional-alias.

例：

GitHub のランブックが user\general にある場合の add-additional-alias.ps1 と名付けられている は次のように表示されます：

• rjgit-user_general_add-additional-alias Azure Automation アカウント内で

• RealmJoin ポータルのユーザーオブジェクト上のランブックカテゴリ「General」に表示される「Add Additional Alias」。

一般的なカテゴリ

• General

• Security

• Mail

• Userinfo

追加のカテゴリを定義することはできますが、コンテキストは定義できません。

これは何のためですか？

これにより、RealmJoin ポータル内のランブックを自動的に埋めて命名することができます。また、 rjgit- プレフィックスはローカル／顧客のランブックとの命名の競合を回避することを可能にします。このプレフィックスを持たないランブックは RealmJoin のインポートロジックによって触れられません。

プライベート／顧客固有のランブック

Azure Automation アカウント内にプライベート（ローカル）ランブックをホストできます。これらのランブックは共有ランブックと同様に RealmJoin ポータルに表示されます。ローカルランブックは当社の同期プロセスによって変更されず、他の顧客からは見えません。

ローカルランブックを作成するには、命名規則から rjgit- プレフィックスを取り除き、残りの命名構造はそのままにしてください。

例：Azure AD グループのコンテキストでカテゴリ「General」の「Private Runbook」というランブックを提供したい場合は、次のように命名します group_general_private-runbook をあなたの Azure Automation アカウント内に。

Azure Automation では次のように表示されます：

GitHub / Azure Automation のランブック名

RealmJoin ポータルでは次のように表示されます：

RealmJoin ポータルのランブック名