Runbook の命名規則

RealmJoin runbook の命名規則: コンテキストとカテゴリが、共有リポジトリの runbook 名を Azure Automation とポータルでどのように対応付けるか。

GitHub のファイル名

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

ダッシュ（"-"）はスペースに変換されます。フォルダーは、ランブックを「コンテキスト」と「カテゴリ」に分けるために使われます。例: user\general. ファイル名は、スクリプトの目的を表すものにしてください。

インポートされたすべてのランブックには、次のプレフィックスが付きます rjgit-、続いてコンテキスト、つまり org, group, user または device 次にカテゴリ、たとえば _general_, _security_, _mail_ と、スクリプト名そのもの、たとえば add-additional-alias.

例:

GitHub 上のランブックで user\general という名前の add-additional-alias.ps1 は次のように表示されます:

• rjgit-user_general_add-additional-alias Azure Automation アカウント内で
• ユーザー オブジェクト上の RealmJoin ポータルでは、ランブック カテゴリ「一般」の「Add Additional Alias」として表示されます。

一般的なカテゴリ

• 一般
• セキュリティ
• メール
• ユーザー情報

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

これは何のためですか？

これにより、RealmJoin ポータル内でランブックを自動的に入力し、名前を付けることができます。さらに、 rjgit- プレフィックスは、ローカル／顧客固有のランブックとの命名競合を避けるのに役立ちます。このプレフィックスのないランブックは、RealmJoin のインポート ロジックの対象になりません。

非公開 / 顧客固有のランブック

Azure Automation アカウントで非公開（ローカル）ランブックをホストできます。これらのランブックは、共有ランブックと同様に RealmJoin ポータルに表示されます。ローカル ランブックは当社の同期プロセスの対象にならず、他の顧客からは表示されません。

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

たとえば、Azure AD グループのコンテキストでカテゴリ「一般」のランブック「Private Runbook」を提供したい場合、それを group_general_private-runbook と Azure Automation アカウント内で名付けます。

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

GitHub / Azure Automation のランブック名

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

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