كيفية إنشاء صورة Docker مخصصة لـ Redmine الخاص بك

Redmine قبل التخصيص

ملاحظة: يمكن العثور على Docker الأصلي لـ Redmine على https://hub.docker.com/_/redmine. هنا يمكنك أيضًا العثور على تعليمات جيدة حول كيفية ملء قاعدة بيانات خارجية وتركيب مجلدات خارجية (لتمكين تثبيت المكونات الإضافية).

إذا كنت مثلي وتفضل أن ترى مباشرةً الشفرة لبناء صورة Redmine Docker مخصصة ، يمكنك الانتقال إلى github.com/lcofre/redmine والتحقق من Dockerfile.

صورة Redmine Docker هي نقطة انطلاق جيدة ، على الرغم من أنك ربما ترغب في تخصيصها باستخدام المكونات الإضافية والسمات التي تفضلها. في هذا الدليل ، سنقوم ببناء صورة Docker استنادًا إلى الصورة الرسمية ، وإضافة بعض السمات والمكونات الإضافية ، وتحميلها إلى سجل Docker.

لأسباب بساطة ، لن نستخدم قاعدة بيانات خارجية ولكن قاعدة بيانات داخلية في حاوية Redmine نفسها. ومع ذلك ، فمن المستحسن إعداد حاوية تخزين مخصصة لبيئة الإنتاج.

المكونات الإضافية والسمات

اخترنا بعض المكونات الإضافية والسمات لتوضيح الطرق المتنوعة لإضافتها إلى Redmine:

• إخفاء الشريط الجانبي ، وهو مكون إضافي يسمح بمزيد من مساحة الشاشة ، خاصة عند كتابة المشكلات
• لصق من الحافظة ، لإرفاق لقطات الشاشة عن طريق لصق من الحافظة بدلاً من تحديد ملف
• A1 و Gitmike ، سمتان لتغيير مظهر واجهة المستخدم

نستبعد المكونات الإضافية التي تتطلب ترحيل قاعدة بيانات ، حيث تحتاج إلى قاعدة بيانات موجودة مسبقًا. يرجى التعليق أدناه إذا كنت بحاجة إلى تثبيت مكون إضافي يحتاج إلى ترحيلات ، حيث لدينا أفكار جيدة لك.

كتابة ملف Dockerfile

ملف Dockerfile هو وصفة لكيفية بناء صورة Docker. أول حقيقة سنتعلمها هنا هي أنه يجب أن نستند صورتنا إلى صورة أخرى ، لذا سنستخدم الصورة الرسمية لـ Redmine

من Redmine

سيستند هذا السطر الأول في ملف Dockerfile أو صورتنا على أحدث صورة متاحة ، 4.1.0 في وقت الكتابة. نظرًا لأن هذا سيحصل على أي إصدار هو الأحدث ، قد تفضل استخدام إصدار محدد لتجنب إصدارات جديدة غير متوقعة قد تعطل بناء هذه الصورة

من Redmine:4.1.0

استخدام Git للحصول على المكونات

في معظم الحالات، تحتوي السمات والمكونات الإضافية على مستودعات Git حيث يمكننا تنزيل أحدث الشفرات. هذا هو الحال للمكونات الثلاثة التالية.

تأتي صورة Redmine الأساسية بدون Git، ولكن يمكننا إضافتها إلى الصورة بهذه الطريقة

RUN apt install -y git

سيتم تنفيذ هذا عند بناء الصورة وسيسمح لك باستخدام Git في التعليمات التالية.

سمة Gitmike: يوصون بنسخ مستودعهم مباشرة

RUN git clone https://github.com/makotokw/redmine-theme-gitmike.git public/themes/gitmike

سيقوم السطر بحفظ المشروع المستنسخ في المجلد المناسب public/themes

إخفاء الشريط الجانبي: يمكن تطبيق نفس الإجراء على المكونات الإضافية. هذا المكون لا يتطلب سوى وضع المجلد المستنسخ في مجلد المكونات الإضافية

RUN git clone https://gitlab.com/bdemirkir/sidebar_hide.git plugins/sidebar_hide

Clipboard Image paste: يبدو أن هذا هو الإجراء النموذجي أيضًا، قم بنسخ المستودع وستكون على ما يرام

RUN git clone https://github.com/RubyClickAP/clipboard_image_paste.git plugins/clipboard_image_paste

ولكن إذا قرأت المزيد سترى أنه "يُوصى بتثبيت حزمة RMagick gem، وإلا فلن يتم عرض الصور المرفقة في ملفات PDF المصدرة". فكيف يمكننا القيام بذلك؟ يجب أن يكون الأمر سهلاً مثل

RUN gem install rmagick

ولكن ربما تعلم أنه يجب بناء الحزمة قبل أن يتم تثبيتها، لذا يجب عليك تثبيت بعض الحزم قبل تثبيت الحزمة. السطر الذي تحتاجه حقًا هو

