Dockerfile best practices: kesh, xavfsizlik va signallar
Qisqacha: Docker har qatlamni keshda saqlaydi. Bitta qatlam o'zgarsa, undan keyingilari ham qayta yasaladi. Shuning uchun avval kamdan-kam o'zgaradigan narsa (
package-lock.json,npm ci), keyin tez-tez o'zgaradigan kod keladi. To'g'ri tartib bilan bitta qator o'zgarganda kanon image 20 soniyada qayta yig'ildi,npm ciesa keshdan olindi. Ilova root'siz (USER node) ishlaydi,CMDexec ko'rinishida yoziladi, sog'liqHEALTHCHECKbilan tekshiriladi, base image digest bilan qotiriladi.docker stopgrace vaqtini esa doim aniq bering: sukutga ishonib, kurs tajribasida ilova to'xtash ishini tugata olmadi.
Bu darsda
- Qatlam keshi qanday ishlashini model bilan ko'rasiz va Dockerfile'ni kesh uchun tartiblaysiz.
NODE_ENV=productionqayerda turishi kerakligini bilasiz.- Ilovani root'siz ishga tushirasiz.
CMDning shell va exec ko'rinishi, PID 1 va--initfarqini tushuntirasiz.docker stopo'lchovini halol o'qiysiz: nima isbotlandi va nima isbotlanmadi.HEALTHCHECKyozasiz, base image'ni digest bilan qotirasiz va hadolint'ni yurgizasiz.
Oldin bilishingiz kerak: Dockerfile yozish, Jarayon signallari serverda, Graceful shutdown to'liq, Health check endpoint'lari.
1. Nega bu kerak?
Oldingi darsdagi birinchi Dockerfile ishladi. Lekin uch kamchiligi qoldi:
COPY . .dan keyinnpm cikeladi — bittasrc/fayli o'zgarsa ham, hamma bog'liqliklar qayta o'rnatiladi.- Ilova root nomidan ishlaydi.
CMD npm start— shell ko'rinishi. Konteyner to'xtatilganda signal ilovaga yetib boradimi — noma'lum.
Bu darsda uchalasini tuzatamiz va har tuzatishni kanon tajribasi bilan tekshiramiz. Bittasida o'lchov kutganimizdek chiqmadi — buni ham ochiq ko'rsatamiz.
2. Qatlam keshi
2.1 Kesh qanday qaror qiladi
Docker har ko'rsatmani bajarishdan oldin so'raydi: "Shu qatlamni avval yasaganmanmi?" Javob uchta narsaga bog'liq (hujjat bo'yicha):
- oldingi qatlam o'zgarmaganmi;
- ko'rsatma matni o'zgarmaganmi;
COPYuchun — nusxalanadigan fayllar mazmuni o'zgarmaganmi.
Uchalasi ham "ha" bo'lsa — qatlam keshdan olinadi (CACHED). Bitta "yo'q" bo'lsa — qatlam qayta yasaladi, undan keyingi hamma qatlamlar ham: ular endi boshqa asos ustida turibdi. Buni kichik model bilan ko'ramiz:
function qatlamlar(qadamlar, ozgargan) {
let kesh = true;
return qadamlar.map(({ buyruq, fayllar = [] }) => {
const tegdi = fayllar.some((f) => ozgargan.some(
(o) => f === "." || o === f || o.startsWith(f + "/"),
));
if (tegdi) kesh = false;
return `${kesh ? "CACHED" : "qayta "} ${buyruq}`;
});
}
const oddiy = [
{ buyruq: "WORKDIR /app" },
{ buyruq: "COPY . .", fayllar: ["."] },
{ buyruq: "RUN npm ci" },
{ buyruq: "RUN npm run build" },
];
const tartibli = [
{ buyruq: "WORKDIR /app" },
{ buyruq: "COPY package.json package-lock.json ./",
fayllar: ["package.json", "package-lock.json"] },
{ buyruq: "COPY prisma ./prisma", fayllar: ["prisma"] },
{ buyruq: "RUN npm ci" },
{ buyruq: "COPY src ./src", fayllar: ["src"] },
{ buyruq: "RUN npm run build" },
];
for (const [nom, q] of [["oddiy", oddiy], ["tartibli", tartibli]]) {
console.log(`${nom} (src/main.ts o'zgardi):`);
for (const s of qatlamlar(q, ["src/main.ts"])) console.log(" ", s);
}
console.log("tartibli (package-lock.json o'zgardi):");
for (const s of qatlamlar(tartibli, ["package-lock.json"])) {
console.log(" ", s);
}Konsolda:
oddiy (src/main.ts o'zgardi):
CACHED WORKDIR /app
qayta COPY . .
qayta RUN npm ci
qayta RUN npm run build
tartibli (src/main.ts o'zgardi):
CACHED WORKDIR /app
CACHED COPY package.json package-lock.json ./
CACHED COPY prisma ./prisma
CACHED RUN npm ci
qayta COPY src ./src
qayta RUN npm run build
tartibli (package-lock.json o'zgardi):
CACHED WORKDIR /app
qayta COPY package.json package-lock.json ./
qayta COPY prisma ./prisma
qayta RUN npm ci
qayta COPY src ./src
qayta RUN npm run buildCOPY . . har qanday faylga "tegadi" — shuning uchun oddiy variantda npm ci doim qayta. Tartibli variantda kod o'zgarishi faqat oxirgi ikki qadamga ta'sir qiladi. Lock fayl o'zgarsa esa — hammasi qayta, bu to'g'ri: bog'liqliklar haqiqatan o'zgargan.
Nega prisma papkasi npm ci dan oldin? Loyihada postinstall skripti bor — prisma generate. U sxemani o'qiydi. Sxema npm ci paytida image'da bo'lmasa, o'rnatish yiqiladi. Kesh tartibi loyihaning o'z qoidalariga mos bo'lishi kerak.
2.2 Kanon tajribasi
Kurs tajribasida kanon Dockerfile (tartibli variant) bilan sinadik: src/main.ts oxiriga bitta izoh qatori qo'shib, image'ni qayta yig'dik.
kanon (kesh): exit 0, 20241 ms; CACHED qadamlar: 8; npm ci qayta: 020 soniya, 8 qadam keshdan, npm ci qayta bajarilmadi. Sovuq build'da faqat npm ci qadamining o'zi serverda 27 soniya olgan (oldingi dars).
Xuddi shu sinovni birinchi Dockerfile bilan ham yurgizdik — lekin u yugurishda Docker Desktop uzilib qoldi va o'lchov chiqmadi (exit 1). Shuning uchun oddiy variantning keshdagi vaqtini o'lchanmagan deb hisoblang. Model esa natija qanday bo'lishini ko'rsatib turibdi.
2.3 Lockfile — kesh kaliti
npm ci qatlamining keshi package-lock.json ga bog'langan. Shuning uchun lock fayl repoda bo'lishi shart va Dockerfile'ga package.json bilan birga nusxalanadi. Lock fayl bo'lmasa, npm ci umuman ishlamaydi. npm install esa har build'da boshqa versiyalarni olishi mumkin edi.
Kanon npm ci ga yana bir narsa qo'shadi: RUN --mount=type=cache,target=/root/.npm npm ci. Bu npm yuklab olgan paketlarni build'lar orasida saqlaydi, lekin image'ga yozmaydi. Batafsil — Multi-stage build darsida.
3. NODE_ENV=production — qayerda?
Birinchi Dockerfile'da ENV NODE_ENV=production build'dan keyin turibdi. Bu tasodif emas. NODE_ENV=production bo'lsa, npm ci sukut bo'yicha dev bog'liqliklarni o'rnatmaydi. npm hujjatiga ko'ra bunda omit sozlamasi sukut bo'yicha dev bo'ladi (tekshirildi, 2026-11). U holda TypeScript va Nest CLI o'rnatilmaydi va npm run build yiqiladi — buni biz build qilib ko'rmadik.
Qoida: NODE_ENV=production — build tugagandan keyin, ishlaydigan qismda. Keyingi darsda uni oxirgi bosqichga ko'chiramiz.
4. Root'siz: USER node
4.1 Nega root yomon
Konteyner izolyatsiya qilingan, lekin to'liq emas: kernel host bilan umumiy (Konteyner nima). Ilovada masofadan kod bajarish teshigi topilsa, hujumchi ilova huquqlarini oladi. Ilova root bo'lsa, u konteyner ichida hamma narsani qila oladi:
- kodni almashtiradi — keyingi so'rovlardan boshlab ilova hujumchi kodini bajaradi;
- paket o'rnatadi, tarmoqni tekshiradi;
- volume orqali host fayllariga yozadi;
- kernel yoki Docker'dagi teshik bo'lsa — konteynerdan chiqishga urinadi.
Root'siz ilova bularning ko'pini qila olmaydi. Bu — foydalanuvchilar va sudo darsidagi "eng kam huquq" qoidasining konteynerdagi ko'rinishi. Serverda ilova uchun alohida vazifalar foydalanuvchisi yaratgan edik. Konteynerda ham shunday qilamiz.
4.2 USER node
Rasmiy Node image'ida tayyor foydalanuvchi bor — node (UID 1000). Dockerfile oxirida:
USER node
CMD ["node", "dist/main.js"]USER dan keyingi hamma narsa — RUN, CMD — shu foydalanuvchi nomidan bajariladi. COPY qilingan fayllar esa sukut bo'yicha root'ga tegishli bo'ladi: hujjatga ko'ra --chown bo'lmasa, UID va GID — 0 (tekshirildi, 2026-11). Natija: node kodni o'qiydi, lekin o'zgartira olmaydi. Kanon ilovasi diskka umuman yozmaydi: fayllar S3'da, loglar stdout'da.
Kurs tajribasidagi image'lar ichida (id -un):
| Image | Foydalanuvchi |
|---|---|
| birinchi Dockerfile | root |
tartibli, USER node bilan |
node |
| kanon | node |
Diqqat:
USER nodeni Dockerfile boshiga qo'ysangiz,npm cihamnodenomidan ishlaydi. Unda/appga yozish huquqi bo'lmasligi mumkin. Odatiy tartib: o'rnatish va build — root, oxiridaUSER node, keyinCMD.
5. Signallar va PID 1
5.1 docker stop nima qiladi
docker stop konteynerdagi PID 1 ga — asosiy jarayonga — SIGTERM yuboradi. Keyin grace vaqti ("imtiyozli vaqt" — ilovaga toza to'xtash uchun berilgan muhlat) kutadi. Hujjatga ko'ra Linux konteynerlari uchun sukut — 10 soniya (tekshirildi, 2026-11). Jarayon shu vaqtda chiqmasa — SIGKILL. SIGKILL bilan o'lgan jarayonning chiqish kodi — 137 (128 + 9; Jarayon signallari).
vazifalar-api SIGTERM ni ushlaydi (Graceful shutdown). U yangi ulanishlarni qabul qilmaydi, YOPISH_KECHIKISH_MS (5 s) kutadi, ochiq so'rovlarni tugatadi, baza ulanishlarini yopadi va logga "to'xtadi" yozadi.
sequenceDiagram
participant D as docker stop
participant A as ilova (PID 1)
D->>A: SIGTERM
A->>A: yangi ulanish yo'q, 5 s kutish
A->>A: so'rovlar tugaydi, baza yopiladi
alt grace ichida
A-->>D: chiqdi, kod 0
else grace tugadi
D->>A: SIGKILL
A-->>D: kod 137
end5.2 Shell va exec ko'rinishi
CMD ning ikki yozilishi PID 1 ni o'zgartiradi. Kurs tajribasida har konteynerdagi PID 1 ni /proc/1/cmdline dan o'qidik:
--- 28-oddiy: PID 1 = /bin/sh -c npm start
--- kanon: PID 1 = node dist/main.js
--- 30-alpine: PID 1 = node dist/main.js CMD npm start→ PID 1 — shell (/bin/sh -c). Ilova esa zanjirning oxirida: shell → npm → node.CMD ["node", "dist/main.js"]→ PID 1 — ilovaning o'zi.
Docker hujjati buni ENTRYPOINT ning shell ko'rinishi haqida yozadi: /bin/sh -c signallarni uzatmaydi, shuning uchun ilova docker stop yuborgan SIGTERM ni olmaydi (tekshirildi, 2026-11). CMD npm start ham xuddi shu /bin/sh -c ga o'raladi. Demak hujjat bo'yicha shell ko'rinishida ilova grace oxirida SIGKILL bilan o'ladi. Quyida ko'rasiz: bizning o'lchov buni na tasdiqladi, na rad etdi.
PID 1 ning yana bir xususiyati bor. Linux kerneli PID 1 ga ishlovchisi yo'q signallarning sukut harakatini qo'llamaydi. Ya'ni SIGTERM ni ushlamaydigan dastur PID 1 bo'lsa, SIGTERM uni o'ldirmaydi (hujjat bo'yicha). Bizning ilova SIGTERM ni o'zi ushlaydi, shuning uchun bu unga xalaqit bermaydi.
5.3 --init (tini)
docker run --init PID 1 ga kichik init jarayonini qo'yadi — Docker'ga o'rnatilgan tini. U ikki ish qiladi: signallarni ilovaga uzatadi va o'lgan bola jarayonlarni yig'adi (zombie). Kurs tajribasida:
--- kanon + --init (tini): PID 1 = docker-init
PID 1 = /sbin/docker-init -- docker-entrypoint.sh node dist/main.js docker-entrypoint.sh — rasmiy Node image'ining ENTRYPOINT i (oldingi dars), CMD unga argument bo'lib qo'shilgan.
Kanon --init ishlatmaydi: ilova o'zi PID 1, signalni o'zi ushlaydi va bola jarayon ochmaydi. Bola jarayonlar ochadigan ilova (masalan, child_process bilan ishchilar) uchun --init yoki Dockerfile'da tini — xavfsizroq tanlov.
5.4 O'lchov: nima chiqdi
Har image'dan konteyner ishga tushirib, sog'ligini kutdik, keyin docker stop (sukut bilan) vaqtini o'lchadik:
| Variant | PID 1 | docker stop |
ExitCode |
|---|---|---|---|
| birinchi Dockerfile | /bin/sh -c |
3 641 ms | 137 |
| kanon | node |
3 681 ms | 137 |
| alpine | node |
3 621 ms | 137 |
--init |
docker-init |
3 558 ms | 137 |
Hammasi bir xil: ~3.6 soniyada SIGKILL, logda "to'xtadi" yo'q. To'g'ri yozilgan kanon ham!
5.5 Natijani halol o'qish
Sabab alohida o'lchovda chiqdi — sog'lom kanon konteyneri:
docker stop (sukut) : 3 598 ms, ExitCode 137 — logda faqat "SIGTERM: yangi ulanishlar qabul qilinmaydi…", "to'xtadi" YO'Q
docker stop -t 30 : 5 602 ms, ExitCode 0 — "SIGTERM" → "ombor ulanishlari yopildi" → "to'xtadi"Birinchi qator muhim: ilova SIGTERM ni oldi va ishni boshladi. Lekin bu Docker Desktop (Engine 29.8.2) SIGKILL ni hujjatdagi 10 soniya emas, ~3.5 soniyada yubordi. Sababini aniqlay olmadik. Ilovaga esa 5 soniya kutish kerak edi. Grace 30 soniya berilganda — 5.6 soniyada toza chiqish, kod 0.
Bundan xulosa:
- Jadvaldagi to'rt variant bir xil sababdan 137 bilan tugadi — grace drain'dan qisqa edi. Shell va exec farqi bu o'lchovda ajratilmadi. Shell ko'rinishida signal yetmasligini isbotlamadik ham, rad etmadik ham.
- Haqiqiy Linux serverda Compose grace 30 s bilan: 5 526 ms, kod 0.
docker stop -t 3bilan (drain'dan qisqa) — 3 221 ms, kod 137. Xulosa bir xil. - Amaliy qoida: grace'ni doim aniq bering —
docker stop -t 30, Compose'dastop_grace_period(Compose production'da). Sukut muhitdan muhitga farq qiladi, ilovaning to'xtash vaqti esa sizga ma'lum.
Jadvalda yo'q yana bir variant — distroless image (keyingi dars). U ham 3 509 ms / 137 berdi. Lekin uning PID 1 ini o'qiy olmadik: image'da cat yo'q (exec: "cat": executable file not found). Sog'liq tekshiruvi ham node ni PATH'dan topa olmadi. Bunday image'ni tashqaridan tekshirish qiyinroq — bu uning narxi.
Tekshirib ko'ring: Ilova
SIGTERMdan keyin 5 s kutadi, eng uzun so'rov 10 s davom etadi.docker stop -tga qancha berasiz?
Javob
Kamida 15 s (5 + 10), ehtiyot vaqt bilan — 30 s. Kanon Compose'da stop_grace_period: 30s shu hisobdan chiqqan: eng yomon holat 15 s, ustiga yana shuncha ehtiyot vaqt (ikki baravar).
6. HEALTHCHECK
Konteyner "ishlayapti" degani ilova javob beryapti degani emas: jarayon tirik, lekin baza ulanishi uzilgan bo'lishi mumkin. HEALTHCHECK Docker'ga ilovani muntazam so'rab turishni buyuradi. Kanon Dockerfile'da:
HEALTHCHECK --interval=10s --timeout=3s --start-period=30s \
--retries=3 \
CMD ["node", "-e", "fetch('http://127.0.0.1:3000/health/live').then(r=>process.exit(r.ok?0:1),()=>process.exit(1))"](Telefon uchun qatorga bo'lindi, mazmuni aynan.)
--interval=10s— har 10 soniyada tekshiradi.--timeout=3s— 3 soniyada javob bo'lmasa, tekshiruv yiqilgan.--start-period=30s— ishga tushishdagi yiqilishlar hisobga olinmaydi.--retries=3— ketma-ket 3 yiqilish → holatunhealthy.
Hujjatdagi sukutlar: interval 30 s, timeout 30 s, start-period 0, retries 3 (tekshirildi, 2026-11). Kanon birinchi uchtasini o'zgartirgan: muammo tezroq ko'rinsin, ishga tushish esa yiqilish deb hisoblanmasin.
Nega curl emas, node -e? Slim image'da curl yo'q, uni o'rnatish esa image'ni kattalashtiradi. Node esa allaqachon bor va unda fetch bor. /health/live endpoint'ini 31-qismda yozgan edik.
Holat docker ps da ko'rinadi: Up 7 seconds (healthy). Hujjat unhealthy bo'lganda faqat holat o'zgarishini va hodisa (health_status) yozilishini aytadi. Docker Engine'ning o'zi bunday konteynerni qayta ishga tushirmaydi: restart siyosati jarayon chiqqanda ishlaydi (sinalmagan, 2026-11). Bu holatdan Compose foydalanadi: "API sog'lom bo'lmaguncha web'ni ishga tushirma" (Docker Compose).
7. Base image'ni qotirish: teg va digest
FROM node:24.22.2 — aniq teg, lekin teg ham ko'chishi mumkin: image egasi xavfsizlik tuzatishi bilan xuddi shu tegni qayta yuklaydi. Digest — image mazmunining xeshi, u hech qachon o'zgarmaydi. Kanon ikkalasini birga yozadi: node:24.22.2-trixie-slim@sha256:90943ae8… (to'liq qator — «Loyiha qadami» bo'limidagi faylda).
- Teg (
24.22.2-trixie-slim) — odam uchun: qaysi versiya ekani ko'rinadi. - Digest (
@sha256:…) — Docker uchun: aynan shu image olinadi, teg ko'chsa ham.
Bu digest — ko'p arxitekturali indeks. Bitta digest ichida x86 va arm64 variantlari bor. Haqiqiy ARM64 serverdagi build logida aynan shu digest bilan arm64 image tortilgani ko'rinadi. Digest yangilanmaydi, demak xavfsizlik tuzatishlari ham o'zi kelmaydi. Uni ataylab, vaqti-vaqti bilan yangilash kerak — Dependabot yoki Renovate bilan (Semver va bog'liqliklarni yangilab borish). latest teg qanday jim ko'chishini Registry va teglash darsida o'lchaymiz.
8. hadolint: Dockerfile linteri
hadolint — Dockerfile'ni qoidalar bo'yicha tekshiruvchi vosita. O'rnatmasdan, Docker orqali ishlatsa bo'ladi:
docker run --rm -i hadolint/hadolint:v2.15.1 \
hadolint --no-color - < DockerfileGit Bash'da MSYS_NO_PATHCONV=1 ni oldiga qo'shing — aks holda Git Bash yo'llarni Windows ko'rinishiga o'giradi. Kurs tajribasida hadolint 2.15.1 ikkala Dockerfile'ni tekshirdi:
--- Dockerfile.28-oddiy
-:7 DL3059 info: Multiple consecutive `RUN` instructions. Consider consolidation.
-:10 DL3025 warning: Use arguments JSON notation for CMD and ENTRYPOINT arguments
[exit 1]
--- Dockerfile
-:35 DL3066 info: Non-numeric user-id may not be resolvable by host system
[exit 1](Qator raqamlari kanon fayllaridagi izoh qatorlari bilan sanalgan.)
- DL3025 — "CMD va ENTRYPOINT uchun JSON ko'rinishidan foydalaning". Shell ko'rinishidagi
CMD npm starthaqida — yuqoridagi signallar bo'limi. - DL3059 — "ketma-ket bir nechta RUN, birlashtirishni o'ylab ko'ring". Faqat maslahat (info). Bizda ikkita
RUNning ma'nosi har xil, birlashtirish shart emas. - DL3066 — "raqamsiz foydalanuvchi ID'si host tizimida aniqlanmasligi mumkin".
USER nodeo'rnigaUSER 1000tavsiya qilinadi: masalan, KubernetesrunAsNonRoottekshiruvi nomni emas, raqamni tushunadi (sinalmagan, 2026-11). Kanonnodeni qoldirdi — o'qishga qulayroq.
E'tibor bering: kanon Dockerfile'da faqat info darajasidagi topilma bor, lekin hadolint baribir exit 1 qaytardi. CI'da bu build'ni to'xtatadi. Chegarani --failure-threshold warning bilan ko'tarish mumkin: hadolint shunda faqat warning va undan jiddiy topilmada xato kodi qaytaradi (bayroq hujjatda bor, tekshirildi 2026-11; biz yurgizmadik).
9. Loyiha qadami
Dockerfile'ni ikkinchi variantga almashtiring — kurs tajribasidagi "slim, best practices, bitta bosqich" fayli (izoh qatori olib tashlangan, digest qatori to'liq):
FROM node:24.22.2-trixie-slim@sha256:90943ae8e65444498fd83f0f23d2a19ef5807e00396cee96bb96b87f9d9ca976
WORKDIR /app
COPY package.json package-lock.json prisma.config.ts ./
COPY prisma ./prisma
RUN --mount=type=cache,target=/root/.npm npm ci --no-audit --no-fund
COPY tsconfig.json tsconfig.build.json nest-cli.json ./
COPY src ./src
RUN npm run build
ENV NODE_ENV=production HOST=0.0.0.0 PORT=3000
USER node
CMD ["node", "dist/main.js"]Unga kanon Dockerfile'dagi ikki qismni qo'shing: CMD dan oldin EXPOSE 3000 va yuqoridagi HEALTHCHECK. Tekshiring:
MSYS_NO_PATHCONV=1 docker run --rm -i hadolint/hadolint:v2.15.1 \
hadolint --no-color - < Dockerfile
docker build -t vazifalar-api:bir-bosqich .
docker run --rm --entrypoint sh vazifalar-api:bir-bosqich -c 'id -un'node chiqishi kerak. Keyin src/main.ts ga bitta izoh qo'shib, qayta build qiling va logda npm ci qadami yonida CACHED borligini tekshiring.
Image hamon katta: kurs tajribasida bu variant 1 233 MB chiqdi. Ichida dev bog'liqliklar va src/ bor. Hali commit qilmang — commit Deploy II darsida. Keyingi darsda Dockerfile yakuniy, ko'p bosqichli ko'rinishga keladi.
10. Ko'p uchraydigan xatolar
10.1 COPY . . dan keyin npm ci
Har kod o'zgarishi — to'liq qayta o'rnatish. Avval package*.json (va postinstall uchun kerakli fayllar), npm ci, keyin kod.
10.2 NODE_ENV=production build'dan oldin
Dev bog'liqliklar o'rnatilmaydi, npm run build yiqiladi.
10.3 CMD npm start
PID 1 — shell. Hujjatga ko'ra signal ilovaga yetmaydi. Exec ko'rinishi: CMD ["node", "dist/main.js"].
10.4 Sukut grace'ga ishonish
Kurs tajribasida sukut grace ~3.5 s chiqdi, ilovaga esa 5 s kerak edi. ExitCode 137 va logda "to'xtadi" yo'qligi — shu belgisi.
10.5 USER umuman yo'q
Ilova root. hadolint buni bitta qoida bilan ushlamaydi — tekshiruv ro'yxatingizda bo'lsin.
11. Mashqlar
Mashqlar kurs/mashqlar/33/29-best-practices/ da. 2- va 3-mashq yechimlari tekshirilgan (biz ishga tushirdik: Node 24.21.0 va Git Bash).
1-mashq (oson): bo'shliqlarni to'ldiring
SIGKILLbilan o'lgan konteynerning chiqish kodi —docker stopsukut grace vaqti, hujjatga ko'ra (soniya) —- Rasmiy Node image'idagi tayyor root'siz foydalanuvchi —
- PID 1 ga signal uzatuvchi init qo'yadigan
docker runbayrog'i —-- - Image mazmunining o'zgarmas xeshi —
Yechim
- 137 — 128 + 9.
- 10 — lekin kurs tajribasida Docker Desktop'da ~3.5 s chiqdi.
- node — UID 1000.
- init —
tini. - digest —
@sha256:….
2-mashq (o'rta): kesh kalitlari zanjiri
Darsdagi modelni haqiqiyroq qiling. keshKalitlari(qadamlar, fayllar) har qadam uchun kalit hisoblasin: sha256(oldingi kalit + buyruq + nusxalanadigan fayllar mazmuni), birinchi 8 belgi. fayllar — { yol: mazmun } obyekti. Qadamdagi nusxa — fayl yoki papka yo'llari ro'yxati (papka — shu prefiks bilan boshlanadigan hamma fayl, yo'llar tartiblangan). Ikki build kalitlarini solishtirib, CACHED yoki qayta chiqaring.
Yechim
import { createHash } from "node:crypto";
function keshKalitlari(qadamlar, fayllar) {
let oldingi = "";
return qadamlar.map(({ buyruq, nusxa = [] }) => {
const yollar = Object.keys(fayllar).sort().filter((y) =>
nusxa.some((n) => y === n || y.startsWith(n + "/")));
const mazmun = yollar.map((y) => `${y}:${fayllar[y]}`).join("|");
oldingi = createHash("sha256")
.update(oldingi + buyruq + mazmun)
.digest("hex")
.slice(0, 8);
return oldingi;
});
}
const qadamlar = [
{ buyruq: "COPY package*.json ./",
nusxa: ["package.json", "package-lock.json"] },
{ buyruq: "RUN npm ci" },
{ buyruq: "COPY src ./src", nusxa: ["src"] },
{ buyruq: "RUN npm run build" },
];
const eski = {
"package.json": "v4.1.0",
"package-lock.json": "lock-1",
"src/main.ts": "ishga tushir()",
"src/ilova.ts": "ilova()",
};
const yangi = { ...eski, "src/main.ts": "ishga tushir() // yangi" };
const a = keshKalitlari(qadamlar, eski);
const b = keshKalitlari(qadamlar, yangi);
qadamlar.forEach((q, i) => {
const holat = a[i] === b[i] ? "CACHED" : "qayta ";
console.log(holat, b[i], q.buyruq);
});Konsolda:
CACHED 86c819a9 COPY package*.json ./
CACHED e8b3eff5 RUN npm ci
qayta 76022247 COPY src ./src
qayta 3fb86052 RUN npm run buildRUN npm run build ning o'zi o'zgarmadi, lekin kalitiga oldingi kalit kiradi — zanjir uzildi. Docker'ning haqiqiy kaliti boshqacha hisoblanadi (fayl metama'lumoti, platforma), lekin "oldingi o'zgarsa, keyingisi ham" tamoyili aynan shu.
3-mashq (qiyin): kichik linter awk bilan
Git Bash'da skript yozing: namunaviy Dockerfile yaratadi va awk bilan quyidagilarni topadi:
FROMda teg yo'q yoki:latest—"teg qotirilmagan";CMD/ENTRYPOINTJSON ko'rinishida emas ([bilan boshlanmaydi) —"JSON ko'rinishi emas";RUN npm cidan oldinCOPY . .bo'lgan —"COPY . . npm ci dan oldin";- faylda
USERumuman yo'q — oxirida"USER yo'q: root".
Har topilma: qator: xabar.
Yechim
cat > Dockerfile <<'EOF'
FROM node
WORKDIR /app
COPY . .
RUN npm ci
RUN npm run build
FROM node:latest
CMD npm start
ENTRYPOINT ["docker-entrypoint.sh"]
EOF
awk '
toupper($1) == "FROM" {
obraz = $2; sub(/@.*/, "", obraz)
if (obraz !~ /:/ || obraz ~ /:latest$/)
print NR ": teg qotirilmagan"
}
toupper($1) == "CMD" || toupper($1) == "ENTRYPOINT" {
if ($2 !~ /^\[/) print NR ": JSON ko'"'"'rinishi emas"
}
toupper($1) == "COPY" && $2 == "." { hammasi = 1 }
toupper($1) == "RUN" && $2 == "npm" && $3 == "ci" && hammasi {
print NR ": COPY . . npm ci dan oldin"
}
toupper($1) == "USER" { user = 1 }
END { if (!user) print "oxiri: USER yo'"'"'q: root" }
' DockerfileNatija:
1: teg qotirilmagan
4: COPY . . npm ci dan oldin
6: teg qotirilmagan
7: JSON ko'rinishi emas
oxiri: USER yo'q: root'"'"' — bitta tirnoq ichidagi awk dasturiga apostrof qo'yish usuli: tirnoqni yopadi, qo'shtirnoq ichida ' beradi va yana ochadi. sub(/@.*/, "", obraz) — digest'ni olib tashlaydi, shunda node:24@sha256:… dagi teg to'g'ri tekshiriladi. Haqiqiy hadolint Dockerfile'ni to'liq tahlil qiladi va o'nlab qoidaga ega — bu faqat g'oya.
12. Real ishda
- CI'da hadolint — Dockerfile o'zgargan har PR'da (GitHub Actions chuqur).
- Kubernetes pod to'xtatilganda ham xuddi shu:
SIGTERM,terminationGracePeriodSeconds(sukut 30 s, Kubernetes hujjati, tekshirildi 2026-11), keyinSIGKILL. Grace'ni ilovaning haqiqiy to'xtash vaqtiga qarab tanlash — umumiy qoida. - Root'siz konteyner — ko'p platformalarda talab. Masalan, OpenShift konteynerni tasodifiy UID bilan ishga tushiradi (sinalmagan, 2026-11).
- Intervyu savollari: "Dockerfile'da qatorlar tartibi nega muhim?", "
CMDshell va exec ko'rinishi farqi?", "PID 1 nima uchun maxsus?", "Exit code 137 nima?", "Teg va digest farqi?"
Xulosa
- Kesh: birinchi o'zgargan qatlamdan keyingi hammasi qayta. Avval lock fayl va
npm ci, keyin kod — kanon kesh bilan 20 s,npm ciqayta yo'q. NODE_ENV=production— build'dan keyin.USER node— ilova root emas, kod faqat o'qiladi.CMD— exec ko'rinishida; ilova PID 1 vaSIGTERMni o'zi ushlaydi. Bola jarayonli ilovaga —--init.docker stopgrace'ni doim aniq bering: sukut bilan barcha variantlar 137 bilan o'ldi,-t 30bilan kanon toza chiqdi (5.6 s, kod 0). Shell va exec farqi bu o'lchovda ajratilmadi.HEALTHCHECK—node -e fetch; base image — teg + digest; hadolint — faqat info bo'lsa ham exit 1.
Keyingi dars: Multi-stage build va image hajmi — build vositalarini yakuniy image'dan chiqaramiz va olti variantning hajmini solishtiramiz.
Manbalar
- Dockerfile reference —
CMD,ENTRYPOINT(shell ko'rinishi signal uzatmaydi),HEALTHCHECKsukutlari,COPYegasi: https://docs.docker.com/reference/dockerfile/ (tekshirildi, 2026-11-07) docker container stop(sukutSIGTERM, Linux'da 10 s): https://docs.docker.com/reference/cli/docker/container/stop/ (tekshirildi, 2026-11-07)- Build cache ("qatlam o'zgarsa, keyingilari ham qayta"): https://docs.docker.com/build/cache/ (tekshirildi, 2026-11-07)
- hadolint qoidalari (DL3025, DL3059, DL3066;
--failure-threshold): https://github.com/hadolint/hadolint#rules (tekshirildi, 2026-11-07) - tini (signal uzatish, zombie yig'ish;
docker run --init): https://github.com/krallin/tini (tekshirildi, 2026-11-07) - Kubernetes — Pod lifecycle (grace sukuti 30 s): https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/ (tekshirildi, 2026-11-07)
- Kurs tajribasi (IlmHamroh, 2026-11): Docker Engine 29.8.2 (Docker Desktop, x86_64) va ARM64 Linux server; kesh qayta build, PID 1 va
docker stopo'lchovlari, hadolint 2.15.1; mashq yechimlari — biz ishga tushirdik (2026-11-07).
Izohlar · 0
Izoh yozish uchun kiring.