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

# Trabalhador de Runbook Híbrido

{% hint style="warning" %}
Esta funcionalidade está atualmente disponível apenas no [portal-staging.realmjoin.com](https://portal-staging.realmjoin.com).
{% endhint %}

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

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

## Porque o pode usar

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

* No local **Active Directory**, servidores de ficheiros ou servidores de impressão
* Aplicações e bases de dados de negócio 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 de dentro da sua rede corporativa por motivos de segurança ou conectividade

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

## Como funciona

* **Onde é executado.** Um runbook normal é executado no sandbox da cloud Azure. Em vez disso, um runbook híbrido é entregue ao seu Hybrid Runbook Worker, pelo que é executado na sua própria máquina e pode comunicar com os seus recursos internos.
* **Quais runbooks são híbridos.** O RealmJoin reconhece um runbook como "híbrido" pelo nome: os runbooks cujo nome termina em **`_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 é iniciado, 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** retira os seus runbooks existentes da cloud. Apenas os runbooks nomeados com o `_hybrid` sufixo são direcionados 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 conseguirá oferecer um para selecionar e pedir-lhe-á que registe primeiro um worker.
{% endhint %}

## A ativação no RealmJoin

{% stepper %}
{% step %}

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

No Portal RealmJoin, vá para as definições do seu runbook. A opção Hybrid Runbook Worker fica disponível assim que a configuração inicial do seu 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 irá ler os Hybrid Worker Groups registados na sua Azure Automation Account.
{% endstep %}

{% step %}

### Escolha um Hybrid Worker Group

Selecione a **Hybrid Worker Group** no qual os seus runbooks híbridos devem ser executados e depois guarde. Isto 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 — o seu pessoal 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 de um grupo de workers à escolha, o operador pode **selecionar qual Hybrid Runbook Worker Group** usar ao iniciá-lo.
* Os runbooks que requerem [aprovação](/pt/automacao/runbooks/runbook-permissions.md) mantêm o grupo de workers selecionado, para que a tarefa seja executada no worker pretendido assim que for aprovada.

{% hint style="info" %}
Os registos dos runbooks e os detalhes dos trabalhos estão disponíveis no Portal RealmJoin como habitualmente — consulte [Registos de Runbook](/pt/automacao/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 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/pt/automacao/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.