RUN apt install -y build-essential imagemagick libmagickcore-dev libmagickwand-dev ruby-dev \

       && gem install rmagick

كل ذلك في أمر واحد، مفصول على سطرين لسهولة القراءة.

المؤلف الأصلي لهذا المكون الإضافي لا يوفر إصدارًا لـ Redmine 4، ولكن البحث عن اسم المكون الإضافي في GitHub أدى بي إلى مشروع يفعل ذلك: RubyClickAP/clipboard_image_paste.

إضافة مكون إضافي أو سمة من مصدر تم تنزيله

سمة A1 هي مثال جيد لتوضيح الحالات التي تحتوي فيها على المصدر، ولكن ليس لديك عنوان URL لتنزيله أثناء عملية البناء. إحدى الخيارات في مثل هذه الحالات هو توفير المصدر لعملية البناء. بهذه الطريقة يتم إضافة المحتوى إلى الصورة دون تنزيله

COPY a1 public/themes/a1

يتطلب ذلك وجود مجلد a1 في نفس المكان الذي يوجد فيه ملف Dockerfile.

الآن أنت جاهز لبناء صورتك، لذا افتح الطرفية حيث يوجد ملف Dockerfile الخاص بك وقم بتنفيذ

docker build -t my-redmine .

بمجرد الانتهاء من البناء، يمكنك تشغيل الصورة الخاصة بك باستخدام

docker run -it -p 3000:3000 --name my-redmine my-redmine

انتقل إلى http://localhost:3000 لرؤية Redmine المخصص الخاص بك!

Redmine بعد التخصيص

بعض النصائح لإضافة المزيد من المكونات الإضافية

لتجربة المكونات الإضافية الجديدة، من الأفضل دائمًا استخدام حاوية Redmine جديدة. هذا هو كيف أدركت أن rmagick يتطلب تثبيت بعض الحزم. أولاً، قم بتشغيل نسخة قابلة للتجاهل من Redmine باستخدام

docker run --rm -d -p 3000:3000 --name test-redmine redmine

ثم ادخل إلى النسخة باستخدام

docker exec -it test-redmine bash

هنا يمكنك تثبيت حزم النظام الأساسية، وحزم الجواهر، أو تشغيل الترحيلات. فقط تذكر الخطوات حتى تتمكن من إضافتها إلى Dockerfile الخاص بك!

تحميل صورتك المخصصة إلى Docker Hub

الصورة التي قمت ببنائها متاحة فقط في بيئتك المحلية. ماذا لو كنت ترغب في جعلها متاحة للآخرين، فلنقل الجميع؟ بالطبع، يمكنك تحميل ملف Dockerfile والملفات ذات الصلة إلى مستودع git، ويمكن للمهتمين بناء الصورة بأنفسهم. ولكن Docker يسمح لك أيضًا بتحميل الصورة المبنية إلى سجلهم. لذلك، قم بإنشاء حساب في hub.docker.com وأنشئ أيضًا مستودعًا لصورتك. ثم قم بتسجيل الدخول في الطرفية بهذا الشكل

docker login

قم بوضع علامة على صورتك حتى يمكن تحميلها إلى مستودعك

docker tag my-redmine:latest lcofre/redmine:latest

وقم بدفعها بهذا الشكل

docker push lcofre/redmine:latest

صورة Docker في سجل Docker

الآن يمكن لأي شخص تجربة صورتك عن طريق القيام بالتالي

docker run -it -p 3000:3000 --name my-redmine lcofre/redmine

هذا كل شيء! هكذا تتحول من تثبيت Redmine القياسي إلى نسخة شخصية يمكن الوصول إليها في سجل Docker. يرجى مشاركة تعليقاتك أو أسئلتك أدناه.

تقليص حجم صورة Docker

ستجد أن ملف Dockerfile في المستودع قام بدمج العديد من الأسطر في سطر واحد. هذه هي توصية Docker لتقليل حجم الصور. يمكنك العثور على هذه النصيحة وغيرها في https://docs.docker.com/develop/develop-images/dockerfile_best-practices/

توصية أخرى لتقليل الحجم النهائي للصورة هي استخدام الإصدار الخفيف من Redmine

FROM Redmine:alpine

Alpine هو توزيع Linux مختلف. بدلاً من استخدام apt لتثبيت الحزم، يجب عليك استخدام apk.

نصيحة أخيرة: الحزم التي قمنا بتثبيتها باستخدام apt في ملف Dockerfile لم تعد مطلوبة بعد بناء الصورة. يمكنك اتباع أفضل الممارسات باستخدام بناء متعدد المراحل: https://docs.docker.com/develop/develop-images/dockerfile_best-practices/#use-multi-stage-builds

ممارسة الاحتفاظ بحجم صورة Docker صغير يساعد بشكل خاص عند توسيع عدد الحالات، ولكنه يقلل أيضًا من سطح الهجوم على صورتك.