> 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.

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

Une **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 démarré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 atteindre quelque chose que le cloud Azure ne peut pas :

* Sur site **Active Directory**, des serveurs de fichiers ou des serveurs d’impression
* Des applications métier et des bases de données hébergées dans votre propre centre de données
* Des périphériques réseau, des appliances ou des API internes qui ne sont pas exposés à 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 praticité de l’expérience de runbook RealmJoin (self-service, autorisations, approbations, journalisation) tandis que le travail réel s’effectue là où se trouvent vos ressources.

## Fonctionnement

* **Où il s’exécute.** Un runbook normal s’exécute dans le bac à sable cloud Azure. Un runbook hybride est plutôt confié à votre Hybrid Runbook Worker, afin de s’exécuter sur votre propre machine et de pouvoir communiquer avec vos ressources internes.
* **Quels runbooks sont hybrides.** RealmJoin reconnaît un runbook comme « hybride » à son nom : les runbooks dont le nom se termine par **`_hybrid`** sont dirigés vers votre groupe de Hybrid Worker. 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 **groupe de Hybrid Worker** 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 **ne** 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 fonctionnel dans votre compte Azure Automation :

1. Déployez et enregistrez une ou plusieurs machines en tant que **groupe de Hybrid Runbook Worker** dans votre compte Azure Automation. Consultez le guide de Microsoft sur [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 un accès réseau aux ressources locales ou privées dont vos runbooks ont besoin.

{% hint style="warning" %}
Si aucun groupe de Hybrid Runbook Worker 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 %}

## L’activer dans RealmJoin

{% stepper %}
{% step %}

### Ouvrez les paramètres de vos runbooks

Dans le portail RealmJoin, allez dans les paramètres de vos runbooks. L’option Hybrid Runbook Worker devient disponible une fois que la configuration initiale de votre runbook a été enregistrée.
{% endstep %}

{% step %}

### Activez la synchronisation Hybrid Runbook Worker

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

{% step %}

### Choisissez un groupe de Hybrid Worker

Sélectionnez le **groupe de Hybrid Worker** 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 locataire.
{% endstep %}
{% endstepper %}

## Exécuter un runbook hybride

Exécuter un runbook hybride fonctionne exactement comme n’importe quel autre runbook — votre personnel support et administration n’a rien de particulier à 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 sera exécutée.
* Si un runbook est configuré avec plus d’un groupe de workers parmi lesquels choisir, l’opérateur peut **sélectionner le groupe de Hybrid Runbook Worker** à utiliser lors de son lancement.
* Les runbooks qui nécessitent [une approbation](https://docs.realmjoin.com/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 de runbook](https://docs.realmjoin.com/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.
