الوسوم والبصمات في صور Docker: لماذا يتغير latest ولا تتغير البصمة
الوسوم والبصمات في صور Docker طريقتان لتسمية الصورة نفسها، والفرق بينهما سبب كثير من مفاجآت الإنتاج: الوسم، مثل 1.0 أو latest، اسم يستطيع أي شخص نقله إلى صورة أخرى في أي لحظة، والبصمة، مثل sha256:edfe73…، رقم محسوب من محتوى الصورة نفسه فلا يمكن أن يشير إلى غيرها. وفي هذا الدليل نثبت ذلك بالتجربة على Docker 29.9: نرفع صورة إلى سجل محلي، ونقرأ بيانها بالبايت، ثم ننقل الوسم latest إلى صورة جديدة، ونسحب بالوسم وبالبصمة القديمة ونقارن، ونبني الصورة نفسها مرتين لنرى هل تتطابق البصمة، ثم نغير بتاً واحداً في السجل لنرى Docker يرفض الصورة.
نمر بالسجل المحلي ولماذا كتبناه، والبيان والبصمة ومعرف الصورة، ونقل الوسم والسحب بالبصمة، والبناء المتكرر، والصور المعلقة وقواعد الأسماء، ثم التحقق من السلامة.
السجل المحلي ولماذا كتبناه
# registry:2 image cannot be pulled here (Docker Hub blocked), and Go modules are blocked too,
# so the lab runs a 77-line Python server that speaks the registry HTTP API:
python3 minireg.py 9656 data &
# GET /v2/ HEAD|GET /v2/<name>/blobs/<digest> POST|PATCH|PUT /v2/<name>/blobs/uploads/
# PUT|GET /v2/<name>/manifests/<tag or digest> GET /v2/<name>/tags/list
docker push localhost:9656/app:1.0 # localhost registries are allowed over plain HTTP
الطريقة المعتادة تشغيل حاوية registry:2 الرسمية، لكن السجلات محجوبة عن المختبر، فكتبنا خادماً صغيراً في Python ينفذ واجهة السجل نفسها: رفع الطبقات على أجزاء، وتخزين البيانات باسم بصمتها، وربط الوسم بالبيان. وأول محاولة رفع فشلت لأن Docker يرسل الأجزاء بترميز chunked الذي لم يدعمه الخادم بعد، فلما أضفناه نجح الرفع. وهذا يكشف أن السجل في جوهره مخزن ملفات تُسمى ببصماتها، وجدول صغير يربط الأسماء بالبصمات.
البيان والبصمة ومعرف الصورة
1.0: digest: sha256:edfe73aa12b38fc06066ba203382dcafaa4fa4baa260333eb0b679343fd0a8b8 size: 943
$ curl -s -H 'Accept: application/vnd.oci.image.manifest.v1+json' localhost:9656/v2/app/manifests/1.0
mediaType application/vnd.docker.distribution.manifest.v2+json
config sha256:abc87e28733a... = image ID shown by docker images
layers sha256:6dd39cad050d 1,145,202 bytes (busybox, gzip)
sha256:d53c3c5f49d4 3,544 bytes (symlinks)
sha256:2a34aae0e217 115 bytes (msg.txt)

ثلاث بصمات مختلفة يخلط الناس بينها. معرف الصورة الذي يظهر في docker images هو بصمة ملف الإعداد، وبصمة الصورة في السجل digest هي بصمة البيان، وهو ملف JSON بحجم 943 بايتاً يسرد ملف الإعداد والطبقات ببصماتها وأحجامها، ولكل طبقة بصمتها. والطبقات في السجل مضغوطة، فطبقة busybox التي حجمها 2.1 ميغابايت على القرص كانت 1.1 ميغابايت في السجل. ولأن البيان يحتوي بصمات كل شيء، فبصمته وحدها تثبت المجموعة كلها.
نقل الوسم والسحب بالبصمة
push app:1.0 and app:latest latest -> sha256:edfe73aa12b3... (msg "version 1")
rebuild, push app:latest again latest -> sha256:21f63e456e4d... (msg "version 2")
delete local images, then:
docker run app:latest -> version 2
docker run app@sha256:edfe73aa12b3... -> version 1
$ curl -s localhost:9656/v2/app/tags/list
{"name": "app", "tags": ["1.0", "latest"]}

