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

# Hybrid Runbook Worker

Ejecuta los runbooks de RealmJoin en un Hybrid Runbook Worker para que puedan الوصول a recursos locales y de red privada a los que la nube de Azure no puede acceder.

De forma predeterminada, los runbooks de RealmJoin se ejecutan en la nube de Microsoft **la nube de Azure Automation**. Eso es perfecto para tareas contra servicios en la nube (Entra ID, Intune, Exchange Online, …), pero la nube no tiene visibilidad hacia su **en las instalaciones** o cualquier otra red privada.

Una **Hybrid Runbook Worker** soluciona esto. Es una máquina que ejecutas dentro de tu propio entorno (por ejemplo, en las instalaciones o en una red privada en la nube) y registras con tu cuenta de Azure Automation. Los runbooks que se dirigen a ese worker se ejecutan **en esa máquina, dentro de tu red**, mientras siguen siendo iniciados, rastreados y auditados a través de RealmJoin, igual que cualquier otro runbook.

## Por qué podrías usarlo

Utiliza un Hybrid Runbook Worker siempre que un runbook necesite acceder a algo que la nube de Azure no puede:

* En las instalaciones **Active Directory**, servidores de archivos o servidores de impresión
* Aplicaciones y bases de datos de línea de negocio alojadas en tu propio centro de datos
* Dispositivos de red, appliances o APIs internas que no están expuestas a Internet
* Cualquier recurso al que deba accederse desde dentro de tu red corporativa por motivos de seguridad o conectividad

Conservas la comodidad de la experiencia de runbook de RealmJoin (autoservicio, permisos, aprobaciones, registro) mientras el trabajo real ocurre donde residen tus recursos.

## Cómo funciona

* **Dónde se ejecuta.** Un runbook normal se ejecuta en el sandbox de la nube de Azure. En su lugar, un runbook híbrido se entrega a tu Hybrid Runbook Worker, de modo que se ejecuta en tu propia máquina y puede comunicarse con tus recursos internos.
* **Qué runbooks son híbridos.** RealmJoin reconoce un runbook como "híbrido" por su nombre: los runbooks cuyo nombre termina con **`_hybrid`** se enrutan a tu Hybrid Worker Group. Todos los demás runbooks continúan ejecutándose en la nube como antes.
* **Dónde se ejecuta, con más precisión.** Cuando un runbook híbrido se inicia, RealmJoin lo envía al **Hybrid Worker Group** que configuraste. Un grupo de workers puede contener una o más máquinas; Azure Automation elige un worker disponible en ese grupo para hacer el trabajo.

{% hint style="info" %}
Habilitar esta característica no **no** mueve tus runbooks existentes fuera de la nube. Solo los runbooks nombrados con el `_hybrid` sufijo se dirigen al Hybrid Runbook Worker.
{% endhint %}

## Requisitos previos

Antes de poder habilitar la característica en RealmJoin, necesitas un Hybrid Runbook Worker funcional en tu cuenta de Azure Automation:

1. Implementa y registra una o más máquinas como un **Grupo de Hybrid Runbook Worker** en tu cuenta de Azure Automation. Consulta la guía de Microsoft sobre [Hybrid Runbook Workers](https://learn.microsoft.com/en-us/azure/automation/automation-hybrid-runbook-worker) para ver los pasos de configuración.
2. Asegúrate de que esas máquinas tengan acceso de red a los recursos locales o privados que necesitan tus runbooks.

{% hint style="warning" %}
Si no existe ningún Grupo de Hybrid Runbook Worker en tu cuenta de Azure Automation, RealmJoin no puede ofrecer uno para seleccionar y te pedirá que registres primero un worker.
{% endhint %}

## Habilitarlo en RealmJoin

{% stepper %}
{% step %}

### Abre la configuración de tu runbook

En el Portal de RealmJoin, ve a la configuración de tu runbook. La opción de Hybrid Runbook Worker está disponible una vez que se haya guardado la configuración inicial de tu runbook.
{% endstep %}

{% step %}

### Activa la sincronización de Hybrid Runbook Worker

Activar **Habilitar la sincronización de Hybrid Runbook Worker**. RealmJoin leerá los Grupos de Hybrid Worker registrados en tu cuenta de Azure Automation.
{% endstep %}

{% step %}

### Elige un Grupo de Hybrid Worker

Seleccione el **Hybrid Worker Group** en el que deban ejecutarse tus runbooks híbridos, y luego guarda. Esto se convierte en el destino predeterminado para todos los `_hybrid` runbooks de tu tenant.
{% endstep %}
{% endstepper %}

## Ejecución de un runbook híbrido

Ejecutar un runbook híbrido funciona exactamente igual que cualquier otro runbook; tu personal de soporte y administración no necesita hacer nada especial.

* Cuando un runbook se dirige a un Hybrid Runbook Worker, el diálogo de ejecución muestra una nota como *"Se ejecutará en el grupo de Hybrid Runbook Worker: …"* para que quede claro dónde se ejecutará la tarea.
* Si un runbook está configurado con más de un grupo de workers entre los que elegir, el operador puede **seleccionar qué Grupo de Hybrid Runbook Worker** usar al iniciarlo.
* Los runbooks que requieren [aprobación](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-permissions.md) conservan el grupo de workers seleccionado, de modo que la tarea se ejecuta en el worker previsto una vez aprobada.

{% hint style="info" %}
Los registros del runbook y los detalles del trabajo están disponibles en el Portal de RealmJoin como de costumbre — consulta [Runbook Logs](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-logs.md) — independientemente de si un runbook se ejecutó en la nube o en 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/es/automatizacion/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.
