Czego szukasz?

Wpisz temat, narzędzie lub problem do rozwiązania.

DOCKER / BUILD CACHE

Docker build cache: ile zmienia kolejność COPY?

24 buildy, dwa układy Dockerfile i trzy powtórzenia. Mierzymy czas oraz sprawdzamy w logach, czy instalacja zależności korzysta z cache.

Środowisko i zakresPomiar z 29.09.2026 na współdzielonym VPS-ie. Obraz Pythona i pakiety pobrano przed testem; kroki builda działają bez sieci. To mały eksperyment mechanizmu cache.

Dwa Dockerfile, jedna aplikacja

Pierwszy układ kopiuje cały kontekst przed pip install. Drugi kopiuje najpierw requirements.txt, instaluje zależności, a dopiero potem kopiuje app.py. Aplikacja wypisuje krótki tekst i wersję biblioteki idna.

COPY requirements.txt .
RUN python -m pip install --no-cache-dir --no-index --find-links=/wheels -r requirements.txt
COPY app.py .

Co zmienialiśmy?

Dla każdego układu wykonaliśmy build z nową warstwą instalacji, build bez zmian, zmianę wyłącznie app.py oraz zmianę idna 3.10 na 3.11 w requirements.txt. Powtórzyliśmy sekwencję trzykrotnie, naprzemiennie zmieniając kolejność układów.

Unikalny LAB_SEED w poprzedzającej warstwie RUN odcinał cache instalacji między próbami. Nie czyściliśmy globalnego cache. Wariant początkowy nie oznacza pustego cache obrazów na hoście.

Co dokładnie mierzyliśmy?

Zegar obejmował całe polecenie docker build, w tym eksport obrazu. Pobranie obrazu bazowego i dwóch wheelów odbyło się wcześniej. Każdy build używał --network=none. Kontrolne uruchomienie aplikacji po buildzie nie wchodziło do czasu.

W logach sprawdzaliśmy CACHED dla kroku pip install. Dodatkowo każdy z 24 obrazów musiał wypisać oczekiwaną wersję aplikacji i biblioteki.

Wynik po zmianie samej aplikacji

Mediana czasu dla COPY całego kontekstu wyniosła 7,15 s, a dla rozdzielonego COPY 1,16 s. Tylko drugi układ zachował cache instalacji we wszystkich trzech próbach zmiany app.py.

Bez zmian oba układy zachowały cache. Zmiana requirements.txt wymusiła ponowną instalację w obu. Ważny wniosek dotyczy granicy unieważniania warstwy: często zmieniane pliki aplikacji warto kopiować po rzadziej zmienianych zależnościach.

Czego nie uogólniamy?

Trzy powtórzenia i jedna mała biblioteka nie reprezentują każdego projektu. Host współdzieli CPU z innymi usługami; czasy mają rozrzut. Nie porównujemy rejestrów, szybkości internetu, kompilacji dużych bibliotek ani cache mountów BuildKit. Zakres min-max w tabeli pokazuje zaobserwowaną zmienność.

Powtórz u siebie

Wymagane są Linux, Python 3, Docker z BuildKit i sieć do przygotowania obrazu oraz wheelów. Paczka zawiera generator kontekstu, dwa Dockerfile, 24 logi i surowe wyniki.

Uwaga: Uruchom w osobnym katalogu. Skrypt nadpisuje wyniki, Dockerfile i logs/. Usuwa własne tagi obrazów, ale pozostawia cache BuildKit i obraz bazowy; nie wykonuje globalnego prune.

python3 run_lab.py

Wyniki pomiaru

Pobieranie obrazu i wheelów jest poza pomiarem. Mniej sekund oznacza krótszy build w tym środowisku.

Czas całego docker build: mediana z trzech prób (min-max)
WariantCOPY całego kontekstuRozdzielone COPY
Nowa warstwa instalacji7,79 s (7,54-8,54)8,13 s (7,90-9,06)
Bez zmian0,86 s (0,65-0,92)0,84 s (0,69-0,95)
Zmiana app.py7,15 s (6,57-8,34)1,16 s (0,91-1,37)
Zmiana requirements.txt7,22 s (6,76-7,89)7,39 s (7,00-8,43)

Środowisko

Data pomiaru
29.09.2026
Docker
29.5.1
Kernel / architektura
6.8.0-124-generic / x86_64
Baza i zależność
Python 3.13-slim, idna 3.10 i 3.11; digest i SHA-256 w results.json
Build
Domyślny BuildKit, współdzielony host, --network=none
PLIKI / WERSJA 1

Pobierz i sprawdź u siebie

ZIP zawiera instrukcję README.md, skrypt, konfigurację, próbki i surowe wyniki.

Pobierz ZIP (32,4 KiB) ↓
Zawartość i suma SHA-256
  • README.md
  • broad_copy.Dockerfile
  • logs/1-broad_copy-app_change.txt
  • logs/1-broad_copy-dependency_change.txt
  • logs/1-broad_copy-initial.txt
  • logs/1-broad_copy-unchanged.txt
  • logs/1-ordered_copy-app_change.txt
  • logs/1-ordered_copy-dependency_change.txt
  • logs/1-ordered_copy-initial.txt
  • logs/1-ordered_copy-unchanged.txt
  • logs/2-broad_copy-app_change.txt
  • logs/2-broad_copy-dependency_change.txt
  • logs/2-broad_copy-initial.txt
  • logs/2-broad_copy-unchanged.txt
  • logs/2-ordered_copy-app_change.txt
  • logs/2-ordered_copy-dependency_change.txt
  • logs/2-ordered_copy-initial.txt
  • logs/2-ordered_copy-unchanged.txt
  • logs/3-broad_copy-app_change.txt
  • logs/3-broad_copy-dependency_change.txt
  • logs/3-broad_copy-initial.txt
  • logs/3-broad_copy-unchanged.txt
  • logs/3-ordered_copy-app_change.txt
  • logs/3-ordered_copy-dependency_change.txt
  • logs/3-ordered_copy-initial.txt
  • logs/3-ordered_copy-unchanged.txt
  • ordered_copy.Dockerfile
  • results.json
  • run_lab.py

f02b989f5b35f4dafd7c33aa128abd2fa3dc34e93140bd1ee0d48d8addef839d

Źródła i dokumentacja

Data publikacji: 29.09.2026.