paserver docker
11.3.0
مرحبًا بك في دليل نشر تطبيقات Rad Studio على Linux باستخدام Docker و Paserver. يوفر هذا المستودع برنامج نصي Docker مصمم لتبسيط إعداد وإدارة بيئة التطوير الخاصة بك ، مما يسمح لمطوري استوديو Rad بنشر واختبار تطبيقاتهم في بيئة Linux.
تتخلف الصورة الافتراضية لتشغيل Paserver على المنفذ 64211 مع كلمة المرور securepass
تستخدم الصور 10.x Ubuntu 18.04.6 LTS (Bionic Beaver) بينما تستخدم الصور +11.x Ubuntu 22.04.1 LTS (Jammy Heyffish)
run.sh ] البرنامج النصي [ run.sh ] هو أداة الانتقال إلى الأتمتة لإعداد ونشر تطبيق Paserver بسهولة ومرونة. فيما يلي التعليمات اللازمة لاستخدام هذا البرنامج النصي بشكل فعال.
تأكد من تثبيت Docker على نظامك حيث يستخدم هذا البرنامج النصي Docker لتشغيل تطبيق Paserver.
انتقل إلى الدليل الذي يحتوي على [ run.sh ] في المحطة الخاصة بك. قم بتنفيذ البرنامج النصي بخياراتك المفضلة:
./run.sh [OPTIONS]--name أو -n : اسم الحاوية (على سبيل المثال ، --name=myPAServer ).--path أو -pa : مسار ربط لرسم خرائط الصوت (على سبيل المثال ، --path=/my/custom/path ).--detach أو -d : تشغيل الحاوية في وضع فصل (خلفية).--port أو -p : PORT FOR PASERVER (على سبيل المثال ، --port=64211 ).--production أو -pr : تمكين وضع الإنتاج ( true ).--version أو -v : إصدار paserver (على سبيل المثال ، --version=latest ).--password أو -pw : اضبط كلمة مرور لـ Paserver (على سبيل المثال ، --password=securepass ).--help أو -h : يوضح مساعدة البرنامج النصي.قم بتشغيل Paserver في وضع الإنتاج على المنفذ 65000 مع اسم وكلمة مرور مخصصة:
./run.sh --name=myPAServer --port=65000 --production --password=mysupersecurepasswordقم بتشغيل Paserver في وضع فصل مع إصدار محدد ، ومسار ربط ، وكلمة مرور:
./run.sh --detach --version=12.1 --path=/my/custom/path --password=mysupersecurepassword تأكد من أن لديك الأذونات اللازمة لتنفيذ run.sh استخدم chmod +x run.sh لجعله قابل للتنفيذ إذا لزم الأمر.
docker run مباشرة للمستخدمين الذين يفضلون نهجًا عمليًا أو يرغبون في تخصيص نشرهم بشكل أكبر ، يمكنك استخدام أمر docker run مباشرة لبدء حاوية Paserver الخاصة بك. توفر هذه الطريقة المرونة وتتيح لك تحديد كل خيار يدويًا.
الهيكل الأساسي للأمر لتشغيل حاوية Paserver Docker هو كما يلي:
docker run [OPTIONS] radstudio/paserver:[VERSION]-e PA_SERVER_PASSWORD=[PASSWORD] : تعيين كلمة المرور لـ Paserver. استبدل [PASSWORD] بكلمة المرور المطلوبة.--name [NAME] : يعين اسم مخصص لحاوية Docker الخاصة بك. استبدل [NAME] باسم الحاوية المفضلة لديك.-p [PORT]:64211 : قم بتخطيط منفذ مخصص على مضيفك إلى المنفذ الافتراضي لـ Paserver (64211). استبدل [PORT] برقم المنفذ الذي ترغب في استخدامه.[DETACH_ARG] : استخدم -d لتشغيل الحاوية في الوضع المنفصل (في الخلفية).[BIND_PATH_ARG] : use -v [HOST_PATH]:[CONTAINER_PATH] لربط وحدة تخزين للبيانات أو التكوينات المستمرة. استبدل [HOST_PATH] و [CONTAINER_PATH] بمساراتك المحددة. لتشغيل Paserver في حاوية Docker تسمى myPAServer ، والاستماع إلى المنفذ 65000 ، مع كلمة مرور لـ mysupersecurepassword ، وتشغيلها في وضع منفصل ، يمكنك استخدام الأمر التالي:
docker run -d
-e PA_SERVER_PASSWORD=mysupersecurepassword
--name myPAServer
-p 65000:64211 radstudio/paserver:latest إذا كنت ترغب في ربط وحدة تخزين للبيانات المستمرة ، فيمكنك إضافة خيار -v :
docker run -d
-e PA_SERVER_PASSWORD=securepass
-v /path/on/host:/root/PAServer/scratch-dir
--name myPAServer
-p 65000:64211 radstudio/paserver:latest يتيح لك Docker Compose تحديد وتشغيل تطبيقات Docker متعددة المونتي. فيما يلي ملف docker-compose.yml يوضح كيفية استخدام صورة Docker كجزء من خدمة ، باستخدام متغيرات البيئة للتكوين.
version : ' 3.8 '
services :
myPAServer :
image : radstudio/paserver:latest
container_name : myPAServer
environment :
- PA_SERVER_PASSWORD=${PA_SERVER_PASSWORD} # Environment variable for the server password
ports :
- ' ${HOST_PORT}:64211 ' # Environment variable for the host port
volumes :
- ${HOST_PATH}:/root/PAServer/scratch-dir # Environment variable for the host path
restart : unless-stopped يحدد هذا التكوين خدمة واحدة تسمى myPAServer . يستخدم صورة Docker radstudio/paserver:latest . يتضمن تكوين الخدمة تعيين منفذ من المضيف إلى الحاوية ، وتعيين متغير بيئة لكلمة مرور الخادم ، وتركيب وحدة تخزين من المضيف إلى الحاوية. يمكن تخصيص هذه الإعدادات من خلال متغيرات البيئة المحددة في ملف .env الموجود في نفس الدليل مثل docker-compose.yml .
# .env file
PA_SERVER_PASSWORD=securepass
HOST_PORT=65000
HOST_PATH=/path/on/host
لبدء تطبيقك ، قم بتنفيذ الأمر التالي في الدليل الذي يحتوي على docker-compose.yml :
docker-compose up يبدأ هذا الأمر في عملية تكوين Docker ، التي تقرأ ملف docker-compose.yml وملف .env ، بتطبيق التكوينات لبدء خدمتك على النحو المحدد.
سيؤدي ذلك إلى سحب الصورة اللازمة (إذا لم تكن متوفرة محليًا بالفعل) ، قم بإنشاء المجلدات المحددة ، وتعيين متغيرات البيئة ، وابدأ تطبيقك على المنافذ المحددة.
تأكد من استبدال /path/on/host بالمسار الفعلي الذي ترغب في استخدامه لربط الصوت. يمكن استبدال latest علامة بأي إصدار محدد من Paserver الذي ترغب في نشره.
سيساعدك هذا الدليل على تخصيص صورة Paserver لتناسب احتياجاتك المحددة ، مثل إضافة ملفات أو مجلدات إضافية ، وتثبيت حزم إضافية ، وإجراء تعديلات أخرى.
لإضافة ملفات أو مجلدات إلى صورة Docker الخاصة بك ، استخدم COPY أو ADD تعليمات في DockerFile. يتم تفضيل COPY لنسخ الملفات المحلية ، في حين يمكن ADD التعامل مع عناوين URL عن بُعد واستخراج القطران.
COPY ./myconfig.conf /etc/myapp/myconfig.conf يقوم هذا الأمر بنسخ myconfig.conf من دليل المشروع الخاص بك إلى /etc/myapp/myconfig.conf داخل صورة Docker.
لتثبيت حزم إضافية ، يمكنك تعديل الأمر RUN الذي يقوم بتثبيت الحزم. من الأفضل دمج أوامر تثبيت الحزمة في تعليمة RUN واحدة لتقليل عدد الطبقات في صورة Docker الخاصة بك.
RUN apt-get update && apt-get install -y
git
cmake
&& rm -rf /var/lib/apt/lists/*بناءً على كل مشروع ، قد تكون مكتبات محددة ضرورية. يقوم هذا الأمر بتحديث قوائم الحزمة ، ويقوم بتثبيت git و cmake ، ويتنظف بعد ذلك للحفاظ على حجم الصورة.
لتجنب الطبقات الإضافية في صورة Docker النهائية ، من الممارسات الجيدة تعديل أمر RUN apt-get update لتشمل المكتبات المطلوبة.
يمكنك تخصيص Dockerfile لتغيير متغيرات البيئة ، أو تنزيل إصدارات مختلفة من البرامج ، أو تعديل عملية التثبيت.
ENV MY_CUSTOM_VAR=myvalue هذا يعين متغير البيئة MY_CUSTOM_VAR الذي يمكن استخدامه بواسطة التطبيق الخاص بك.
بعد تخصيص DockerFile ، يمكنك إنشاء صورة Docker الخاصة بك باستخدام أمر docker build .
docker build -t my-custom-paserver:latest . يقوم هذا الأمر بإنشاء صورة Docker باسم my-custom-paserver مع latest علامة ، باستخدام Dockerfile في الدليل الحالي.
بالنسبة للقيم التي قد تتغير بين الإنشاءات (مثل كلمات المرور أو أرقام الإصدار) ، يمكنك استخدام تعليمات ARG في DockerFile وتمرير القيم باستخدام-- --build-arg أثناء البناء.
ARG password=securepassبناء بكلمة مرور مخصصة:
docker build --build-arg password=mypassword -t my-custom-paserver:latest .build.sh ] الذي يمكن استخدامه كقالب لتبسيط التصميم المخصص.linux/amd64 . لتجنب المشكلات المحتملة في إعدادات الذراع ، قم ببناء الصورة باستخدام Arg --platform linux/amd64RUN واحد حيثما أمكن ذلك..dockerignore : أضف ملف .dockerignore إلى مشروعك لتجنب نسخ الملفات غير الضرورية إلى صورة Docker الخاصة بك.هذا البرنامج هو حقوق الطبع والنشر © 2024 من قبل Embarcadero Technologies ، Inc.
لا يجوز لك سوى استخدام هذا البرنامج إذا كنت مرخصًا معتمد لمنتج أدوات مطور Embarcadero. راجع أحدث اتفاقية ترخيص البرمجيات للحصول على أي تحديثات.
