تحتوي هذه الصفحة على تفاصيل مشروع كتابة فني مقبول في موسم Google من المستندات.
ملخص المشروع
- مؤسسة مفتوحة المصدر:
- مشروع FreeBSD
- الكاتب التقني:
- لاري
- اسم المشروع:
- تعديلات على أدلة FreeBSD
- طول المشروع:
- مدّة طويلة (5 أشهر)
وصف المشروع
سيتألف مشروع GSoD2020 هذا من فصلين في كتيّبات FreeBSD:
- الاختبار: فصل جديد في دليل مطوّري FreeBSD
- LDAP: تم دمج المقالة في فصل في كتيب FreeBSD
الاختبار: فصل جديد في كتيب مطوّري برامج FreeBSD:
ملاحظة: هذا المشروع استكشافي في البداية. قد تتغير المتطلبات أثناء مرحلة الكتابة.
تشمل مهام التحضير ما يلي: * مراجعة المستندات الحالية والملاحظات حول إطارات عمل اختبار المطوّرين وممارساتهم وما إلى ذلك لنظام التشغيل FreeBSD وأنظمة التشغيل الأخرى المستندة إلى نظام التشغيل BSD * مستندات وملاحظات حالية أو قديمة عن FreeBSD. على سبيل المثال: * TestSuite: https://wiki.freebsd.org/TestSuite * صفحة ""TestingFreeBSD"" القديمة: https://wiki.freebsd.org/TestingFreeBSD * المستندات الحالية والملاحظات من المشاريع ذات الصلة على سبيل المثال: * http://wiki.netbsd.org/tutorials/atf/ * المستندات الأساسية للأدوات المعنيّة على سبيل المثال: * إطار عمل اختبار Kyua: https://github.com/jmmv/kyua/ * إطار عمل الاختبار الآلي (ATF): https://github.com/jmmv/atf/ * تثبيت الأطر ذات الصلة وضبطها للتعرّف عليها * استخدام أُطر الاختبار لإجراء الاختبارات الحالية * كتابة عدد صغير من الاختبارات الجديدة * (ملاحظة مهمة جدًا) استشارة القرّاء (مطوّرو البرامج والمختبِرون) بشأن ما يريدون رؤيته في الفصل
سيتم تحديد التنظيم الدقيق للمستندات. ومع ذلك، بعد قراءة الفصل، من المفترض أن يتمكّن القارئ من تنفيذ ما يلي على الأقل:
- تثبيت أُطر الاختبار وضبطها لأغراض اختبار FreeBSD
- اكتب اختبارًا لإطار العمل الخاص بالاختبار.
- أجرِ اختبارًا في إطار الاختبار.
سيتم التركيز على ما يلي كلما أمكن: * زيادة التشغيل الآلي إلى أقصى حدّ لتقليل العمل المبذول في إعداد البنية الأساسية للاختبار وكتابة الاختبارات وتنفيذها * إضافة حالات اختبار كلما تم إصلاح خطأ جديد * اختبارات الانحدار التلقائية الشاملة * (حيثما ينطبق ذلك) تغطية أمثلة على سيناريوهات الاختبار العادية، مثل اختبار الوحدة والاختبار الوظيفي واختبار التحميل وما إلى ذلك
إنّ الهدف ليس فقط شرح إطار العمل للاختبار وإرشاد المطوّر من خلاله، بل نأمل أيضًا أن تكون العملية بسيطة قدر الإمكان لكي يتم تشجيع المطوّرين على إجراء المزيد من الاختبارات، وألا يشعر المطوّرون الجدد بالإحباط من المشاركة.
LDAP: تم دمج المقالة التي تم تحديثها في فصل في كتيب FreeBSD:
على عكس الفصل المخصص للاختبار، يكون نطاق المقالة أو الفصل المعدَّل حول LDAP مفهومًا جيدًا.
يحتوي كلّ من الفصل الحالي في دليل FreeBSD والمقالة الحالية على الكثير من المعلومات المفيدة. ومع ذلك، يجب تعديلها. تم بدء مراجعة جديدة للمقالة، وكان من المفترض أن تكون الفصل الجديد، ولكن يجب إكمالها.
تشمل المهام ما يلي: * التدقيق اللغوي في فصل الكتيب الحالي والمقالة الحالية * تم إجراء جولة أولية استعدادًا لـ GSoD2020. * اختبار كل قسم في الكتيب لتأكيد ما الذي يعمل وما الذي يحتاج إلى مراجعة * تم اختبار إعدادات الخادم مع تحديد التحسينات في إطار الاستعداد لحدث GSoD2020. * الأقسام الأخرى المتبقية * كتابة محتوى جديد ومراجعة المحتوى الحالي * تم بدء عرض المحتوى المعدَّل في قسم الخادم. يجب إكمالها. * الأقسام الأخرى المتبقية * اختبار كل المحتوى على أنظمة FreeBSD النظيفة بعد اكتمال المسودة النهائية * هذه المهمة ضرورية لأنّها تحدد أيّ ثغرات.
من المتوقع أن تحتوي المقالة الأخيرة أو فصل الكتيب على الأقسام التالية:
(1) مقدمة عن LDAP (2) إعداد الخادم: (أ) دليل تفصيلي توضيحي لإعداد خادم OpenLDAP أساسي ولكن فعّال على FreeBSD (ب) مثال كامل لإعدادات خادم OpenLDAP الأساسية والوظيفية، مثل نتيجة (2(أ))، على FreeBSD
تشمل ""الإعدادات الأساسية ولكنّها فعّالة"" ضبط إعدادات الخادم باستخدام كلمات مرور مجزّأة، واتصالات آمنة عبر الشبكة، وبيانات مستخدمين محاكية ولكنّها تمثيلية.
(اختياري - سيتم تحديده خلال GSoD2020) قد تتضمّن أيضًا إعدادات الخادم تغطية مماثلة لخادم الدليل 389 في FreeBSD. كان هناك دعم تجريبي لنظام التشغيل FreeBSD في 389 Directory Server، ولكن يجب تأكيد حالته الحالية.
(3) إعداد العميل: (أ) دليل تفصيلي توضيحي لإعداد عميل وظيفي على FreeBSD يمكنه الاتصال بمثال اتصال الخادم الوارد في (2). (ب) مثال كامل على إعدادات العميل الصالحة، مثل نتيجة (3أ) على FreeBSD
سيتضمّن قسم إعداد العميل أقسامًا فرعية حول ما يلي: * وحدة المصادقة القابلة للتركيب (PAM)، مثل pam_ldap وpam_mkhomedir وnss-pam-ldapd * مبدِّل خدمة الأسماء (NSS)، مثل nss_ldap وnss-pam-ldapd * (اختياري - سيتم تحديده خلال GSoD2020) SSSD: يجب تأكيد حالة SSSD في مرحلة الإنتاج في FreeBSD. * (اختياري - سيتم تحديده خلال GSoD2020) FreeIPA: يجب التحقيق في استخدام FreeIPA ووظائفه في FreeBSD. تغطّي FreeIPA أكثر من مجرد بروتوكول LDAP، لذا يجب تقييم نطاق إعدادات FreeIPA قبل تضمينها في فصل هذا الدليل.
(4) اعتبارات الأمان * يتضمّن الإصدار الحالي من المقالة قسمًا حول اعتبارات الأمان. وقد يتم نقل بعض هذا المحتوى إلى القسم ذي الصلة. ومع ذلك، لا يزال هناك قسم مخصص لالاعتبارات الأمنية لأغراض مرجعية.
(5) تحديد المشاكل وحلّها * استراتيجيات لتحديد مشاكل إعداد LDAP وحلّها
(6) ملحق OpenSSL
باستخدام فصل / مقالة الدليل المحدث، يمكن للقارئ استخدام نظامين نظيفين من FreeBSD، وإعداد خادم LDAP وعميل LDAP، ومصادقة العميل مقابل الخادم.
بعد قراءة الفصل أو المقالة المعدَّلة في الكتيب، من المفترض أن يحصل القارئ على المعلومات الأساسية اللازمة للاطّلاع على مستندات أخرى أكثر تخصصًا أو شمولية، مثل مستندات OpenLDAP وطلبات RFC الخاصة بـ LDAP، وإنشاء إعدادات LDAP في FreeBSD أو تحسينها لتلبية متطلباته.