أمر الاقتران

أمر الاقتران هو مسار Give me a 1-liner في معالج Add Node. تنسخ سطراً واحداً من Techstack وتلصقه في طرفية خادمك، فيتصل الخادم بنفسه. لا تحتاج إلى إدخال تفاصيل SSH في Techstack.

​

ماذا يفعل الأمر

ينزّل الأمر مثبّت Techstack من Techstack الخاص بك ويشغّله برمز اقتران شخصي قصير الأمد. على الخادم، يقوم المثبّت بما يلي:

1. يكتشف المنصة ويثبّت Guard الخاص بـ Techstack، وهو وكيل صغير يبلّغ عن حالة الخادم؛
2. يثبّت وقت تشغيل StackKits المثبّت الذي يحتاجه النشر؛
3. يستبدل رمز الاقتران، ما يربط هذا الخادم بمختبرك المنزلي؛
4. يثبّت Docker باستخدام apt-get عندما لا يوجد وقت تشغيل حاويات صالح؛
5. يثبّت خدمة النظام techstack-agent ويشغّلها، فيبقى الـ Guard يعمل بعد إعادة التشغيل.

يتحدث الـ Guard مع Techstack عبر اتصال HTTPS صادر فقط. يرسل نبضة وجرداً مقيساً كل 30 ثانية تقريباً. ولا تفتح منفذاً وارداً على الخادم من أجله. الرمز يعمل مرة واحدة. يخزّن Techstack تجزئة بيانات الاعتماد التي يستلمها الخادم فقط، ولا يُحفظ الأمر في تقارير المهام.

​

قبل التشغيل

• خادم Linux مع systemd. Ubuntu هو النظام القياسي؛ راجع إضافة عقدة.
• صلاحيات المسؤول. شغّل الأمر بصفة root أو بمستخدم يستطيع استخدام sudo. يكتب المثبّت ملفات النظام ويثبّت خدمة.
• curl على الخادم. يستخدمه الأمر لتنزيل المثبّت.
• الخادم يستطيع الوصول إلى Techstack. تعرض صفحة التقدم الحقل Techstack URL reachable from the server. يجب أن يُفتح العنوان في هذا الحقل من الخادم، وليس من حاسوبك فقط. مع Windows Alpha، يصل الخادم إلى حاسوب Windows على منفذ TCP 5264 في شبكتك المحلية، لذا أبقِ عميل Windows يعمل أثناء الاقتران.
• أمر جديد. ينتهي رمز الاقتران بعد 15 دقيقة من إنشاء Techstack له.

​

تشغيل الأمر

1. أنهِ معالج Add Node. يفتح Techstack صفحة التقدم للعقدة الجديدة، وتعرض Not connected yet.
2. تحقق من الحقل Techstack URL reachable from the server وصححه إذا كان الخادم يستخدم عنواناً مختلفاً للوصول إلى Techstack.
3. اختر Copy pairing command.
4. افتح طرفية على الخادم، مباشرة أو عبر SSH، والصق الأمر ثم اضغط Enter. لا تغيّر الأمر. فهو يحتوي رمزك الشخصي.
5. انتظر انتهاء المثبّت. فهو يطبع كل خطوة.

إذا عرضت الصفحة This pairing token has expired، فاختر Generate new command وشغّل الأمر الجديد بدلاً منه. لم يعد القديم يعمل.

​

عندما تتصل العقدة

عندما يرسل الـ Guard أول نبضة، يغيّر Techstack العقدة من Not connected yet إلى متصلة. ثم تتابع صفحة التقدم نشر StackKit لهذه العقدة. ويمكنك إغلاق الطرفية. للتحقق من الـ Guard على الخادم لاحقاً:

• يعرض sudo systemctl status techstack-agent ما إذا كانت الخدمة تعمل.
• يتابع sudo journalctl -u techstack-agent -f سجلها.

تظهر العقدة الآن في مختبرك المنزلي مع حالتها. ولا يعتمد مكان الوصول إلى خدماتها على مكان وجود الخادم: يمكن للأجهزة المحلية والخوادم المستأجرة استخدام نطاقك الخاص أو عنوان *.kombify.me. راجع kombify.me.