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

# Hybrid Runbook Worker

Executar runbooks do RealmJoin num Hybrid Runbook Worker para que possam aceder a recursos locais e de rede privada que a cloud Azure não consegue.

Por defeito, os runbooks do RealmJoin são executados na **cloud de Azure Automation da Microsoft**. Isso é perfeito para tarefas em serviços cloud (Entra ID, Intune, Exchange Online, …), mas a cloud não tem visibilidade para a sua **local** ou outra rede privada.

Uma **Hybrid Runbook Worker** resolve isso. É uma máquina que executa dentro do seu próprio ambiente (por exemplo, localmente ou numa rede cloud privada) e que regista na sua Azure Automation Account. Os runbooks que apontam para esse worker são executados **nessa máquina, dentro da sua rede**, enquanto continuam a ser iniciados, monitorizados e auditados através do RealmJoin, tal como qualquer outro runbook.

## Porque poderá querer usá-lo

Use um Hybrid Runbook Worker sempre que um runbook precise de aceder a algo que a cloud do Azure não consegue:

* Local **Active Directory**, servidores de ficheiros ou servidores de impressão
* Aplicações de negócio e bases de dados alojadas no seu próprio datacenter
* Dispositivos de rede, appliances ou APIs internas que não estão expostas à internet
* Qualquer recurso que tenha de ser acedido a partir da sua rede corporativa por motivos de segurança ou de conectividade

Mantém a conveniência da experiência de runbook do RealmJoin (self-service, permissões, aprovações, registo) enquanto o trabalho real acontece onde os seus recursos estão.

## Como funciona

* **Onde é executado.** Um runbook normal é executado no sandbox da cloud do Azure. Em vez disso, um runbook híbrido é entregue ao seu Hybrid Runbook Worker, para que seja executado na sua própria máquina e possa comunicar com os seus recursos internos.
* **Que runbooks são híbridos.** O RealmJoin reconhece um runbook como "híbrido" pelo seu nome: os runbooks cujo nome termina com **`_hybrid`** são encaminhados para o seu Hybrid Worker Group. Todos os outros runbooks continuam a ser executados na cloud como antes.
* **Onde é executado, mais precisamente.** Quando um runbook híbrido arranca, o RealmJoin envia-o para o **Hybrid Worker Group** que configurou. Um grupo de workers pode conter uma ou mais máquinas; o Azure Automation escolhe um worker disponível nesse grupo para fazer o trabalho.

{% hint style="info" %}
Ativar esta funcionalidade não **não** move os seus runbooks existentes para fora da cloud. Apenas os runbooks nomeados com o `_hybrid` sufixo são encaminhados para o Hybrid Runbook Worker.
{% endhint %}

## Pré-requisitos

Antes de poder ativar a funcionalidade no RealmJoin, precisa de um Hybrid Runbook Worker funcional na sua Azure Automation Account:

1. Implemente e registe uma ou mais máquinas como um **Hybrid Runbook Worker Group** na sua Azure Automation Account. Consulte o guia da Microsoft sobre [Hybrid Runbook Workers](https://learn.microsoft.com/en-us/azure/automation/automation-hybrid-runbook-worker) para os passos de configuração.
2. Certifique-se de que essas máquinas têm acesso de rede aos recursos locais ou privados de que os seus runbooks precisam.

{% hint style="warning" %}
Se não existir nenhum Hybrid Runbook Worker Group na sua Automation Account, o RealmJoin não poderá disponibilizar um para selecionar e pedir-lhe-á primeiro que registe um worker.
{% endhint %}

## Ativá-lo no RealmJoin

{% stepper %}
{% step %}

### Abra as definições do seu runbook

No Portal do RealmJoin, vá às definições do seu runbook. A opção Hybrid Runbook Worker fica disponível assim que a configuração inicial do runbook tiver sido guardada.
{% endstep %}

{% step %}

### Ative a sincronização do Hybrid Runbook Worker

Ativar **Ativar a sincronização do Hybrid Runbook Worker**. O RealmJoin lerá os Hybrid Worker Groups registados na sua Azure Automation Account.
{% endstep %}

{% step %}

### Escolha um Hybrid Worker Group

Selecione a **Hybrid Worker Group** onde os seus runbooks híbridos devem ser executados e, depois, guarde. Este torna-se o destino predefinido para todos os `_hybrid` runbooks no seu Tenant.
{% endstep %}
{% endstepper %}

## Executar um runbook híbrido

Executar um runbook híbrido funciona exatamente como qualquer outro runbook — a sua equipa de suporte e administração não precisa de fazer nada de especial.

* Quando um runbook é direcionado para um Hybrid Runbook Worker, a caixa de diálogo de execução mostra uma nota como *"Será executado no grupo de Hybrid Runbook Worker: …"* para que fique claro onde a tarefa será executada.
* Se um runbook estiver configurado com mais do que um grupo de workers à escolha, o operador pode **selecionar qual Hybrid Runbook Worker Group** usar ao iniciá-lo.
* Runbooks que exigem [aprovação](https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-permissions.md) mantêm o grupo de workers selecionado, para que a tarefa seja executada no worker pretendido, depois de aprovada.

{% hint style="info" %}
Os registos dos runbooks e os detalhes dos jobs estão disponíveis no Portal do RealmJoin como habitualmente — consulte [Registos de Runbook](https://docs.realmjoin.com/pt/automatizacao/runbooks/runbook-logs.md) — independentemente de um runbook ter sido executado na cloud ou num 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/pt/automatizacao/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.
