يحتاج الإعداد الأساسي للوكيل العكسي إلى ثلاث قرارات فقط، ويقدم هذا الدليل المساعدة في كل واحدة منها: اسم المضيف، المسار، والخادم الخلفي. قد يعني بحث وكيل HTTP وكيلاً أمامياً أو خلفياً، وهنا تخطط للتحقق من خادم تشغله بنفسك. لا يقرر الوكيل نيابة عنك أي المضيف أو المسار هو الصحيح. يكتب ما تطلبه، يعرض كل تغيير كاختلاف، ويبلغ عن النتيجة الحقيقية لكل أمر، بحيث يمكنك رؤية تأثير كل قرار قبل التالي. اتبع الخطوات الأربع أدناه بالترتيب، واعتبر خطة التوجيه هي الوثيقة التي تتبعها أنت والوكيل من الأمر الأول إلى الطلب الأخير.
ابدأ ببرنامج Segment Route وافتح مجلد العمل الذي يحتوي على ملفات التكوين والتوجيه. تعمل أدوات الملفات في هذا المجلد، لذا فإن المجلد النظيف الذي يحتوي فقط على الملفات ذات الصلة بهذا النطاق يبقي الاختلافات قصيرة ونتائج البحث قابلة للقراءة. إذا كانت ملفاتك الحية موجودة على خادم تملكه، انسخها إلى المجلد أولاً، أو اختر بيئة SSH للأوامر واحتفظ بالخطة في المجلد.
اطلب من الوكيل كتابة ملف routing-plan.txt يحتوي على توجيهاتك، وإعادة التوجيه الخاصة بك، ورمز الحالة المتوقع لكل منها. الخطة نص عادي، يمكنك تعديلها، وهي القائمة التي تقارن بها النتائج الحقيقية في النهاية. حدد توقعاً واحداً لكل توجيه وكل إعادة توجيه، بحيث لا يبقى أي قاعدة بدون تحقق. اجعل الملف قصيراً وسهل القراءة.
وافق على الاختلاف لكل قاعدة، ثم اسمح لـ Shell بتشغيل أمر اختبار التكوين قبل أي إعادة تحميل. في وضع Ask first يتوقف الوكيل قبل كل تغيير، وبطاقة الاختبار تظهر رمز الخروج الحقيقي والمخرج الكامل. لا تعيد التحميل قبل نجاح الاختبار، واحتفظ بنسخة الاحتياط من الملف السابق حتى تأكيد السلوك الجديد.
اطلب كل عنوان باستخدام أمر الطلب الخاص بك، اقرأ رمز الحالة ورأس Location، وقارنها بخطةك. إذا اختلفت قيمة واحدة، استعد النسخة الاحتياطية، أعد التحميل، وغير قاعدة واحدة مرة أخرى. كرر العملية حتى يطابق كل توقع في الخطة النتيجة، ثم احتفظ بالخطة النهائية كسجل لما يفترض أن يفعله التكوين.
.3 ملفاتroutes.confتم التحميلrouting-plan.txtتم الحفظyour request commandتم التوثيق# routing plan for my own domain
# one line per rule, written before any change
route 1: host app, path /api, goes to service api
route 2: host app, path /, goes to service web
route 3: host admin, path /, goes to service admin
redirect 1: old page to new page, code 301
redirect 2: www host to bare host, code 301
redirect 3: http to https, code 301
# status to expect after the change
expect 1: app path /api answers with a success code
expect 2: old page answers 301 and gives the new address
# keep the old configuration file as a backup
# end of routing planكل سطر هو قاعدة واحدة أو توقع واحد. تكتب الخطة أولاً لتعطيك شيئاً تقارن به رموز الحالة الحقيقية بعد كل تغيير، وسهل اكتشاف التغيير الذي يكسر التوقع. المضيفون والمسارات والخدمات هي أمثلة فقط؛ استبدلها ببياناتك الخاصة، واحتفظ بالخطة بجانب التكوين الذي تصفه. كلمة redirect مع رمز كافية للوكيل لمعرفة ما يجب كتابته.
يبدأ دليل الاستضافة الذاتية هذا بخادم وكيل عكسي أمام خدماتك بالبحث عن مكان وجود القواعد. يعرض list_dir مجلد العمل، ويعدد glob الملفات التي تبدو كقوائم توجيه، ويبحث grep فيها عن كلمتي route وredirect. النتيجة هي قائمة قصيرة بأسماء الملفات وأرقام الأسطر. لا يتغير شيء بعد. اختر الملف الذي يحتوي على قواعد نطاقك الخاص، افتحه باستخدام read_file، واطلب كل عنوان باستخدام أمر الطلب الخاص بك لتدوين رمز الحالة الحالي. راجع القائمة في وضع Plan only إذا أردت من الوكيل اقتراح ترتيب العمل أولاً، واحفظ الملاحظات بجانب خطة التوجيه بحيث تكون رموز الحالة الأولى مسجلة.
غير قاعدة واحدة في كل مرة، لأن الاختلاف الصغير سهل الحكم عليه. يقرأ edit_file الملف، ويقترح السطر الجديد ويعرض الاختلاف مع الأسطر المضافة والمزالة. عندما يطرح سؤال حول قاعدة إعادة توجيه فرعية، يظهر الوكيل القاعدة بجانب الكود الذي يجب أن يعيده، وأنت تقرر. في وضع Ask first لا يتم الحفظ حتى تقبل. في وضع Auto-run سيتم الحفظ فوراً، لذا استخدمه فقط في الملفات التي يمكنك استعادتها. احتفظ بالملف القديم كنسخة احتياطية، اقبل الاختلاف، وانتقل إلى الخطوة التالية. ارفض الاختلاف إذا فاجأك سطر واحد، واطلب تغييراً أصغر.
يمكن أن يؤدي إعادة التحميل بملف معطل إلى إسقاط موقع يعمل، لذا اختبر أولاً. يشغل Shell أمر اختبار التكوين الخاص بك، ويحكم على النجاح بواسطة رمز الخروج الحقيقي: الرمز الناجح يعني أن الملف تم تحليله، وأي شيء آخر يعني أنك تبقى على التكوين القديم. يتم توسيع البطاقة لتشمل المخرج الكامل، بما في ذلك رقم الخطأ. أصلحه باختلاف صغير آخر. بعد اختبار ناجح، أعد التحميل، واطلب العنوان مرة أخرى وقارن رموز الحالة HTTP للتنفيذ القديم والجديد. راجع المخرج بنفسك، لأن الاختبار الناجح يقول فقط أن التركيب صحيح وليس أن التوجيه صحيح.
تصنف رموز الحالة حسب رقمها الأول: 2xx نجاح، 3xx تحويل، 4xx خطأ العميل، 5xx خطأ الخادم. بالنسبة للوكيل، يعني 502 إجابة غير صالحة من الخادم الخلفي، و503 يعني أن الخدمة غير متاحة، و504 يعني أن الخادم الخلفي أجاب ببطء شديد، و404 يعني غير موجود. يجلب http_get صفحة واحدة من خدمتك الخاصة، ويظهر أمر الطلب الخاص بك العنوان الجديد لإعادة التوجيه. إذا اختلف رمز عن خطتك، استعد ملف النسخة الاحتياطية، أعد التحميل واختبر مرة أخرى. ثم غير الخطة أو القاعدة وكرر العملية، قاعدة واحدة في كل جولة. خطة توجيه قصيرة وملف نسخ احتياطي هما كل ما تحتاجه للتراجع.
