JavaScript Full-stackDockerfile best practices: kesh, xavfsizlik va signallar
JavaScript Full-stack · 33-qism. Linux, server, Docker

Dockerfile best practices: kesh, xavfsizlik va signallar

19 daqiqa29/38-dars

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 ci esa keshdan olindi. Ilova root'siz (USER node) ishlaydi, CMD exec ko'rinishida yoziladi, sog'liq HEALTHCHECK bilan tekshiriladi, base image digest bilan qotiriladi. docker stop grace 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=production qayerda turishi kerakligini bilasiz.
  • Ilovani root'siz ishga tushirasiz.
  • CMD ning shell va exec ko'rinishi, PID 1 va --init farqini tushuntirasiz.
  • docker stop o'lchovini halol o'qiysiz: nima isbotlandi va nima isbotlanmadi.
  • HEALTHCHECK yozasiz, 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:

  1. COPY . . dan keyin npm ci keladi — bitta src/ fayli o'zgarsa ham, hamma bog'liqliklar qayta o'rnatiladi.
  2. Ilova root nomidan ishlaydi.
  3. 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;
  • COPY uchun — 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:

js
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:

text
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 build

COPY . . 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.

text
kanon (kesh): exit 0, 20241 ms; CACHED qadamlar: 8; npm ci qayta: 0

20 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:

dockerfile
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 node ni Dockerfile boshiga qo'ysangiz, npm ci ham node nomidan ishlaydi. Unda /app ga yozish huquqi bo'lmasligi mumkin. Odatiy tartib: o'rnatish va build — root, oxirida USER node, keyin CMD.

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
  end

5.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:

text
--- 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:

text
--- 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:

text
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 3 bilan (drain'dan qisqa) — 3 221 ms, kod 137. Xulosa bir xil.
  • Amaliy qoida: grace'ni doim aniq bering — docker stop -t 30, Compose'da stop_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 SIGTERM dan keyin 5 s kutadi, eng uzun so'rov 10 s davom etadi. docker stop -t ga 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:

dockerfile
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 → holat unhealthy.

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:

bash
docker run --rm -i hadolint/hadolint:v2.15.1 \
  hadolint --no-color - < Dockerfile

Git 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:

text
--- 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 start haqida — yuqoridagi signallar bo'limi.
  • DL3059 — "ketma-ket bir nechta RUN, birlashtirishni o'ylab ko'ring". Faqat maslahat (info). Bizda ikkita RUN ning ma'nosi har xil, birlashtirish shart emas.
  • DL3066 — "raqamsiz foydalanuvchi ID'si host tizimida aniqlanmasligi mumkin". USER node o'rniga USER 1000 tavsiya qilinadi: masalan, Kubernetes runAsNonRoot tekshiruvi nomni emas, raqamni tushunadi (sinalmagan, 2026-11). Kanon node ni 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):

dockerfile
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:

bash
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

  • SIGKILL bilan o'lgan konteynerning chiqish kodi —
  • docker stop sukut grace vaqti, hujjatga ko'ra (soniya) —
  • Rasmiy Node image'idagi tayyor root'siz foydalanuvchi —
  • PID 1 ga signal uzatuvchi init qo'yadigan docker run bayrog'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
js
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:

text
CACHED 86c819a9 COPY package*.json ./
CACHED e8b3eff5 RUN npm ci
qayta  76022247 COPY src ./src
qayta  3fb86052 RUN npm run build

RUN 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:

  1. FROM da teg yo'q yoki :latest — "teg qotirilmagan";
  2. CMD/ENTRYPOINT JSON ko'rinishida emas ([ bilan boshlanmaydi) — "JSON ko'rinishi emas";
  3. RUN npm ci dan oldin COPY . . bo'lgan — "COPY . . npm ci dan oldin";
  4. faylda USER umuman yo'q — oxirida "USER yo'q: root".

Har topilma: qator: xabar.

Yechim
bash
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" }
' Dockerfile

Natija:

text
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), keyin SIGKILL. 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?", "CMD shell 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 ci qayta yo'q.
  • NODE_ENV=production — build'dan keyin.
  • USER node — ilova root emas, kod faqat o'qiladi.
  • CMD — exec ko'rinishida; ilova PID 1 va SIGTERM ni o'zi ushlaydi. Bola jarayonli ilovaga — --init.
  • docker stop grace'ni doim aniq bering: sukut bilan barcha variantlar 137 bilan o'ldi, -t 30 bilan 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

33-qism. Linux, server, Docker · 29-dars yakunlandi

Dockerfile best practices: kesh, xavfsizlik va signallar

19 daqvaqt
0belgi
Keyingi dars: Multi-stage build va image hajmi
Telegram'da
Darsda xato koʻrdingizmi?

Izohlar · 0