> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/hybrid-runbook-worker.md).

# ハイブリッド Runbook Worker

{% hint style="warning" %}
この機能は現在、次でのみ利用できます [portal-staging.realmjoin.com](https://portal-staging.realmjoin.com).
{% endhint %}

既定では、RealmJoin の runbook は Microsoft の **Azure Automation cloud**。これは、クラウド サービス（Entra ID、Intune、Exchange Online、…）に対するタスクには最適ですが、クラウドからはお使いの **オンプレミスの** またはその他のプライベート ネットワークを把握できません。

1つの **Hybrid Runbook Worker** これで解決します。これは、自分の環境内（たとえばオンプレミスやプライベート クラウド ネットワーク内）で実行し、Azure Automation Account に登録するマシンです。そのワーカーを対象とする runbook は実行され **そのマシン上で、ネットワーク内で**、他の runbook と同様に RealmJoin で開始・追跡・監査できます。

## これを使う理由

runbook が Azure cloud から到達できないものにアクセスする必要がある場合は、Hybrid Runbook Worker を使います:

* オンプレミス **Active Directory**、ファイル サーバー、またはプリント サーバー
* 自社のデータセンターでホストされている業務アプリケーションとデータベース
* インターネットに公開されていないネットワーク デバイス、アプライアンス、または内部 API
* セキュリティまたは接続性の理由により、社内ネットワーク内からアクセスする必要があるあらゆるリソース

実際の作業はリソースのある場所で行われますが、RealmJoin の runbook 体験（セルフサービス、権限、承認、ログ記録）の便利さはそのままです。

## 仕組み

* **実行場所。** 通常の runbook は Azure cloud のサンドボックスで実行されます。ハイブリッド runbook は代わりに Hybrid Runbook Worker に渡されるため、自分のマシンで実行され、社内リソースとやり取りできます。
* **どの runbook がハイブリッドか。** RealmJoin は、名前によって runbook を「hybrid」と認識します。名前の末尾が **`_hybrid`** の runbook は、あなたの Hybrid Worker Group にルーティングされます。その他の runbook はこれまでどおりクラウドで実行されます。
* **より正確には、どこで実行されるか。** ハイブリッド runbook が開始されると、RealmJoin はそれを **Hybrid Worker Group** として構成したグループに送ります。ワーカー グループには 1 台以上のマシンを含めることができ、Azure Automation はそのグループ内の利用可能なワーカーを選んで作業を行います。

{% hint style="info" %}
この機能を有効にしても **しません** 既存の runbook がクラウドから移動されることはありません。 `_hybrid` のサフィックスが付いた runbook だけが Hybrid Runbook Worker に送られます。
{% endhint %}

## 前提条件

RealmJoin でこの機能を有効にする前に、Azure Automation Account で動作する Hybrid Runbook Worker が必要です:

1. 1 台以上のマシンを次としてデプロイし、登録します **Hybrid Runbook Worker Group** を Azure Automation Account に。Microsoft のガイドを参照してください [Hybrid Runbook Workers](https://learn.microsoft.com/en-us/azure/automation/automation-hybrid-runbook-worker) 設定手順について。
2. それらのマシンが、runbook に必要なオンプレミスまたはプライベート リソースへネットワーク アクセスできることを確認してください。

{% hint style="warning" %}
Automation Account に Hybrid Runbook Worker Group が存在しない場合、RealmJoin は選択肢として提示できず、先にワーカーの登録を求めます。
{% endhint %}

## RealmJoin で有効にする

{% stepper %}
{% step %}

### runbook の設定を開きます

RealmJoin Portal で runbook の設定に移動します。初期の runbook 構成を保存すると、Hybrid Runbook Worker オプションが利用可能になります。
{% endstep %}

{% step %}

### Hybrid Runbook Worker の同期をオンにする

有効にする **Hybrid Runbook Worker の同期を有効にする**。RealmJoin は、Azure Automation Account に登録されている Hybrid Worker Groups を読み取ります。
{% endstep %}

{% step %}

### Hybrid Worker Group を選択する

次を選択します **Hybrid Worker Group** ハイブリッド runbook を実行する対象を選択してから、保存します。これは、すべての `_hybrid` テナント内の runbook の既定の対象になります。
{% endstep %}
{% endstepper %}

## ハイブリッド runbook の実行

ハイブリッド runbook の実行は他の runbook とまったく同じです — サポート担当者や管理担当者が特別なことをする必要はありません。

* runbook が Hybrid Runbook Worker に送られると、実行ダイアログには次のような注記が表示されます *「ハイブリッド runbook worker group で実行されます: …」* これにより、タスクがどこで実行されるかが明確になります。
* runbook に複数のワーカー グループが構成されている場合、操作担当者は **どの Hybrid Runbook Worker Group を選択するか** を開始時に使用できます。
* 必要とする runbook は [承認](/ja/zi-dong-hua/runbooks/runbook-permissions.md) 選択したワーカー グループを保持するため、承認されるとタスクは意図したワーカーで実行されます。

{% hint style="info" %}
runbook のログとジョブの詳細は、これまでどおり RealmJoin Portal で利用できます — 参照してください [Runbook ログ](/ja/zi-dong-hua/runbooks/runbook-logs.md) — runbook がクラウドで実行されたか Hybrid Runbook Worker で実行されたかに関係なく。
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/hybrid-runbook-worker.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.