CRM Docs

Target Group

Grupo de destinos do Application Load Balancer

Um Target Group define para onde o ALB envia o tráfego depois de uma regra de listener. No CRM, o tipo usual é IP (tasks ECS em modo awsvpc): cada task recebe um IP na subnet e o ECS registra esse IP no grupo quando a task fica saudável.

Papel na arquitetura

Sem Target GroupCom Target Group
ALB não sabe quais backends estão válidosSó IPs/portas healthy recebem requisições
Deploy derruba tráfego para instâncias mortasHealth check remove targets ruins automaticamente

Tipos de target

TipoUso
instanceTargets em instâncias EC2 (modo bridge/host no ECS EC2)
ipTasks Fargate/ECS awsvpc — mais comum no CRM
lambdaFunção como backend (menos comum para API principal)
albEncadeamento de load balancers

Health check

O ALB consulta periodicamente cada target; parâmetros típicos:

ParâmetroExemploSignificado
ProtocolHTTPHTTPS se o app expõe TLS no container (menos comum atrás de ALB)
Path/health ou /api/healthEndpoint que retorna 200 quando app está pronta
Porttraffic portMesma porta do registro (ex. 8080)
Healthy threshold2Sucessos seguidos para marcar healthy
Unhealthy threshold3Falhas seguidas para remover do balanceamento
Interval30 sFrequência das probes
Timeout5 sTempo máximo de resposta
Matcher200Códigos HTTP aceitos (pode incluir 200-299)

O health check deve ser leve (sem bater no banco pesado) mas honesto (falha se dependências críticas estiverem indisponíveis, se essa for a política do time). Um check que sempre retorna 200 esconde API quebrada.

Atributos úteis

AtributoEfeito
Deregistration delayTempo que target unhealthy ainda recebe conexões existentes (draining no deploy)
StickinessCookie de sessão no ALB — use só se a API exigir estado em memória local
Slow startRamp-up gradual de peso para targets novos após deploy

Balanceamento

AlgoritmoComportamento
Round robin (padrão)Distribui requisições igualmente entre targets healthy
Least outstanding requestsEnvia para quem tem menos requisições em flight — bom para latências variáveis

Deploy e ciclo de vida da task

  1. ECS sobe nova task → IP novo.
  2. ECS registra IP no Target Group.
  3. Health check passa → ALB inclui no roteamento.
  4. Deploy drena task antiga → deregistration delay → conexões terminam → task para.

Se o health check nunca passa, o deploy trava ou reverte conforme configuração do service.

Múltiplos target groups

Um ALB pode ter vários listeners/rules apontando para TGs diferentes:

CenárioExemplo
API vs admin/api/* → TG crm-api, /admin/* → outro service
Blue/greenDois TGs; rule alterna peso (avançado)
gRPC / HTTP2Mesmo ALB com regras por host/path

Relação com outros serviços

ServiçoRelação
ALBAssocia listener rule → TG
ECSService registra tasks no TG
TDPorta do container = porta do target
SGALB SG → inbound na porta da task

On this page