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

{% hint style="warning" %}
Esta función actualmente solo está disponible en [portal-staging.realmjoin.com](https://portal-staging.realmjoin.com).
{% endhint %}

De forma predeterminada, los runbooks de RealmJoin se ejecutan en 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 de tus **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 de nube privada) 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 iniciándose, registrándose y auditándose a través de RealmJoin como cualquier otro runbook.

## Por qué podrías usarlo

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

* En las instalaciones **Active Directory**, servidores de archivos o servidores de impresión
* Aplicaciones y bases de datos de negocio alojadas en tu propio centro de datos
* Dispositivos de red, equipos especializados o API 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

Mantienes la comodidad de la experiencia de runbooks de RealmJoin (autoservicio, permisos, aprobaciones, registro) mientras el trabajo real se realiza 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 cambio, un runbook híbrido se entrega a tu Hybrid Runbook Worker, por lo 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 en **`_hybrid`** se enrutan a tu grupo de Hybrid Runbook Worker. Todos los demás runbooks continúan ejecutándose en la nube como antes.
* **Dónde se ejecuta, con más precisión.** Cuando se inicia un runbook híbrido, RealmJoin lo envía al **grupo de Hybrid Runbook Worker** que configuraste. Un grupo de workers puede contener una o más máquinas; Azure Automation selecciona un worker disponible en ese grupo para realizar el trabajo.

{% hint style="info" %}
Habilitar esta función no **devolvería** mueve tus runbooks existentes fuera de la nube. Solo los runbooks que tengan el `_hybrid` sufijo se dirigen al Hybrid Runbook Worker.
{% endhint %}

## Requisitos previos

Antes de poder habilitar la función en RealmJoin, necesitas un Hybrid Runbook Worker operativo en tu Azure Automation Account:

1. Implementa y registra una o más máquinas como un **grupo de Hybrid Runbook Worker** en tu Azure Automation Account. Consulta la guía de Microsoft sobre [Hybrid Runbook Workers](https://learn.microsoft.com/en-us/azure/automation/automation-hybrid-runbook-worker) para 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 Automation Account, RealmJoin no podrá ofrecerte 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 Hybrid Runbook Worker estará disponible una vez que se haya guardado la configuración inicial de tu runbook.
{% endstep %}

{% step %}

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

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

{% step %}

### Elige un grupo de Hybrid Runbook Worker

Seleccione la **grupo de Hybrid Runbook Worker** en el que deben 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 %}

## Ejecutar 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 cuadro 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](/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 [Registros de runbook](/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.