UsePythonVersion@0 - استخدام مهمة إصدار Python v0

استخدم هذه المهمة لتنزيل إصدار من Python أو تحديده للتشغيل على عامل، وإضافته اختياريا إلى PATH.

بناء الجملة

# Use Python version v0
# Use the specified version of Python from the tool cache, optionally adding it to the PATH.
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x' # string. Required. Version spec. Default: 3.x.
    #disableDownloadFromRegistry: false # boolean. Disable downloading releases from the GitHub registry. Default: false.
    #allowUnstable: false # boolean. Optional. Use when disableDownloadFromRegistry = false. Allow downloading unstable releases. Default: false.
    #githubToken: # string. Optional. Use when disableDownloadFromRegistry = false. GitHub token for GitHub Actions python registry. 
    #addToPath: true # boolean. Add to PATH. Default: true.
  # Advanced
    architecture: 'x64' # 'x86' | 'x64'. Required. Architecture. Default: x64.

الإدخالات

versionSpec - مواصفات الإصدار
string. مطلوب القيمة الافتراضية: 3.x.

يحدد نطاق الإصدار أو الإصدار الدقيق من إصدار Python لاستخدامه، باستخدام بناء جملة نطاق إصدار SemVer. تعرف على المزيد حول SemVer.

disableDownloadFromRegistry - تعطيل تنزيل الإصدارات من سجل GitHub
boolean. القيمة الافتراضية: false.

تعطيل تنزيل إصدارات Python المفقودة من سجل إجراءات Github. يجب أن يكون true هذا المنطقي فقط في حالة استخدام تثبيت محلي ل Python.

allowUnstable - السماح بتنزيل الإصدارات غير المستقرة
boolean. ‏‏اختياري. استخدم عندما disableDownloadFromRegistry = false. القيمة الافتراضية: false.

تنزيل إصدارات Python غير المستقرة من سجل إصدارات Gythub Actions Python إذا تم تعيينها إلى true.

githubToken - رمز GitHub المميز لسجل GitHub Actions python
string. ‏‏اختياري. استخدم عندما disableDownloadFromRegistry = false.

يحدد رمز GitHub المميز الذي يفرض حد الطلبات المجهولة في سجل إصدارات Gitub Actions python. قد يؤدي ترك هذا فارغا إلى فشل التنزيل. غير مطلوب إذا كنت تستخدم تثبيتا محليا ل Python.

addToPath - إضافة إلى PATH
boolean. القيمة الافتراضية: true.

إلحاق إصدار Python الذي تم استرداده إلى متغير بيئة PATH لجعله متاحا في المهام أو البرامج النصية اللاحقة دون استخدام متغير الإخراج.

architecture - الهندسه المعماريه
string. مطلوب القيم المسموح بها: x86، . x64 القيمة الافتراضية: x64.

يحدد البنية الهدف (x86 أو x64) لمترجم Python.

خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

تحدد هذه المهمة متغيرات الإخراج التالية، والتي يمكنك استهلاكها في خطوات انتقال البيانات من الخادم والوظائف والمراحل.

pythonLocation
دليل توزيع Python المثبت. استخدم هذا في المهام اللاحقة للوصول إلى تثبيت Python هذا.

الملاحظات

استخدم هذه المهمة لتنزيل إصدار من Python أو تحديده للتشغيل على عامل، وإضافته اختياريا إلى PATH.

المتطلبات الأساسية

• عامل مستضاف من Microsoft مع تثبيت إصدارات جنبا إلى جنب من Python، أو عامل مستضاف ذاتيا تم Agent.ToolsDirectory تكوينه (راجع الأسئلة المتداولة).
• تنزيل إصدارات python غير مدعوم على الوكلاء المستضافين ذاتيا.

ستفشل هذه المهمة إذا لم يتم العثور على إصدارات Python في Agent.ToolsDirectory. يمكن العثور على إصدارات Python المتوفرة على العوامل المستضافة من Microsoft هنا.

ملاحظة

