Τι είναι το build context και γιατί να χρησιμοποιήσετε ένα αρχείο .dockerignore;

Question

Accepted Answer

Όταν εκτελείτε `docker build`, το Docker στέλνει το **build context** (τα αρχεία στον κατάλογο build) στο daemon. Ένα αρχείο **.dockerignore** αποκλείει τα περιττά αρχεία από αυτό το context — επιταχύνοντας τις builds, μειώνοντας το μέγεθος της εικόνας και αποφεύγοντας την διαρροή ευαίσθητων αρχείων.

## Το build context

```bash
docker build -t myapp .     # the "." is the build context — the directory sent to the daemon
# → Docker tarballs the ENTIRE context directory and sends it to the daemon BEFORE building
# → a big context (node_modules, .git, large files) = slow builds, more data transferred
```

Το **build context** είναι το σύνολο των αρχείων που το Docker στέλνει στο daemon για να δημιουργήσει την εικόνα. Όλα τα αρχεία στον κατάλογο build περιλαμβάνονται εκτός αν αποκλεισθούν — έτσι ένα φουσκωμένο context επιβραδύνει κάθε build.

## .dockerignore — αποκλείστε περιττά αρχεία

```text
# .dockerignore (like .gitignore, for the build context)
node_modules        # don't send local deps (they're installed in the image anyway)
.git                # don't send version history
*.log
.env                # ⚠️ don't send SECRETS into the build context/image
Dockerfile
dist
.vscode
```

Το `.dockerignore` λειτουργεί όπως το `.gitignore`, αποκλείοντας αρχεία από το build context.

## Γιατί έχει σημασία (τρία οφέλη)

```text
✓ FASTER builds — a smaller context transfers faster; fewer files to process
  (also helps caching: COPY . . won't be invalidated by irrelevant file changes)
✓ SMALLER images — excluded files (node_modules, .git) don't get COPYed into the image
✓ SECURITY — keep SECRETS (.env, keys, credentials) out of the context AND the image
  (a COPY . . could otherwise copy a .env file into the image — a real leak risk)
```

## Γιατί έχει σημασία

Η κατανόηση του build context και του `.dockerignore` είναι πολύτιμη για **αποδοτικές και ασφαλείς Docker builds**, επομένως είναι πρακτικά χρήσιμη γνώση.

Πολλοί developers δεν συνειδητοποιούν ότι το `docker build .` στέλνει **ολόκληρο τον κατάλογο build-context στο daemon** πριν κτίσει — έτσι ένα φουσκωμένο context (που περιέχει `node_modules`, `.git`, build artifacts, μεγάλα αρχεία) κάνει **κάθε build πιο αργό** (περισσότερα δεδομένα για μεταφορά και επεξεργασία) και ρισκάρει να αντιγράψει ανεπιθύμητα αρχεία στην εικόνα.

Το αρχείο **`.dockerignore`** (που λειτουργεί όπως το `.gitignore`) αντιμετωπίζει αυτό με τρία συγκεκριμένα οφέλη: **ταχύτερες builds** (ένα μικρότερο context μεταφέρεται και επεξεργάζεται ταχύτερα, και επίσης βελτιώνει την caching των layers αφού το `COPY . .` δεν θα ακυρωθεί από αλλαγές σε άσχετα αρχεία), **μικρότερες εικόνες** (τα αποκλεισμένα αρχεία δεν αντιγράφονται — π.χ. χωρίς bundling τοπικού `node_modules` που ξαναεγκαθίστανται ούτως ή άλλως), και κρίσιμα **ασφάλεια** (κρατώντας **secrets όπως αρχεία `.env`, κλειδιά και διαπιστευτήρια έξω από το build context και την εικόνα** — αφού ένα `COPY . .` θα αντέγραφε διαφορετικά ένα `.env` στην εικόνα, ένας πραγματικός και συνηθισμένος κίνδυνος διαρροής διαπιστευτηρίων).

Το όφελος ασφάλειας είναι ιδιαίτερα σημαντικό, καθώς το να ενσωματώσετε κατά λάθος secrets ή ευαίσθητα αρχεία σε εικόνες μέσω μιας υπερβολικά ευρείας αντιγραφής είναι ένα πραγματικό λάθος που το `.dockerignore` βοηθά να αποτρέψει.

Επειδή τα builds συμβαίνουν συνεχώς και η απόδοση των builds, το μέγεθος της εικόνας και η αποφυγή διαρροής secrets έχουν όλα σημασία, και επειδή η κατανόηση του build context και η χρήση του `.dockerignore` βελτιώνουν άμεσα και τα τρία, η κατανόηση του build context και του `.dockerignore` είναι πολύτιμη, πρακτικά σχετική γνώση Docker — μια απλή αλλά σημαντική πρακτική για γρήγορες, λιτές και ασφαλείς builds που είναι εύκολο να παραβλεφθεί αλλά έχει σημαντικό αντίκτυπο, ειδικά για την αποφυγή της τυχαίας συμπερίληψης secrets σε εικόνες.