Readthedocs.org: عنوان URL للوحدة الفرعية غير صالح في المستودعات العامة

تم إنشاؤها على ١ مايو ٢٠١٨ · 3تعليقات · مصدر: readthedocs/readthedocs.org

منذ بعض الوقت ، أضفنا أداة التحقق من عنوان URL للوحدة الفرعية كخطوة أمنية في هذا الالتزام: https://github.com/rtfd/readthedocs.org/commit/43de909b5. نسمح بمخطط عناوين URL مختلف ، ونحمي أنفسنا لأولئك الذين لا نريد دعمهم.

بإلقاء نظرة على تقارير أخطاء Sentry ، وجدت أن هناك مشروعين بهما _invalid_ (لقواعدنا) [email protected] وحدات فرعية URL للمستودعات العامة التي فشلت بسبب قواعدنا.

هذه المشاريع هي على سبيل المثال:

لقد وضعنا علامة على هذا على أنه مستودعات إعادة شراء غير صالحة نظرًا لأنه لا يمكننا التأكد من أنها ستكون عامة ، ولكن ربما نحتاج إلى خطوة إضافية قبل وضع علامة عليها على أنها غير صالحة. لست متأكدًا ، لكنني أفتح هذه القضية لبدء المناقشة على الأقل.

من ناحية أخرى ، فإن التعليقات الوحيدة التي نقدمها للمستخدم هي

واحد أو أكثر من عناوين URL للوحدة الفرعية غير صالحة

والتي ، بدون معرفة القواعد ، من الصعب جدًا إدراك أنك بحاجة إلى إصدار HTTPS لعنوان URL الخاص بالوحدة الفرعية لجعله يعمل.

أيضًا ، لا أعتقد أننا نريد إجبار مستخدمينا على استخدام إصدار HTTPS من عنوان URL للوحدة الفرعية (اعتمادًا على كيفية استخدام الوحدة ، فهو ليس سير عمل جيدًا للمطورين)

متعلق ب:

https://github.com/rtfd/readthedocs-build/pull/47
# 3215
# 3857
# 2829

مشكلة الحراسة: https://sentry.io/read-the-docs/readthedocs-org/issues/502672091/events/latest/

design decision

مصدر

humitos

التعليق الأكثر فائدة

مرحبًا ، لقد واجهت للتو مشكلة مماثلة ، حيث كانت RTD تبلغ:

واحد أو أكثر من عناوين URL للوحدة الفرعية غير صالحة.

لقد استغرق الأمر بعض الوقت لأكتشف أن السبب هو أن الوحدة الفرعية تحتوي على عنوان URL لـ SSH - في الواقع كنت على وشك إرسال مشكلة. لقد غيرتها إلى HTTPS واختفت المشكلة.

أعتقد أن الرسالة ليست واضحة للغاية. سيكون من الجيد أيضًا أن يصف دليل RTD هذا القيد (حاولت البحث عن "وحدات فرعية" ولم يظهر شيء.)

jcarrano في ٧ ديسمبر ٢٠١٨

👍3

ال 3 كومينتر

يمكننا إرجاع عنوان url غير صالح هنا https://github.com/rtfd/readthedocs.org/blob/dfc8fc9eba8dc9caae171ca0b3e8f6a71594e088/readthedocs/vcs_support/backends/git.py#L117 -L121 وأظهر أنه أفضل استخدام ، على الأقل ملحوظة.

أيضًا ، لا أعتقد أننا نريد إجبار مستخدمينا على استخدام إصدار HTTPS من عنوان URL للوحدة الفرعية (اعتمادًا على كيفية استخدام الوحدة ، فهو ليس سير عمل جيدًا للمطورين)

أعتقد الأمر نفسه ، هل هناك أي طريقة يمكن للمستخدمين من خلالها التعدي على ذلك؟ أعني ، إذا لم يكن لدينا مفاتيحهم الخاصة ، فعندئذ لا يمكننا سحب رمزهم.

stsewd في ٢٦ أكتوبر ٢٠١٨

👍1

مرحبًا ، لقد واجهت للتو مشكلة مماثلة ، حيث كانت RTD تبلغ:

واحد أو أكثر من عناوين URL للوحدة الفرعية غير صالحة.

jcarrano في ٧ ديسمبر ٢٠١٨

👍3

العمل مع https لأن مخطط الوحدات الفرعية ليس مثاليًا. هل يمكن تحويل عناوين URL (مثل الإشارات المرجعية في هذه المشكلة) قبل أن تكون الوحدات الفرعية مستنسخة؟