بعد البناء الثاني صار latest يشير إلى بصمة جديدة، ومن سحب بالوسم حصل على النسخة الثانية دون أي تحذير. أما السحب بالبصمة القديمة فأعاد النسخة الأولى تماماً، لأن البصمة لا تُنقل. وهذا يعني أن ملف نشر يقول image: app:latest قد يشغل غداً شيئاً غير ما شغله اليوم، وخادمان يسحبان في وقتين مختلفين قد يشغلان نسختين. وفي الإنتاج اكتب الوسم والبصمة معاً، مثل app:1.0@sha256:…، فيقرأ الإنسان الوسم وينفذ Docker البصمة. والأمر docker images –digests يعرض البصمة لكل صورة سُحبت أو رُفعت.
البناء المتكرر: هل تتطابق البصمة؟
same Dockerfile, same files, --no-cache
build 1 image ID 728662ba3581
build 2 (one second later) image ID a4e809378c7e # differs: timestamps
build 3 SOURCE_DATE_EPOCH=0, rewrite-timestamp=true 80464c9fad72
build 4 SOURCE_DATE_EPOCH=0, rewrite-timestamp=true 80464c9fad72 # identical
$ docker tag t:a t:alias # alias -> 728662ba3581, same ID, no copy
بناءان من الملفات نفسها أعطيا معرفين مختلفين، لأن ملف الإعداد يحفظ وقت الإنشاء، وطوابع الملفات في الطبقات تتغير. وحين ثبتنا الوقت بالمتغير SOURCE_DATE_EPOCH مع إعادة كتابة الطوابع في buildx، تطابق البناءان تماماً. وهذا ما يسمى البناء القابل للتكرار، وفائدته أنك تستطيع التحقق من أن الصورة في السجل بُنيت فعلاً من هذا الكود. وdocker tag لا ينسخ شيئاً، بل يضيف اسماً جديداً للمعرف نفسه. وفهم الطبقات وملف الإعداد في أساسيات حاويات Docker والطبقات.
الصور المعلقة وقواعد الأسماء
rebuild with the same tag t:a -> old image keeps only its other name (alias)
an image with no tag left -> REPOSITORY <none> TAG <none> (dangling: 1 here)
$ docker tag t:a Lab/App:1
invalid reference format: repository name (App) must be lowercase
$ docker tag t:a lab/app:-bad
invalid reference format

حين تبني بوسم موجود ينتقل الوسم إلى الصورة الجديدة، والقديمة إن لم يبق لها اسم آخر تصير معلقة باسم none، وتبقى تشغل القرص حتى تحذفها بـ docker image prune. وفي المختبر بقيت صورة واحدة معلقة: النسخة الأولى من app التي سحبناها بالبصمة وحدها، فلا وسم لها. واسم المستودع حروف صغيرة وأرقام وفواصل، والوسم لا يبدأ بنقطة أو شرطة، ورفض Docker الحالتين. وأفضل وسم في خط النشر معرف الالتزام في Git، فهو فريد ويخبرك بالكود.
التحقق من السلامة
# flip one bit in the last layer blob of app:latest on the registry disk, remove local copies
$ docker pull localhost:9656/app:latest
6753d29dd371: Pulling fs layer
6753d29dd371: Verifying Checksum
filesystem layer verification failed for digest sha256:6753d29dd37148e3fbf459afec2f08dfd2ec0b9719115c3c8ba038608fc5a5be

غيرنا بتاً واحداً في طبقة مخزنة على قرص السجل، فحسب Docker بصمة ما نزل ووجدها لا تطابق البيان، فرفض الطبقة. وفي المحاولة الأولى نجح السحب بلا أي تنزيل، لأن الطبقة نفسها كانت ما تزال في ذاكرة البناء المؤقتة على الجهاز، فلم يطلبها Docker أصلاً، وبعد docker builder prune طلبها فكُشف التلاعب. وهذه الحماية تمنع التلف والتعديل أثناء النقل أو التخزين، لكنها لا تثبت من بنى الصورة، فلذلك يأتي توقيع الصور بأدوات مثل cosign، وفكرة البصمة والتوقيع عموماً في الشهادات الرقمية والتشفير.
أخطاء شائعة
latest في ملفات الإنتاج
شغّل السحب الثاني نسخة مختلفة بالاسم نفسه.
الخلط بين معرف الصورة وبصمة السجل
الأول بصمة الإعداد، والثاني بصمة البيان.
توقع تطابق البناءين
لم يتطابقا إلا بتثبيت الوقت.
إهمال الصور المعلقة
تبقى على القرص حتى prune.
أسئلة يطرحها الناس
هل تتغير البصمة إن رفعت الصورة إلى سجل آخر؟
لا إن رُفع البيان نفسه، فالبصمة من المحتوى لا من مكانه.
ماذا عن الصور متعددة المعماريات؟
لها فهرس ببصمة خاصة يشير إلى بيان لكل معمارية، ولم نجربه هنا.
الخلاصة
الوسم latest انتقل من البصمة edfe73 إلى 21f63e فأعطى النسخة الثانية، والسحب بالبصمة القديمة أعاد الأولى. والبيان 943 بايتاً يحمل بصمات الإعداد وثلاث طبقات أصغرها 115 بايتاً، وبناءان متطابقان اختلفا في المعرف حتى ثبتنا الوقت، وبت واحد متغير في السجل جعل Docker يرفض الطبقة.


