> For the complete documentation index, see [llms.txt](https://docs.plenit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plenit.com/docs-pt/productos/servers/how-to/how-to-deploy-a-load-balancer.md).

# Como Implementar um Balanceador de carga

Um balanceador de carga distribui os pedidos entre vários servidores, para que nenhum fique sobrecarregado e o serviço se mantenha operacional mesmo que um falhe.

Neste tutorial, cria uma regra de balanceamento sobre um pool de, pelo menos, dois servidores da mesma subscrição.

> #### 👍 O que obtém
>
> Uma regra de balanceamento que publica um serviço num IP público e distribui o tráfego entre os servidores que escolher.

### Como se integra o balanceamento

O tráfego chega a um IP e a uma porta públicos, e o balanceador distribui-o pelos servidores do pool de acordo com um algoritmo. Para que isto funcione, todos os servidores do pool têm de servir o mesmo: o balanceamento distribui a carga, não sincroniza o conteúdo.

> #### 📘 Distribui carga, não é alta disponibilidade total
>
> O balanceamento melhora a disponibilidade e absorve picos, mas não torna o seu serviço infalível.
>
> Se um servidor do pool servir algo diferente dos restantes, o Cliente verá respostas inconsistentes. Mantenha o mesmo conteúdo e configuração em todos.

### Antes de começar

* Iniciar sessão na plataforma Plenit com um Utilizador com Permissões de administração sobre a Organização.
* Ter, pelo menos, **dois Servidores** implementados na mesma Subscrição. Pode criar a regra antes de os adicionar e incorporá-los depois.

### Passo 1. Aceda a Load Balancers

1. Entra na subscrição de **Servidores** a partir do respetivo cartão.
2. Abre a subsecção **Load Balancers** dentro do menu de servidores.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-b7f21f4a8a9076dfb8340e761f32903177e22b47%2FCAPTURA%201%20y%202%C2%B7%20men%C3%BA%20lateral%20con%20la%20subsecci%C3%B3n%20Load%20Balancers%20y%20network%20con%20new%20rule%20(6).jpg?alt=media" alt=""><figcaption><p>Subseção Load Balancers</p></figcaption></figure>

### Passo 2. Crie uma nova regra

Se ainda não existirem regras, verá o Ecrã inicial para criar uma; se já existirem, verá a lista. Selecione a **Network** sobre a qual vai criar a regra e clique em **New rule**.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-76c5f4a730c361ffb60e380dc636f51eb52ba3f1%2FCAPTURA%201%20y%202%C2%B7%20men%C3%BA%20lateral%20con%20la%20subsecci%C3%B3n%20Load%20Balancers%20y%20network%20con%20new%20rule%20(7).jpg?alt=media" alt="Creación de una nueva regla de balanceo sobre una red"><figcaption><p>Criação de uma nova regra de balanceamento numa Rede</p></figcaption></figure>

### Passo 3. Configure a rede, o IP e as portas

1. Escolha a rede com **Seleciona a rede**.
2. Selecione um **IP público** dos disponíveis para essa rede.
3. Define o **Protocolo** (`TCP` ou `UDP`), a **Porta pública** (pela qual entram os pedidos da Internet, por exemplo `80` ou `443`) e a **Porta privada** (para a qual são reencaminhados internamente).
4. Clica em **Seguinte**.

> #### 🚧 Uma porta, uma única utilização por rede
>
> Dentro da mesma rede, uma porta só pode ser utilizada uma vez: não pode haver duas regras para a mesma porta no mesmo espaço de rede.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-52396939d55000954e23d7ccfce62da027dfa4b0%2FCAPTURA%203%20%C2%B7%20campos%20Public%20IP%2C%20Protocol%2C%20Public%20Port%20y%20Private%20Port.jpg?alt=media" alt="Configuración de IP, protocolo y puertos"><figcaption><p>Configuração de IP, protocolo e portas</p></figcaption></figure>

### Passo 4. Defina que redes terão acesso

Indique a partir de que IPs é possível aceder ao serviço publicado:

* **Any**: acesso a partir de qualquer rede. É a opção menos segura.
* **Specify**: acesso apenas a partir dos IPs ou intervalos que indicar.

Com **Specify**, introduza o IP ou o intervalo permitido (pode adicionar vários) e clique em **Seguinte**.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-f7d9c69c24d9684b74cd17ae5bbab8051929e51e%2FCAPTURA%204%20%C2%B7%20opci%C3%B3n%20Specify%20con%20la%20IP%20o%20rango%20permitido.jpg?alt=media" alt="Definición de las redes con acceso al servicio publicado"><figcaption><p>Definição das redes com acesso ao serviço publicado</p></figcaption></figure>

### Passo 5. Escolha o algoritmo e a afinidade

Selecione como os pedidos são distribuídos entre os servidores do pool:

| Algoritmo         | O que faz                                                   | Quando faz sentido                                          |
| ----------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
| Round Robin       | Distribui alternadamente, de forma circular                 | Caso geral, servidores equivalentes                         |
| Least connections | Envia cada pedido para o servidor com menos ligações ativas | Pedidos de duração desigual                                 |
| Source            | Atribui de acordo com o IP de origem                        | Quando o mesmo Cliente deve ir sempre para o mesmo servidor |

Depois, decida se ativa as **regras de afinidade**. Ative-as se a aplicação guardar o estado da sessão no próprio servidor e não o partilhar entre máquinas; se o fizer, preencha **Table size (KB)** e **Expiration(s)**. Clica **Seguinte**.

> 📘 A afinidade mantém o Cliente no mesmo servidor
>
> Sem estado partilhado entre servidores, distribuir às cegas pode interromper a sessão de um Utilizador a meio da navegação. A afinidade evita isso, associando-o a um servidor, em troca de uma distribuição um pouco menos uniforme.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-5f2c0f48d24b30f26284a4e56b18da43bda046a3%2FCAPTURA%205%20%C2%B7%20selecci%C3%B3n%20del%20algoritmo%20y%20la%20opci%C3%B3n%20de%20afinidad.jpg?alt=media" alt="Selección del algoritmo de reparto y la afinidad"><figcaption><p>Seleção do algoritmo de distribuição e da afinidade</p></figcaption></figure>

### Passo 6. Selecione os servidores do pool

Escolha as máquinas que responderão aos pedidos. Clique em cada elemento apresentado como **Not selected** e atribua-lhe o IP correspondente. Um servidor corretamente adicionado apresenta uma marca de verificação e o contorno assinalado com a cor da Plenit. Quando terminar, clique em **Create Rule**.

<figure><img src="https://1427657614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxksPMyYRDCe4qKkhbpcY%2Fuploads%2Fgit-blob-4afd16fc265381462e0f003992caeda4fc6dd625%2FCAPTURA%206%20%C2%B7%20selecci%C3%B3n%20de%20los%20servidores%20del%20pool%20con%20el%20check%20de%20a%C3%B1adido.jpg?alt=media" alt="Selección de los servidores que forman el pool del balanceador"><figcaption><p>Seleção dos servidores que compõem o pool do balanceador</p></figcaption></figure>

### Passo 7. Verifique se a regra foi criada

Durante a criação, verá uma mensagem do tipo `Servers: Creating Load Balancer ...` e, no final, outra a confirmar que foi criada corretamente. A regra aparece na lista, embora possa ter de atualizar o Ecrã.

Para verificar se o serviço responde realmente, teste o endpoint público a partir do exterior. Em Linux ou macOS:

```bash
curl -I http://<IP-PUBLICA>:<PUERTO-PUBLICO>
```

No Windows, a partir do PowerShell:

```powershell
Test-NetConnection <IP-PUBLICA> -Port <PUERTO-PUBLICO>
```

E, em cada servidor do pool, confirme que o serviço está a escutar na porta privada. Em Linux:

```bash
ss -tlnp | grep <PUERTO-PRIVADO>
```

Em Windows:

```powershell
netstat -ano | findstr <PUERTO-PRIVADO>
```

### Se algo não estiver correto

| Sintoma                                  | Causa provável                                          | O que fazer                                                  |
| ---------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------ |
| Não permite criar a regra devido à porta | Essa porta já está em Utilização na Rede                | Utilize outra porta pública ou liberte a existente           |
| O endpoint público não responde          | Nenhum servidor do pool está a escutar na porta privada | Verifique com `ss` / `netstat` se o serviço está em execução |
| Um Utilizador perde a sessão ao navegar  | Distribuição sem estado partilhado                      | Ative a afinidade ou partilhe o estado entre servidores      |

### Conclusão

Com isto, tem um serviço publicado atrás de um balanceador que distribui o tráfego entre vários servidores, o que suaviza os picos e mantém o serviço mesmo que uma máquina falhe. O balanceamento tem um desempenho realmente eficaz quando o pool é homogéneo e escolhe o algoritmo adequado à sua carga: é aí que deixa de distribuir pedidos às cegas e começa a distribuí-los com critério.


---

# 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.plenit.com/docs-pt/productos/servers/how-to/how-to-deploy-a-load-balancer.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.
