تمرين - إعداد GitHub Copilot للعمل مع تعليمة Visual Studio برمجية
في هذا التمرين، ستفتح مساحة تعليمات برمجية لمستودع واجهة برمجة تطبيقات الويب Python المتوفر. يمكنك تجربة هذه البيئة دون إنشاء المستودع الخاص بك أولا.
إعداد بيئة
أولا، قم بتشغيل بيئة Codespaces، والتي تأتي مكونة مسبقا مع ملحق GitHub Copilot. راجع نوع الجهاز والمدفع والبدل المتبقي وعناصر التحكم في الإنفاق قبل إنشاء مساحة التعليمات البرمجية.
هام
تتضمن الحسابات الشخصية GitHub المجانية 120 ساعة أساسية من Codespaces و15 غيغابايت شهريا من التخزين كل شهر. على جهاز ثنائي النواة، 120 ساعة أساسية هي 60 ساعة من وقت التشغيل، بشرط عدم استخدام أي من هذه البدلات في مكان آخر. حسابات GitHub Pro الشخصية لها بدل مختلف. لا تتضمن خطط المؤسسة والمؤسسة حصة مجانية ل Codespaces.
تصف وثائق فوترة Codespaces البدلات والرسوم الحالية. بعد مراجعة إعدادات حسابك، قم بإنشاء البيئة:
- افتح مساحة التعليمات البرمجية مع البيئة التي تم تكوينها مسبقا في المستعرض الخاص بك.
- في صفحة Create codespace ، راجع إعدادات التكوين، ثم حدد Create new codespace.
- انتظر حتى ينتهي إعداد الحاوية وتثبيت الملحق. قد تستغرق هذه العملية بضع دقائق.
تتم التدريبات المتبقية في حاوية التطوير هذه. استخدم بيئة Python التي تم تكوينها بالفعل للمشروع بدلا من إنشاء بيئة ثانية.
يفتح ارتباط التشغيل مساحة تعليمات برمجية مقترنة بالمستودع المتوفر. إذا كان لديك حق الوصول للقراءة والإذن بالتشعب، يمكن ل Codespaces إنشاء نسخة المستودع أو ربطها ضمن حسابك عند تثبيت فرع جديد أو دفعه. اتبع مطالبة التتشعب إذا ظهر أحدها. التثبيت المخزن فقط في مساحة التعليمات البرمجية ليس نسخة احتياطية على GitHub.
تمكين GitHub Copilot
سجل الدخول إلى VS Code باستخدام حساب GitHub الذي يحتوي على حق الوصول Copilot. إذا لم يكن لديك حق الوصول بعد، فمكن Copilot مجانا أو استخدم خطة مؤهلة مقدمة من مؤسستك. حدد دردشة في شريط العنوان، ثم افتح الدردشة، وتأكد من أنه يمكنك إرسال طلب قبل المتابعة.
لا تحتاج إلى شراء خطة Copilot مدفوعة فقط لبدء هذا التمرين. يتضمن Copilot المجاني استخداما محدودا، بما في ذلك 2000 إكمال شهري للتعليمات البرمجية وبدل أرصدة الذكاء الاصطناعي. تحقق من البدل الحالي قبل البدء. يعتمد توفر الميزة واستخدامها على نهج الحساب والمؤسسة. راجع Copilot الخطط للحصول على التفاصيل الحالية.
يمكن للطلاب المصدقين تنشيط Copilot Student من خلال GitHub Education. قد يتأهل المعلمون المصدقون والمشرفون المؤهلون للمشاريع الشائعة مفتوحة المصدر Copilot Pro دون أي تكلفة. تختلف متطلبات الأهلية والتنشيط.
تشغيل واجهة برمجة تطبيقات الويب Python
تثبت الحاوية متطلبات المشروع في بيئة Python التي تم تكوينها. عند إرفاقه بمساحة التعليمات البرمجية، يقوم أمر بدء التشغيل المكون بتشغيل Uvicorn على المنفذ 8000 مع إعادة التحميل التلقائي.
- تحقق من المحطة الطرفية لبدء التشغيل لبدء تشغيل التطبيق بنجاح. إذا ظهر خطأ، فحله قبل المتابعة. لا يثبت إدخال المنفذ وحده أن التطبيق قيد التشغيل.
- افتح طريقة عرض المنافذ وحدد موقع المنفذ 8000، المسمى Application.
- افتح هذا المنفذ في المستعرض الخاص بك واحتفظ برؤيته خاصة. يقوم جذر التطبيق بإعادة التوجيه إلى وثائق واجهة برمجة التطبيقات التفاعلية الخاصة به في
/docs.
عادة ما يكون الخادم قيد التشغيل بالفعل. لا تبدأ نسخة ثانية على المنفذ 8000. تؤدي تغييرات Python المحفوظة إلى إعادة التحميل المكونة. إذا كنت بحاجة إلى إعادة تشغيل الخادم يدويا، فقم بإيقاف العملية الحالية باستخدام Ctrl+C في المحطة الطرفية التي تقوم بتشغيله قبل بدء نسخة أخرى.
بعد توقف الخادم السابق، قم بتشغيل أمر الاسترداد هذا من جذر المستودع في Codespace:
/home/vscode/venv/bin/python -m uvicorn main:app --host 0.0.0.0 --port 8000 --reload
استخدم عنوان URL للتطبيق الذي تمت إعادة توجيهه في المستعرض الخاص بك، وليس على الكمبيوتر localhost:8000الخاص بك. لمزيد من المعلومات، راجع إعادة توجيه المنافذ في مساحة التعليمات البرمجية.