> 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/fr/automatisation/runbooks/hybrid-runbook-worker.md).

# Hybrid Runbook Worker

Exécutez des RealmJoin runbooks sur un Hybrid Runbook Worker afin qu’ils puissent atteindre des ressources sur site et privées auxquelles le cloud Azure ne peut pas accéder.

{% hint style="warning" %}
Cette fonctionnalité est actuellement disponible uniquement sur [portal-staging.realmjoin.com](https://portal-staging.realmjoin.com).
{% endhint %}

Par défaut, les RealmJoin Runbooks s'exécutent dans le **cloud Azure Automation**. C'est parfait pour les tâches visant des services cloud (Entra ID, Intune, Exchange Online, …), mais le cloud n'a aucune visibilité sur votre **sur site** ou tout autre réseau privé.

Un **Hybrid Runbook Worker** résout ce problème. C'est une machine que vous exécutez dans votre propre environnement (par exemple sur site, ou dans un réseau cloud privé) et que vous enregistrez auprès de votre compte Azure Automation. Les runbooks qui ciblent ce worker s'exécutent **sur cette machine, à l'intérieur de votre réseau**, tout en étant toujours lancés, suivis et audités via RealmJoin, comme n'importe quel autre runbook.

## Pourquoi vous pourriez l'utiliser

Utilisez un Hybrid Runbook Worker chaque fois qu'un runbook doit accéder à quelque chose que le cloud Azure ne peut pas :

* Sur site **Active Directory**, des serveurs de fichiers ou des serveurs d'impression
* des applications et bases de données métier hébergées dans votre propre datacenter
* des équipements réseau, des appliances ou des API internes qui ne sont pas exposées à Internet
* toute ressource qui doit être accessible depuis votre réseau d'entreprise pour des raisons de sécurité ou de connectivité

Vous conservez la commodité de l'expérience des runbooks de RealmJoin (self-service, permissions, approbations, journalisation) tandis que le travail réel s'effectue là où résident vos ressources.

## Fonctionnement

* **Où il s'exécute.** Un runbook normal s'exécute dans le bac à sable du cloud Azure. Un runbook hybride est instead transmis à votre Hybrid Runbook Worker, de sorte qu'il s'exécute sur votre propre machine et peut संवाद?
* **Quels runbooks sont hybrides.** RealmJoin reconnaît un runbook comme « hybride » par son nom : les runbooks dont le nom se termine par **`_hybrid`** sont acheminés vers votre Hybrid Worker Group. Tous les autres runbooks continuent de s'exécuter dans le cloud comme auparavant.
* **Où il s'exécute, plus précisément.** Lorsqu'un runbook hybride démarre, RealmJoin l'envoie au **Hybrid Worker Group** que vous avez configuré. Un groupe de workers peut contenir une ou plusieurs machines ; Azure Automation choisit un worker disponible dans ce groupe pour effectuer le travail.

{% hint style="info" %}
L'activation de cette fonctionnalité ne **renverrait** déplace pas vos runbooks existants hors du cloud. Seuls les runbooks nommés avec le `_hybrid` suffixe sont dirigés vers le Hybrid Runbook Worker.
{% endhint %}

## Prérequis

Avant de pouvoir activer la fonctionnalité dans RealmJoin, vous devez disposer d'un Hybrid Runbook Worker opérationnel dans votre compte Azure Automation :

1. Déployez et enregistrez une ou plusieurs machines comme **Hybrid Runbook Worker Group** dans votre compte Azure Automation. Consultez le guide de Microsoft sur les [Hybrid Runbook Workers](https://learn.microsoft.com/en-us/azure/automation/automation-hybrid-runbook-worker) pour les étapes de configuration.
2. Assurez-vous que ces machines ont accès au réseau vers les ressources sur site ou privées dont vos runbooks ont besoin.

{% hint style="warning" %}
Si aucun Hybrid Runbook Worker Group n'existe dans votre compte Automation, RealmJoin ne peut pas en proposer un à sélectionner et vous demandera d'enregistrer d'abord un worker.
{% endhint %}

## Activation dans RealmJoin

{% stepper %}
{% step %}

### Ouvrez les paramètres de votre runbook

Dans le portail RealmJoin, accédez aux paramètres de votre runbook. L'option Hybrid Runbook Worker devient disponible une fois la configuration initiale de votre runbook enregistrée.
{% endstep %}

{% step %}

### Activez la synchronisation Hybrid Runbook Worker

Activer **Activer la synchronisation du Hybrid Runbook Worker**. RealmJoin lira les Hybrid Worker Groups enregistrés dans votre compte Azure Automation.
{% endstep %}

{% step %}

### Choisissez un Hybrid Worker Group

Sélectionnez **Hybrid Worker Group** sur lequel vos runbooks hybrides doivent s'exécuter, puis enregistrez. Cela devient la cible par défaut pour tous les `_hybrid` runbooks de votre Tenant.
{% endstep %}
{% endstepper %}

## Exécution d'un runbook hybride

L'exécution d'un runbook hybride fonctionne exactement comme n'importe quel autre runbook — votre personnel de support et d'administration n'a rien de spécial à faire.

* Lorsqu'un runbook est dirigé vers un Hybrid Runbook Worker, la boîte de dialogue d'exécution affiche une note telle que *« S'exécutera sur le groupe de Hybrid Runbook Worker : … »* afin qu'il soit clair où la tâche s'exécutera.
* Si un runbook est configuré avec plus d'un groupe de workers parmi lesquels choisir, l'opérateur peut **sélectionner le Hybrid Runbook Worker Group** à utiliser lors de son lancement.
* Les runbooks qui nécessitent [une approbation](/fr/automatisation/runbooks/runbook-permissions.md) conservent le groupe de workers sélectionné, de sorte que la tâche s'exécute sur le worker prévu une fois approuvée.

{% hint style="info" %}
Les journaux des runbooks et les détails des tâches sont disponibles dans le portail RealmJoin comme d'habitude — voir [journaux Runbook](/fr/automatisation/runbooks/runbook-logs.md) — que le runbook ait été exécuté dans le cloud ou sur un 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/fr/automatisation/runbooks/hybrid-runbook-worker.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.