تتوفر إصدارات x86 وx64 من Python على وكلاء Windows المستضافين من Microsoft، ولكن ليس على عوامل Linux أو macOS.

اعتبارا من الإصدار 0.150 من المهمة، مواصفات الإصدار ستقبل pypy2 أيضا أو pypy3.

اعتبارا من الإصدار 0.213.1 من المهمة، ستقبل pypy2.x مواصفات الإصدار أيضا أو pypy3.x.

إذا اكتملت المهمة بنجاح، فسيحتوي متغير إخراج المهمة على دليل تثبيت Python:

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

تتبع إصدارات Python المثبتة على صور Ubuntu وmacOS المستضافة من Microsoft بنية الارتباط للأنظمة الشبيهة ب Unix المحددة في PEP 394.

على سبيل المثال، python3.11 هو المترجم الفعلي ل Python 3.11.

python3 مرتبط بهذا المترجم، وهو python ارتباط symlink إلى هذا الارتباط المتماثل.

في صور Windows المستضافة من Microsoft، يكون المترجم هو فقط python.

بالنسبة للوكلاء المستضافين من Microsoft، يتم دعم x86 فقط على Windows. وذلك لأن Windows يمكنه تشغيل الملفات التنفيذية المحولة برمجيا لبنية x86 باستخدام النظام الفرعي WoW64. تقوم Ubuntu المستضافة وmacOS المستضافة بتشغيل أنظمة تشغيل 64 بت وتشغيل Python 64 بت فقط.

كيف يمكنني تكوين عامل مستضاف ذاتيا لاستخدام هذه المهمة؟

هام

تنزيل إصدارات python غير مدعوم على الوكلاء المستضافين ذاتيا. يمكنك استخدام الإصدارات المثبتة مسبقا فقط.

يجب إضافة إصدار Python المطلوب إلى ذاكرة التخزين المؤقت للأداة على العامل المستضاف ذاتيا حتى تتمكن المهمة من استخدامه. عادة، توجد ذاكرة التخزين المؤقت للأداة ضمن _work/_tool دليل العامل؛ بدلا من ذلك، يمكن تجاوز المسار بواسطة متغير AGENT_TOOLSDIRECTORYالبيئة . ضمن هذا الدليل، قم بإنشاء بنية الدليل التالية استنادا إلى إصدار Python الخاص بك:

$AGENT_TOOLSDIRECTORY/
    Python/
        {version number}/
            {platform}/
                {tool files}
            {platform}.complete

version number يجب أن يتبع تنسيق 1.2.3. platform يجب أن يكون x86 إما أو x64. tool files يجب أن تكون ملفات إصدار Python غير المضغوطة. {platform}.complete يجب أن يكون ملف 0 بايت يشبه x86.complete أو x64.complete يشير فقط إلى تثبيت الأداة في ذاكرة التخزين المؤقت بشكل صحيح.

كمثال كامل وملموس، إليك كيف سيبدو التنزيل المكتمل ل Python 3.11.4 للإصدار x64 في ذاكرة التخزين المؤقت للأداة:

$AGENT_TOOLSDIRECTORY/
    Python/
        3.11.4/
            x64/
                {tool files}
            x64.complete

تعرف على المزيد حول ذاكرة التخزين المؤقت للأداة.

لجعل البرامج النصية تعمل كما تعمل على الوكلاء المستضافين من Microsoft، استخدم بنية الارتباط من PEP 394 على الأنظمة الشبيهة ب Unix.

لاحظ أيضا أن إصدار ZIP القابل للتضمين من Python يتطلب تكوينا إضافيا للوحدات النمطية المثبتة، بما في ذلك pip. إذا كان ذلك ممكنا، نوصي باستخدام المثبت الكامل للحصول على pipتثبيت Python متوافق.

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	بلا
القدرات	لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	يتم تشغيل هذه المهمة باستخدام قيود الأمر التالية: مقيدة
متغيرات Settable	هذه المهمة لديها إذن لتعيين المتغيرات التالية: pythonLocation، PATH
إصدار الوكيل	2.182.1 أو أحدث
فئة المهمة	الأداة