...
Eroare AWS · Load balancer (ALB) și Auto Scaling

503 Service Temporarily Unavailable

Pe scurt

Application Load Balancer-ul nu are nicio țintă sănătoasă căreia să-i trimită cererea: target group-ul e gol sau toate serverele sunt unhealthy. Înregistrează serverele în target group (register-targets sau Auto Scaling cu --target-group-arns) și verifică describe-target-health.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Pagina albă cu 503 Service Temporarily Unavailable (antetul Server: awselb/2.0) vine chiar de la load balancer, nu de la serverele tale. ALB răspunde așa când regula listener-ului trimite cererea la un target group care nu are nicio țintă sănătoasă:

  • target group-ul nu are ținte înregistrate (serverele au fost pornite, dar nu și adăugate);
  • toate țintele sunt unhealthy (health check pe o cale greșită, security group care blochează portul);
  • țintele sunt încă în initial, imediat după înregistrare.

Primul pas este mereu aws elbv2 describe-target-health --target-group-arn $TG: o listă goală înseamnă că lipsesc țintele, iar Reason arată de ce o țintă nu e sănătoasă. Dacă primești 502 Bad Gateway, serverul a primit cererea, dar a răspuns greșit sau a închis conexiunea.

De ce apare: cauzele frecvente

1Target group fără ținte

Greșit
BASH
aws ec2 run-instances ... # web-1 și web-2
aws elbv2 create-target-group --name web-tg ...
aws elbv2 create-listener ... TargetGroupArn=$TG
Corect
BASH
aws elbv2 register-targets --target-group-arn $TG --targets Id=$ID1 Id=$ID2
aws elbv2 wait target-in-service --target-group-arn $TG

Load balancer-ul trimite trafic doar la țintele înregistrate în target group.

2Auto Scaling nelegat de target group

Greșit
BASH
aws autoscaling create-auto-scaling-group --auto-scaling-group-name web-asg \
  --launch-template LaunchTemplateName=web-lt --min-size 2 --max-size 4 \
  --vpc-zone-identifier "$PUBA,$PUBB"
Corect
BASH
aws autoscaling attach-load-balancer-target-groups --auto-scaling-group-name web-asg \
  --target-group-arns $TG

Fără --target-group-arns, serverele grupului nu sunt adăugate în target group.

3Toate țintele sunt nesănătoase

Greșit
BASH
aws elbv2 describe-target-health --target-group-arn $TG
# State: unhealthy, Reason: Target.ResponseCodeMismatch
Corect
BASH
aws elbv2 modify-target-group --target-group-arn $TG --health-check-path /

Repari cauza din Reason, apoi țintele redevin healthy.

Repară tu

Repară eroarea, direct în pagină

Serverele web-1 și web-2 rulează nginx, iar load balancer-ul web-alb trimite traficul la target group-ul web-tg. Totuși, curl pe adresa load balancer-ului întoarce 503 Service Temporarily Unavailable. Află cauza cu describe-target-health, adaugă cele două servere în web-tg și așteaptă să devină sănătoase.

Indiciu

aws elbv2 register-targets --target-group-arn $TG --targets Id=$ID1 Id=$ID2, cu ID-urile citite după tag-ul Name.

Alte forme ale mesajului

  • HTTP/1.1 503 Service Unavailable
  • 502 Bad Gateway
  • <center><h1>503 Service Temporarily Unavailable</h1></center>

Cum o eviți pe viitor

  • Leagă serverele de target group din prima: --target-group-arns la Auto Scaling sau register-targets imediat după pornire.
  • Așteaptă cu aws elbv2 wait target-in-service înainte să trimiți trafic.
  • Pune o alarmă CloudWatch pe metrica HealthyHostCount < 1 a target group-ului.

Întrebări frecvente

Cum deosebesc 503 de 502 și 504?

503: nu există țintă sănătoasă. 502: ținta a răspuns invalid sau a închis conexiunea. 504: ținta n-a răspuns în timp (aplicație blocată, timeout).

Serverele merg pe IP-ul lor. De ce load balancer-ul dă 503?

Pentru că ALB trimite doar la țintele înregistrate și sănătoase din target group. Verifică întâi că serverele apar în describe-target-health.

Erori înrudite

← Toate erorile AWS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață AWS de la zero, cu exerciții la fiecare lecție

Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.