distribution spec
v1.1.0
يحدد مشروع مواصفات توزيع OCI بروتوكول API لتسهيل وتوحيد توزيع المحتوى.
يمكن العثور على المواصفات هنا.
يوفر هذا المستودع أيضًا أنواع GO ، وأدوات مطابقة التسجيل. يجب أن تكون أنواع GO والتحقق من الصحة متوافقة مع إصدار GO الحالي ؛ في وقت سابق لا يتم دعم إصدارات GO.
وثائق إضافية حول كيفية عمل هذه المجموعة:
ترتبط مواصفات توزيع OCI ارتباطًا وثيقًا بمشروع مواصفات تنسيق صورة OCI ومشروع مواصفات وقت تشغيل OCI.
تحدد مواصفات تنسيق صورة OCI بدقة متطلبات صورة OCI (صورة الحاوية) ، والتي تتكون من واضح ، وفهرس صورة اختياري ، ومجموعة من طبقات نظام الملفات ، والتكوين. يتم دعم مخطط مكونات صورة OCI بالكامل بواسطة واجهات برمجة التطبيقات المحددة في مواصفات توزيع OCI.
تحدد مواصفات وقت تشغيل OCI كيفية تشغيل "حزمة نظام الملفات" بشكل صحيح والتي تلتزم بالكامل بمواصفات تنسيق صورة OCI. ترتبط مواصفات وقت تشغيل OCI بمواصفات توزيع OCI من حيث أن كلاهما يدعم صور OCI ، وأن أوقات تشغيل الحاويات تستخدم واجهات برمجة التطبيقات المحددة في مواصفات توزيع OCI لجلب صور الحاويات المدمجة مسبقًا وتشغيلها.
تم تصميم مواصفات توزيع OCI (هذا المشروع) أيضًا بشكل عام بما يكفي للاستفادة من آلية توزيع لأي نوع من المحتوى. على سبيل المثال ، لا يلزم تنسيق البيان المحمّل ، على سبيل المثال ، بالضرورة مواصفات تنسيق صورة OCI طالما أنه يشير إلى النقط التي تشتمل على قطعة أثرية معينة.
للحصول على أسئلة حول مواصفات توزيع OCI ، يرجى الاطلاع على الأسئلة الشائعة.
للأسئلة العامة حول OCI ، يرجى الاطلاع على الأسئلة الشائعة على موقع OCI.
تضع معالم جيثب الطريق إلى التحسينات المستقبلية.
يتضمن مشروع مواصفات التوزيع عملية وواجهة برمجة تطبيقات للنماذج الأولية واختبار امتدادات توزيع واجهة برمجة تطبيقات.
ندعو المساهمات والتعليقات والمراجعات لهذه الامتدادات. لن تتحرك هذه الامتدادات إلا بدعم كبير من السجلات وعملاء التسجيل والمستخدمين.
يرجى الاطلاع هنا لمزيد من التفاصيل.
يحدث التنمية على github للمواصفات. يتم استخدام المشكلات للأخطاء والعناصر القابلة للتنفيذ ويمكن أن تحدث مناقشات أطول في القائمة البريدية.
يتم ترخيص المواصفات والرمز بموجب ترخيص Apache 2.0 الموجود في ملف LICENSE هذا المستودع.
يرحب المشروع بطلب ، ولكن يرجى إخبار الجميع بما تعمل عليه.
قبل إجراء تغيير غير تافهة لهذا المواصفات ، أرسل بريدًا إلى القائمة البريدية لمناقشة ما تخطط للقيام به. هذا يمنح الجميع فرصة للتحقق من صحة التصميم ، ويساعد على منع تكرار الجهد ، ويضمن أن الفكرة تناسبها. كما يضمن أن التصميم سليم قبل كتابة الكود ؛ لا يعد طلب سحب github هو المكان المناسب للمناقشات عالية المستوى.
يمكن أن تذهب الأخطاء المطبعية والأخطاء النحوية مباشرة إلى طلب سحب. عندما تكون في شك ، ابدأ في القائمة البريدية.
يرجى الاطلاع على README REDME OCI org للحصول على أحدث المعلومات حول جداول اجتماعات مساهم OCI ومحافظ. يمكنك أيضًا العثور على روابط لجدول أعمال الاجتماع والدقائق لجميع الاجتماعات السابقة.
يمكنك الاشتراك والانضمام إلى القائمة البريدية على مجموعات Google.
تحدث مناقشة OCI في غرف الدردشة التالية ، والتي يتم سدها جميعًا:
للحفاظ على الاتساق عبر ملفات Markdown في مواصفات الحاوية المفتوحة ، يجب تنسيق جميع الملفات جملة واحدة لكل سطر. هذا يعمل على إصلاح شيئين: إنه يجعل الانتشار أسهل مع Git ويحل المعارك حول طول تغليف الخط. على سبيل المثال ، سوف تمتد هذه الفقرة ثلاثة خطوط في مصدر تخفيض الطلب.
يعد التسجيل خطًا بسيطًا في نهاية التفسير للتصحيح ، والذي يشهد أنك كتبته أو لديك الحق في تمريره كتصحيح مفتوح المصدر. القواعد بسيطة جدًا: إذا كان بإمكانك التصديق على ما يلي (من DevelopererCertificate.org):
Developer Certificate of Origin
Version 1.1
Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
660 York Street, Suite 102,
San Francisco, CA 94110 USA
Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.
Developer's Certificate of Origin 1.1
By making a contribution to this project, I certify that:
(a) The contribution was created in whole or in part by me and I
have the right to submit it under the open source license
indicated in the file; or
(b) The contribution is based upon previous work that, to the best
of my knowledge, is covered under an appropriate open source
license and I have the right under that license to submit that
work with modifications, whether created in whole or in part
by me, under the same open source license (unless I am
permitted to submit under a different license), as indicated
in the file; or
(c) The contribution was provided directly to me by some other
person who certified (a), (b) or (c) and I have not modified
it.
(d) I understand and agree that this project and the contribution
are public and that a record of the contribution (including all
personal information I submit with it, including my sign-off) is
maintained indefinitely and may be redistributed consistent with
this project or the open source license(s) involved.
ثم تقوم فقط بإضافة سطر إلى كل رسالة ملتزمة بالجيت:
Signed-off-by: Jane Smith <[email protected]>
باستخدام اسمك الحقيقي (آسف ، لا توجد أسماء مستعارة أو مساهمات مجهولة.)
يمكنك إضافة الإشارة عند إنشاء GIT Commice عبر git commit -s .
حفظ المنزل البسيط لتاريخ GIT النظيف. اقرأ المزيد حول كيفية كتابة رسالة التزام GIT أو قسم المناقشة في git-commit(1) .
