تشغيل أمر مرة واحدة في Docker Compose

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

في هذه الحالة، ينوي المستخدم تنفيذ الأمر ./my-project - الإعداد لإضافة المعلومات اللازمة إلى قاعدة البيانات. ولتحقيق ذلك، يوصى بدمج برنامج نصي لنقطة الدخول في الحاوية.

برنامج نصي لنقطة الدخول

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

يضمن هذا الأسلوب تنفيذ أمر التهيئة مرة واحدة فقط، حتى إذا تم إعادة تشغيل الحاوية أو توسيع نطاق الخدمة.

docker-compose.yml File

لتنفيذ هذا الحل، قم بتعديل ملف docker-compose.yml ليشمل البرنامج النصي التالي في خدمة my_project تعريف:

services:
  my_project:
    build: .
    volumes:
      - data:/app
    ports:
      - "6060:8080"
    depends_on:
      - mongo
    entrypoint: ["/app/entrypoint.sh"]

في هذه الحالة، البيانات هي الحجم الذي يحتوي على رمز التطبيق، وentrypoint.sh هو البرنامج النصي لنقطة الدخول.

entrypoint.sh Script

قم بإنشاء برنامج نصي لـentrypoint.sh بالمحتويات التالية:

#!/bin/bash

# Check if database is initialized.
mongo mongo://admin:admin@mongo:27017/my_project --eval "db.user.findOne()" > /dev/null 2>&1

# If the database is not initialized, perform setup.
if [ $? -ne 0 ]; then
  /app/my_project -setup
fi

# Start the application.
/app/my_project

في هذا البرنامج النصي، mongo هو اسم المضيف لحاوية Mongo، وmy_project هو اسم قاعدة البيانات.

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

إزالة "حاوية البيانات فقط"

لاحظ أن المستخدم استخدم في البداية "حاوية بيانات فقط" لتحميل وحدة تخزين قاعدة البيانات. ومع ذلك، لم يعد هذا الأسلوب ضروريًا مع Docker 1.9 والإصدارات الأحدث، التي تدعم وحدات التخزين المسماة. لذلك، يمكن إزالة حاوية mongodata من ملف docker-compose.yml، ويمكن تعديل خدمة mongo لاستخدام المجلد المسمى مباشرة.