> 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

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

Par défaut, les runbooks RealmJoin s'exécutent dans le cloud Azure Automation de Microsoft **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. Il s'agit d'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 destinés à 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 atteindre quelque chose que le cloud Azure ne peut pas :

* Sur site **Active Directory**, serveurs de fichiers ou serveurs d'impression
* Applications métier et bases de données hébergées dans votre propre centre de données
* Équipements réseau, appliances ou 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 praticité de l'expérience de runbook de RealmJoin (autoservice, autorisations, 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 remis à votre Hybrid Runbook Worker à la place, afin qu'il s'exécute sur votre propre machine et puisse communiquer avec vos ressources internes.
* **Quels runbooks sont hybrides.** RealmJoin reconnaît qu'un runbook est « hybride » à son nom : les runbooks dont le nom se termine par **`_hybrid`** sont acheminé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 **renverrait pas** 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 avez besoin d'un Hybrid Runbook Worker opérationnel 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 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'abord d'enregistrer un worker.
{% endhint %}

## L'activer 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 que la configuration initiale de votre runbook a été enregistrée.
{% endstep %}

{% step %}

### Activez la synchronisation Hybrid Runbook Worker

Activer **Activer la synchronisation 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 Tenant.
{% endstep %}
{% endstepper %}

## Exécution d'un runbook hybride

L'exécution d'un runbook hybride fonctionne exactement comme n'importe quel autre runbook — vos équipes de support et d'administration n'ont 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 s'exécutera.
* Si un runbook est configuré avec plusieurs groupes 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é, afin 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](/fr/automatisation/runbooks/runbook-logs.md) — qu'un 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 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/fr/automatisation/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.