ربط مستودع Azure DevOps

Orbit deploys from Azure Repos, the git hosting inside Azure DevOps. Connect once, pick a repository, and every push builds and goes live. This guide covers both ways to connect, selecting a…

Orbit ينشر من Azure Repos، استضافة git داخل Azure DevOps. اتصل مرة واحدة، واختر مستودعاً، وكل عملية push تبني وتنشر مباشرة. يغطي هذا الدليل كلا طريقتي الاتصال، واختيار مستودع، والشيئان اللذان يقوم بهما Azure بشكل مختلف عن موفري الخدمات الآخرين.

طريقتان للاتصال، ولماذا توجد طريقتان

يمكن لمؤسسات Azure DevOps حجب تطبيقات الطرف الثالث على مستوى المستأجر، وتفعل العديد من الشركات ذلك. إذا كانت مؤسستك كذلك، فإن زر تسجيل الدخول لن يعمل لك مهما فعلنا، لذا يوفر Orbit باباً ثانياً يعمل دائماً.

تسجيل الدخول باستخدام Microsoft. نقرة واحدة، لا شيء للنسخ واللصق. متاح عندما تسمح مؤسستك بتطبيقات الطرف الثالث.
رمز الوصول الشخصي. يعمل مع كل مؤسسة، بما فيها تلك التي تحجب التطبيقات. تلصق اسم مؤسسة ورمزاً تنشئه في Azure DevOps.

كلا الباب يصل إلى نفس الميزات تماماً. لا أحد منهما نسخة مختزلة من الآخر.

قبل أن تبدأ

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

الخيار أ: تسجيل الدخول باستخدام Microsoft

في KPanel، انقر على Orbit في الشريط الجانبي الأيسر.
انقر على مشروع جديد.
اترك الوضع مضبوطاً على استيراد مستودع Git.
اختر علامة تبويب Azure DevOps، ثم انقر على اتصل Azure DevOps.

يتم إرسالك إلى Microsoft لتسجيل الدخول والموافقة على الوصول. وافق وستعود إلى KPanel مع تحميل مستودعاتك.

إذا حجبت مؤسستك التطبيق، ترفضه Microsoft وتعرض KPanel السبب الذي أعطته. هذا ليس شيئاً يمكنك إعادة محاولته: استخدم رمز الوصول الشخصي أدناه، أو اطلب من المسؤول السماح بالتطبيق.

الخيار ب: رمز الوصول الشخصي

أنشئ الرمز في Azure DevOps أولاً.

في Azure DevOps، افتح إعدادات المستخدم، ثم رموز الوصول الشخصية، ثم رمز جديد.
اختر المؤسسة التي تريد النشر منها.
امنح هذه الثلاث نطاقات وليس أكثر من هذه الثلاثة:
- Code (Read) حتى يتمكن Orbit من إدراج مستودعاتك وتحميل commit الذي يقوم ببنائه.
- Code (Status) حتى تظهر نتيجة البناء على commit وعلى طلب السحب.
- Service Hooks (Read and write) حتى يتمكن Orbit من الاشتراك في عمليات push الخاصة بك.
انسخ الرمز. تعرضه Azure مرة واحدة فقط.

ثم في KPanel:

افتح Orbit، ثم مشروع جديد، ثم علامة تبويب Azure DevOps.
تحت الاتصال برمز وصول شخصي، أدخل اسم مؤسستك. هذا هو الجزء من عنوان مستودعك مباشرة بعد dev.azure.com، لذا بالنسبة https://dev.azure.com/contoso/web-platform/_git/storefront المؤسسة هي contoso.
الصق الرمز وانقر على اتصل Azure DevOps.

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

يتم تشفير رمزك قبل تخزينه ويُستخدم فقط مقابل المؤسسة التي سميتها.

اختيار مستودع

تظهر مستودعاتك كقائمة، مسماة organisation / project / repository. تحتوي مستودعات Azure على ثلاثة أجزاء وليس اثنين، لأن مشروعين في مؤسسة واحدة يمكن لكل منهما الاحتفاظ بمستودع بنفس الاسم.

انقر على تحديد بجانب الذي تريده، ثم أنهِ المشروع كالمعتاد: الاسم، والإطار، وإعدادات البناء، والمتغيرات البيئية.

إذا كان المستودع مفقوداً

تحقق من المؤسسة. رمز وصول شخصي ينتمي إلى مؤسسة واحدة فقط، لذا فإن مستودعاً في مؤسسة مختلفة لن يظهر. اتصل بتلك المؤسسة أيضاً.
تحقق من وصولك على المستودع نفسه في Azure DevOps.
تحقق من كون المستودع معطلاً في Azure. لا يسرد Orbit المستودعات المعطلة، لأنه لا يمكن بناؤها.

شيئان يقوم بهما Azure بشكل مختلف

هذه فروقات حقيقية وليست فجوات لم نصل إليها بعد، وكلاهما موضح هنا بدلاً من اكتشافه لاحقاً.

دليل جذر Monorepo لا يتخطى عمليات Push

على موفري الخدمات الآخرين، يقرأ Orbit قائمة الملفات التي غيرتها كل عملية push، ومشروع monorepo يمكن أن يتخطى بناءً عندما لا يتحرك شيء تحت جذره. Azure لا ترسل هذه القائمة. لذلك ينشئ Orbit على كل عملية push بدلاً من التخمين، لأن التخمين بالطريقة الأخرى قد يتخطى بصمت النشرات التي كنت تتوقعها.

إعداد جذرك لا يزال يقرر حيث يعمل البناء. لكنه لا يقوم بتصفية عمليات push التي تنشئ بالإضافة إلى ذلك.

طلبات السحب من الفروع لا تُبنى

ينشئ Orbit معاينة طلب سحب باستخدام متغيرات بيئة المعاينة لمشروعك. هذا آمن لطلب سحب من مستودعك الخاص وليس آمناً لواحد من فرع، وهو اقتراح من شخص لا علاقة له بحسابك.

على GitHub، يمكن لـ Orbit أن يقدم معاينة فرع لأن GitHub ينشر commit المقترح داخل مستودعك الخاص، لذا لا نضطر أبداً للمصادقة ضد نسخة المساهم. Azure لا تنشر معادلاً، لذا يرفض Orbit طلبات سحب الفروع ويقول ذلك على commit بدلاً من ترك معاينة قد لا تظهر أبداً.

طلبات السحب من الفروع داخل مستودعك الخاص تبني بشكل طبيعي.

ما يحدث بعد ذلك

ادفع إلى فرع الإنتاج الخاص بك و Orbit ينشئ وينشر. يتم نشر نتيجة البناء مرة أخرى على commit في Azure DevOps، لذا تظهر على commit وعلى أي طلب سحب ينتمي إليه commit، وسياسات فرعك يمكنها أن تطلبه.