...
Eroare Docker · Imagini, tag-uri și registry

toomanyrequests: You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limit

Pe scurt

Docker Hub limitează numărul de descărcări pe o perioadă, mai strict pentru utilizatorii nelogați (limita se numără pe adresa IP). Loghează-te cu docker login, refolosește imaginile deja descărcate, fixează taguri ca să nu tragi mereu din nou și, în firmă, folosește un mirror sau registry-ul propriu.

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

Ce înseamnă

Fiecare docker pull (și fiecare FROM dintr-un build care descarcă manifestul) contează la limita de descărcări a Docker Hub. Când o depășești, registry-ul răspunde cu HTTP 429, iar Docker afișează toomanyrequests.

Pentru utilizatorii nelogați, limita se aplică adresei IP. De aceea eroarea apare des în firmă sau în CI, unde zeci de oameni sau joburi ies pe internet prin aceeași adresă: tu ai descărcat puțin, dar colegii au consumat limita. Utilizatorii logați au limita proprie, mai mare, iar abonamentele plătite au limite și mai mari.

Mesajul exact s-a schimbat în timp (variantele mai noi spun unauthenticated pull rate limit), dar reparația e aceeași: autentificare, mai puține descărcări inutile și cache.

De ce apare: cauzele frecvente

1Pull-uri nelogate dintr-o rețea comună

Greșit
BASH
docker pull redis:7
Corect
BASH
cat ~/token.txt | docker login -u andrei --password-stdin
docker pull redis:7

Logat, limita e a contului tău, nu a adresei IP împărțite cu toată firma.

2Pipeline care descarcă la fiecare rulare

Greșit
BASH
docker build --pull --no-cache -t api .
Corect
BASH
docker build -t api .

--pull și --no-cache forțează descărcarea imaginii de bază de fiecare dată. Fără ele, build-ul refolosește imaginea locală.

3Tagul latest, verificat mereu

Greșit
BASH
FROM node:latest
Corect
BASH
FROM node:20-alpine

Cu un tag fix, refolosești imaginea locală mai mult timp și știi exact ce versiune rulezi.

Repară tu

Repară eroarea, direct în pagină

Pe un calculator din firmă, docker pull redis:7 dă toomanyrequests: You have reached your pull rate limit. Loghează-te pe Docker Hub ca andrei cu tokenul din ~/token.txt, apoi descarcă redis:7 și pornește din el containerul cache.

Indiciu

cat ~/token.txt | docker login -u andrei --password-stdin, apoi pull și docker run -d --name cache redis:7.

Alte forme ale mesajului

  • Error response from daemon: toomanyrequests: You have reached your unauthenticated pull rate limit. https://www.docker.com/increase-rate-limit
  • ERROR: failed to solve: node:20-alpine: failed to resolve source metadata for docker.io/library/node:20-alpine: failed to copy: httpReadSeeker: failed open: unexpected status code https://registry-1.docker.io/v2/library/node/manifests/sha256:...: 429 Too Many Requests - Server message: toomanyrequests: You have reached your pull rate limit.

Cum o eviți pe viitor

  • Loghează-te pe Docker Hub pe calculatorul tău și în CI (cu un token).
  • Fixează tagurile imaginilor de bază și nu folosi --pull / --no-cache la fiecare build.
  • În CI, păstrează cache-ul de imagini între joburi.
  • În firmă, configurează un mirror de registry sau copiază imaginile des folosite în registry-ul propriu.

Întrebări frecvente

Cât durează până se resetează limita?

Limita se calculează pe o fereastră de timp, deci după o perioadă poți descărca din nou. Valorile exacte se schimbă; cele actuale sunt pe pagina de prețuri Docker Hub.

Afectează și imaginile deja descărcate?

Nu. Containerele din imaginile locale pornesc normal. Problema apare doar când Docker trebuie să ia ceva de pe Docker Hub.

Erori înrudite

← Toate erorile Docker

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ță Docker de la zero, cu exerciții la fiecare lecție

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