Navigating Ruby on Rails Deployment with AZK: A Comprehensive Guide

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

أولاً وقبل البدء في الخطوات الفعلية، يجب أن تتأكد من أنك قد قمت بتثبيت AZK على جهازك. يمكنك القيام بذلك عبر الأمر التالي:

bashCopy code
$ curl -Ls http://azk.io/install.sh | bash

بعد التثبيت الناجح، يمكنك البدء في تكوين تطبيقك للعمل مع AZK.

1. ملف Azkfile.js:
   يجب إنشاء ملف Azkfile.js في جذر مشروعك. يحتوي هذا الملف على تكوين AZK الذي يحدد كيف يجب تشغيل التطبيق.

   javascriptCopy code
   systems({
     myapp: {
       depends: ["db"],
       image: {"docker": "azukiapp/ruby:2.3"},
       provision: ["bundle install --path /azk/bundler"],
       workdir: "/azk/#{manifest.dir}",
       shell: "/bin/bash",
       command: ["bundle", "exec", "rails", "server", "--binding", "0.0.0.0"],
       wait: 20,
       mounts: {
         "/azk/bundler": persistent("#{manifest.dir}/.bundle"),
         "/azk/#{manifest.dir}": path(".")
       },
       scalable: {"default": 1},
       http: {
         domains: ["#{system.name}.#{azk.default_domain}"]
       },
       ports: {
         http: "3000/tcp"
       },
       envs: {
         RUBY_ENV: "development",
         BUNDLE_APP_CONFIG: "/azk/bundler",
       },
     },
     db: {
       image: {"docker": "azukiapp/postgres:9.4"},
       scalable: false,
       wait: 25,
       mounts: {
         '/var/lib/postgresql/data': persistent("postgres-#{manifest.dir}")
       },
       ports: {
         // exports global variables
         data: "5432/tcp",
       },
       envs: {
         // set instances names to use in links
         POSTGRES_USER: "azk",
         POSTGRES_PASS: "azk",
       },
     },
   });
   

   في هذا الملف، تم تعريف نظامين: myapp و db. يعتمد myapp على db ويستخدم صورة Docker لـ Ruby. يتم تشغيل تثبيت الحزم وأمر الخادم Rails في هذا النظام.

2. تكوين البيئة:
   يمكنك تكوين بيئة تطويرك في ملف .env الذي يحتوي على المتغيرات البيئية المطلوبة لتشغيل تطبيقك.

   bashCopy code
   // .env
   RAILS_ENV=development
   DATABASE_URL=postgresql://azk:azk@db:5432/myapp_development
   

3. تشغيل التطبيق:
   بعد الانتهاء من الخطوات السابقة، يمكنك تشغيل تطبيقك باستخدام الأمر:

   bashCopy code
   $ azk start
   

   سيقوم AZK بتكوين البيئة وتشغيل التطبيق. يمكنك الوصول إليه عبر المتصفح عن طريق http://myapp.azk.dev:3000.

4. إدارة الاعتمادات:
   تأكد من إدارة الاعتمادات الخاصة بقاعدة البيانات في تكوين Azkfile.js وفي ملف .env.

   حيث يظهر هنا أن اسم المستخدم هو “azk” وكلمة المرور هي “azk”. يجب أن تتطابق هذه الاعتمادات مع تلك المستخدمة في تكوين قاعدة البيانات الخاصة بك.

باستخدام هذه الخطوات، يمكنك نشر تطبيق Ruby on Rails باستخدام AZK بسهولة. يجب أن يكون لديك الآن بيئة تطوير مكونة وجاهزة للعمل، مما يسمح لك بتطوير تطبيقك بكفاءة وفعالية.

بالطبع، دعنا نعمق أكثر في بعض المعلومات حول نشر تطبيق Ruby on Rails باستخدام AZK.

5. تكوين قاعدة البيانات:
   في المثال أعلاه، يُفضل استخدام PostgreSQL كنظام لقاعدة البيانات. يمكنك تكوين الاتصال بقاعدة البيانات من خلال ملف config/database.yml في مشروع Rails الخاص بك. تأكد من أن معلومات اتصال قاعدة البيانات تتوافق مع تلك الموجودة في ملف Azkfile.js.

   yamlCopy code
   development:
     adapter: postgresql
     encoding: unicode
     database: myapp_development
     pool: 5
     username: azk
     password: azk
     host: db
     port: 5432
   

6. إدارة الإعدادات:
   يمكنك إدارة إعدادات تطوير تطبيقك من خلال ملفات تكوين Rails. يمكنك تحديد المتغيرات التي تستخدمها تطبيقك في ملفات مثل config/environments/development.rb واستخدام ملف .env للإعدادات المحيطية.

   rubyCopy code
   # config/environments/development.rb
   config.action_mailer.default_url_options = { host: 'myapp.azk.dev:3000' }
   

7. التفاعل مع خدمات أخرى:
   AZK تسمح بتكوين وتشغيل خدمات إضافية، مثل خدمات Redis أو Elasticsearch. يمكنك إضافة هذه الخدمات في ملف Azkfile.js لتحسين تطوير وظائف تطبيقك.

   javascriptCopy code
   myapp: {
     // ...
     depends: ["db", "redis", "elasticsearch"],
     // ...
   },
   redis: {
     image: {"docker": "redis"},
     ports: {
       data: "6379/tcp",
     },
   },
   elasticsearch: {
     image: {"docker": "elasticsearch"},
     ports: {
       http: "9200/tcp",
     },
   },
   

8. إدارة الاستجابات:
   في بيئة التطوير، قد تحتاج أحيانًا إلى إعادة تشغيل تطبيقك أو إعادة تكوين بعض الخدمات. يمكنك القيام بذلك ببساطة باستخدام أوامر AZK المختلفة، مثل azk restart لإعادة تشغيل التطبيق.

   bashCopy code
   $ azk restart -Rvv
   

9. التحكم في القوالب:
   يمكنك تعديل ملف Azkfile.js لتناسب احتياجات تطويرك بشكل أفضل. يمكنك تحديد المزيد من الخصائص مثل حجمات التخزين الدائم، وتكوين المتغيرات البيئية، وتحديد المزيد من الخيارات لضبط سير عمل تطبيقك.

   javascriptCopy code
   myapp: {
     // ...
     mounts: {
       "/azk/bundler": persistent("#{manifest.dir}/.bundle"),
       "/azk/#{manifest.dir}": path("."),
       "/azk/data/uploads": persistent("#{manifest.dir}/uploads"),
     },
     envs: {
       RUBY_ENV: "development",
       BUNDLE_APP_CONFIG: "/azk/bundler",
       MYAPP_CONFIG: "value",
     },
     // ...
   },
   

10. توثيق ومصادر:
    للحصول على مزيد من المعلومات حول AZK وكيفية استخدامها بفعالية، يفضل دائماً قراءة التوثيق الرسمي والاستفادة من المصادر المجتمعية، مثل المنتديات والمدونات التي قد تحتوي على تجارب وتلميحات قيمة.

• توثيق AZK
• مستودع GitHub AZK

بهذه الطريقة، يمكنك تحسين ونشر تطبيقك Ruby on Rails باستخدام AZK بشكل أكثر فعالية، وتحقيق بيئة تطوير مستدامة ومُحسَّنة.