٢. الاعتمادات

 

II. Dependencies

٢. الاعتمادات

Explicitly declare and isolate dependencies

تعريف وعزل الاعتمادات صراحة

Most programming languages offer a packaging system for distributing support libraries, such as CPAN for Perl or Rubygems for Ruby. Libraries installed through a packaging system can be installed system-wide (known as “site packages”) or scoped into the directory containing the app (known as “vendoring” or “bundling”).

معظم لغات البرمجة تقدم نظام تحزيم للمكتبات الداعمة، مثل Rubygems للغة روبي

المكتبات المثبتة من خلال نظام تحزيم يمكن تثبيتها علي مستوي النظام بالكامل، او في نطاق المجلد الذي يحتوي التطبيق فقط

A twelve-factor app never relies on implicit existence of system-wide packages. It declares all dependencies, completely and exactly, via a dependency declaration manifest. Furthermore, it uses a dependency isolation tool during execution to ensure that no implicit dependencies “leak in” from the surrounding system. The full and explicit dependency specification is applied uniformly to both production and development.

التطبيق المطابق للقواعد ١٢ لابد الا يعتمد علي المكتبات المثبتة علي مستوي النظام بشكل ضمني. وانما يقوم بتعريف الاعتمادات صراحة وكلية عبر بيان تعريف الاعتمادات. واكثر من ذلك فانه يجب ان يستخدم اداة لعزل الاعتمادات اثناء التنفيذ لضمان عدم التأثر الخارجي من النظام المحيط. بيان الاعتمادات الكامل يجب ان يكون مطبقا بشكل رسمي اثناء التشغيل والتطوير ايضا

For example, Bundler for Ruby offers the Gemfile manifest format for dependency declaration and bundle exec for dependency isolation. In Python there are two separate tools for these steps – Pip is used for declaration and Virtualenv for isolation. Even C has Autoconf for dependency declaration, and static linking can provide dependency isolation. No matter what the toolchain, dependency declaration and isolation must always be used together – only one or the other is not sufficient to satisfy twelve-factor.

علي سبيل المثال، اداة bundler في لغة روبي تقدم ملف Gemfile كنموذج لبيان الاعتمادات، و اداة bundle exec لعزل الاعتمادات
في لغة بايثون هناك اداتين مختلفتين، pip مستخدم في التعريف، و Virtualenv للعزل. حتي لغة C لديها Autoconf لتعريف الاعتمادات، والربط الاستاتيكي يقوم بدور عزل الاعتمادات. ايا كانت الادوات، فان تعريف وعزل الاعتمادات يجب استخدامهما سويا، استخدام واحد منهما دون الاخر لا يجعل التطبيق مطابقا للقواعد ال١٢

One benefit of explicit dependency declaration is that it simplifies setup for developers new to the app. The new developer can check out the app’s codebase onto their development machine, requiring only the language runtime and dependency manager installed as prerequisites. They will be able to set up everything needed to run the app’s code with a deterministic build command. For example, the build command for Ruby/Bundler is bundle install, while for Clojure/Leiningen it is lein deps.

احدي فوائد التعريف الصريح للاعتمادات هو تسهيل التنصيب للمطور المستجد، المطور المستجد يمكنه استكشاف كود التطبيق وتحميله علي جهازه، معتمدا فقط علي بيئة التشغيل ومدير الاعتمادات كمطلب أولي. بعدها يكون قادرا علي تنصيب كل شئ مطلوب لتشغيل التطبيق من خلال أمر بناء محد. مثلا فإن امر البناد للغة روبي هو bundle install, بينما في لغة clojure هو lein deps

Twelve-factor apps also do not rely on the implicit existence of any system tools. Examples include shelling out to ImageMagick or curl. While these tools may exist on many or even most systems, there is no guarantee that they will exist on all systems where the app may run in the future, or whether the version found on a future system will be compatible with the app. If the app needs to shell out to a system tool, that tool should be vendored into the app.

التطبيق المطابق للقواعد ال١٢ لا يعتمد علي افتراض وجود ادوات النظام ضمنيا.ادوات مثل ImageMagick او curl. ادوات كهذه ربما تكون موجودة علي معظم الاجهزة، الا انه لا يوجد ضمان لوجودها في كل النظم التي سيعمل عليها النظام مستقبلا، او ان الاصدارات ستكون ملائمة للتطبيق. اذا كان التطبيق سيحتاج الي احدي ادوات النظام فلابد ان تكون هذه الاداة معبئة مع التطبيق