JavaToolInstaller@0 - مهمة v0 لمثبت أداة Java

استخدم هذه المهمة للحصول على إصدار معين من Java من Azure blob الذي يوفره المستخدم أو ذاكرة التخزين المؤقت للأداة وتعيين JAVA_HOME.

بناء الجملة

# Java tool installer v0
# Acquire a specific version of Java from a user-supplied Azure blob or the tool cache and sets JAVA_HOME.
- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8' # string. Required. JDK version. Default: 8.
    jdkArchitectureOption: # 'x64' | 'x86'. Required. JDK architecture. 
    jdkSourceOption: # 'AzureStorage' | 'LocalDirectory' | 'PreInstalled'. Required. JDK source. 
    #jdkFile: # string. Required when jdkSourceOption == LocalDirectory. JDK file. 
    #azureResourceManagerEndpoint: # string. Required when jdkSourceOption == AzureStorage. Azure subscription. 
    #azureStorageAccountName: # string. Required when jdkSourceOption == AzureStorage. Storage account name. 
    #azureContainerName: # string. Required when jdkSourceOption == AzureStorage. Container name. 
    #azureCommonVirtualFile: # string. Required when jdkSourceOption == AzureStorage. Common virtual path. 
    #jdkDestinationDirectory: # string. Required when jdkSourceOption != PreInstalled. Destination directory. 
    #azureResourceGroupName: # string. Optional. Use when jdkSourceOption == AzureStorage. Resource Group name. 
    #cleanDestinationDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Clean destination directory. Default: true.
    #createExtractDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Create directory for extracting. Default: true.
# Java tool installer v0
# Acquire a specific version of Java from a user-supplied Azure blob or the tool cache and sets JAVA_HOME.
- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8' # string. Required. JDK version. Default: 8.
    jdkArchitectureOption: # 'x64' | 'x86'. Required. JDK architecture. 
    jdkSourceOption: # 'AzureStorage' | 'LocalDirectory' | 'PreInstalled'. Required. JDK source. 
    #jdkFile: # string. Required when jdkSourceOption == LocalDirectory. JDK file. 
    #azureResourceManagerEndpoint: # string. Required when jdkSourceOption == AzureStorage. Azure subscription. 
    #azureStorageAccountName: # string. Required when jdkSourceOption == AzureStorage. Storage account name. 
    #azureContainerName: # string. Required when jdkSourceOption == AzureStorage. Container name. 
    #azureCommonVirtualFile: # string. Required when jdkSourceOption == AzureStorage. Common virtual path. 
    #jdkDestinationDirectory: # string. Required when jdkSourceOption != PreInstalled. Destination directory. 
    #cleanDestinationDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Clean destination directory. Default: true.
    #createExtractDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Create directory for extracting. Default: true.
# Java tool installer v0
# Acquire a specific version of Java from a user-supplied Azure blob or the tool cache and sets JAVA_HOME.
- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8' # string. Required. JDK version. Default: 8.
    jdkArchitectureOption: # 'x64' | 'x86'. Required. JDK architecture. 
    jdkSourceOption: # 'AzureStorage' | 'LocalDirectory' | 'PreInstalled'. Required. JDK source. 
    #jdkFile: # string. Required when jdkSourceOption == LocalDirectory. JDK file. 
    #azureResourceManagerEndpoint: # string. Required when jdkSourceOption == AzureStorage. Azure subscription. 
    #azureStorageAccountName: # string. Required when jdkSourceOption == AzureStorage. Storage account name. 
    #azureContainerName: # string. Required when jdkSourceOption == AzureStorage. Container name. 
    #azureCommonVirtualFile: # string. Required when jdkSourceOption == AzureStorage. Common virtual path. 
    #jdkDestinationDirectory: # string. Required when jdkSourceOption != PreInstalled. Destination directory. 
    #cleanDestinationDirectory: true # boolean. Optional. Use when jdkSourceOption != PreInstalled. Clean destination directory. Default: true.
# Java tool installer v0
# Acquire a specific version of Java from a user-supplied Azure blob or the tool cache and sets JAVA_HOME.
- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8' # string. Required. JDK version. Default: 8.
    jdkArchitectureOption: # 'x64' | 'x86'. Required. JDK architecture. 
    jdkSourceOption: # 'AzureStorage' | 'LocalDirectory'. Required. JDK source. 
    #jdkFile: # string. Required when jdkSourceOption == LocalDirectory. JDK file. 
    #azureResourceManagerEndpoint: # string. Required when jdkSourceOption == AzureStorage. Azure subscription. 
    #azureStorageAccountName: # string. Required when jdkSourceOption == AzureStorage. Storage account name. 
    #azureContainerName: # string. Required when jdkSourceOption == AzureStorage. Container name. 
    #azureCommonVirtualFile: # string. Required when jdkSourceOption == AzureStorage. Common virtual path. 
    jdkDestinationDirectory: # string. Required. Destination directory. 
    #cleanDestinationDirectory: true # boolean. Clean destination directory. Default: true.
# Java Tool Installer v0
# Acquires a specific version of Java from a user supplied Azure blob or the tools cache and sets JAVA_HOME. Use this task to change the version of Java used in Java tasks.
- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8' # string. Required. JDK version. Default: 8.
    jdkArchitectureOption: # 'x64' | 'x86'. Required. JDK architecture. 
    jdkSourceOption: # 'AzureStorage' | 'LocalDirectory'. Required. JDK source. 
    #jdkFile: # string. Required when jdkSourceOption == LocalDirectory. JDK file. 
    #azureResourceManagerEndpoint: # string. Required when jdkSourceOption == AzureStorage. Azure subscription. 
    #azureStorageAccountName: # string. Required when jdkSourceOption == AzureStorage. Storage account name. 
    #azureContainerName: # string. Required when jdkSourceOption == AzureStorage. Container name. 
    #azureCommonVirtualFile: # string. Required when jdkSourceOption == AzureStorage. Common virtual path. 
    jdkDestinationDirectory: # string. Required. Destination directory. 
    #cleanDestinationDirectory: true # boolean. Clean destination directory. Default: true.

الإدخالات

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

يحدد إصدار JDK لتوفيره على المسار. استخدم إصدار رقم كامل، مثل 10.


jdkArchitectureOption - بنية JDK
string. مطلوب القيم المسموح بها: x64، . x86

يحدد بنية (x86، x64) ل JDK.


jdkSourceOption - مصدر JDK
string. مطلوب القيم المسموح بها: AzureStorage (Azure Storage)، LocalDirectory (الدليل المحلي)، PreInstalled (مثبت مسبقا).

يحدد مصدر JDK المضغوط. يمكن أن يكون المصدر تخزين Azure blob أو دليلا محليا على العامل أو مستودع المصدر، أو يمكنك استخدام الإصدار المثبت مسبقا من Java (متوفر للوكلاء المستضافين من Microsoft). يرجى الاطلاع على المثال أدناه حول كيفية استخدام الإصدار المثبت مسبقا من Java.


jdkSourceOption - مصدر JDK
string. مطلوب القيم المسموح بها: AzureStorage (Azure Storage)، LocalDirectory (الدليل المحلي).

يحدد مصدر JDK المضغوط. يمكن أن يكون المصدر تخزين Azure blob أو دليلا محليا على العامل أو مستودع المصدر، أو يمكنك استخدام الإصدار المثبت مسبقا من Java (متوفر للوكلاء المستضافين من Microsoft). يرجى الاطلاع على المثال أدناه حول كيفية استخدام الإصدار المثبت مسبقا من Java.


jdkFile - ملف JDK
string. مطلوب عند jdkSourceOption == LocalDirectory.

يحدد المسار إلى ملف أرشيف JDK الذي يحتوي على JDK المضغوط. يمكن أن يكون المسار في مستودع المصدر أو مسار محلي على العامل. يجب أن يكون الملف أرشيفا (.zip و.tar.gz و.7z) يحتوي على مجلد الحاوية على مستوى الجذر أو داخل دليل واحد. يدعم MacOS ملفات .pkg و.dmg التي تحتوي على ملف .pkg واحد فقط بداخلها.


azureResourceManagerEndpoint - اشتراك Azure
string. مطلوب عند jdkSourceOption == AzureStorage.

يحدد اشتراك Azure Resource Manager ل JDK.


azureStorageAccountName - اسم حساب التخزين
string. مطلوب عند jdkSourceOption == AzureStorage.

يحدد حسابات تخزين Azure Classic أو Resource Manager. حدد اسم حساب التخزين الذي يوجد فيه JDK.


azureContainerName - اسم الحاوية
string. مطلوب عند jdkSourceOption == AzureStorage.

يحدد اسم الحاوية في حساب التخزين حيث يوجد JDK.


azureCommonVirtualFile - المسار الظاهري الشائع
string. مطلوب عند jdkSourceOption == AzureStorage.

يحدد المسار إلى JDK داخل حاوية تخزين Azure.


jdkDestinationDirectory - دليل الوجهة
string. مطلوب عند jdkSourceOption != PreInstalled.

يحدد الدليل الوجهة حيث يجب استخراج JDK. على Linux وWindows، يتم استخدام هذا كدليل الوجهة لتثبيت JDK. على macOS، يتم استخدام هذا الدليل كمجلد مؤقت لاستخراج .dmg's لأن macOS لا يدعم تثبيت JDK إلى دليل معين.


jdkDestinationDirectory - دليل الوجهة
string. مطلوب

يحدد الدليل الوجهة حيث يجب استخراج JDK. على Linux وWindows، يتم استخدام هذا كدليل الوجهة لتثبيت JDK. على macOS، يتم استخدام هذا الدليل كمجلد مؤقت لاستخراج .dmg's لأن macOS لا يدعم تثبيت JDK إلى دليل معين.


azureResourceGroupName - اسم مجموعة الموارد
string. ‏‏اختياري. استخدم عندما jdkSourceOption == AzureStorage.

اسم مجموعة الموارد لحساب التخزين.


cleanDestinationDirectory - تنظيف دليل الوجهة
boolean. ‏‏اختياري. استخدم عندما jdkSourceOption != PreInstalled. القيمة الافتراضية: true.

يحدد خيار تنظيف الدليل الوجهة قبل استخراج JDK فيه.


cleanDestinationDirectory - تنظيف دليل الوجهة
boolean. القيمة الافتراضية: true.

يحدد خيار تنظيف الدليل الوجهة قبل استخراج JDK فيه.


createExtractDirectory - إنشاء دليل لاستخراج
boolean. ‏‏اختياري. استخدم عندما jdkSourceOption != PreInstalled. القيمة الافتراضية: true.

بشكل افتراضي، تنشئ المهمة دليلا مشابها JAVA_HOME_8_X64_OpenJDK_zip لاستخراج JDK. يعطل هذا الخيار إنشاء هذا المجلد، وإذا تم تعيينه إلى false، فإن JDK موجود في جذر بدلا من jdkDestinationDirectory ذلك.


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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة للحصول على إصدار معين من Java من Azure blob الذي يوفره المستخدم، أو موقع في المصدر أو على العامل، أو ذاكرة التخزين المؤقت للأدوات. تعين المهمة أيضا JAVA_HOME متغير البيئة. استخدم هذه المهمة لتغيير إصدار Java المستخدم في مهام Java.

ملاحظة

لتشغيل مهمة مثبت أداة Java على macOS، يلزم أن يكون لدى المستخدم الذي يعمل العامل بموجبه إذن لتنفيذ أمر sudo دون كلمة مرور. يمكنك اتباع الخطوات التالية لتمكين هذا الإذن:

  1. قم بتشغيل الأمر sudo visudo . يفتح ملف sudoers للتحرير.
  2. انتقل إلى أسفل الملف وأضف السطر التالي: user ALL=NOPASSWD: /usr/sbin/installer (استبدل المستخدم بالاسم المستعار الفعلي للمستخدم).
  3. حفظ وإغلاق الملف.

أمثلة

فيما يلي مثال على الحصول على ملف الأرشيف من دليل محلي على Linux. يجب أن يكون الملف أرشيفا (.zip و.gz) للدليلJAVA_HOME، بحيث يتضمن binالدلائل و libincludeو jreوما إلى ذلك.

  - task: JavaToolInstaller@0
    inputs:
      versionSpec: "11"
      jdkArchitectureOption: x64
      jdkSourceOption: LocalDirectory
      jdkFile: "/builds/openjdk-11.0.2_linux-x64_bin.tar.gz"
      jdkDestinationDirectory: "/builds/binaries/externals"
      cleanDestinationDirectory: true

فيما يلي مثال على تنزيل ملف الأرشيف من Azure Storage. يجب أن يكون الملف أرشيفا (.zip و.gz) للدليلJAVA_HOME، بحيث يتضمن binالدلائل و libincludeو jreوما إلى ذلك.

- task: JavaToolInstaller@0
  inputs:
    versionSpec: '6'
    jdkArchitectureOption: 'x64'
    jdkSourceOption: AzureStorage
    azureResourceManagerEndpoint: myARMServiceConnection
    azureStorageAccountName: myAzureStorageAccountName
    azureContainerName: myAzureStorageContainerName
    azureCommonVirtualFile: 'jdk1.6.0_45.zip'
    jdkDestinationDirectory: '$(agent.toolsDirectory)/jdk6'
    cleanDestinationDirectory: false

فيما يلي مثال على استخدام ميزة "مثبتة مسبقا". تسمح لك هذه الميزة باستخدام إصدارات Java المثبتة مسبقا على العامل المستضاف من Microsoft. يمكنك العثور على الإصدارات المتوفرة المثبتة مسبقا من Java في عمود البرنامج المضمن في جدول العوامل المستضافة.

- task: JavaToolInstaller@0
  inputs:
    versionSpec: '8'
    jdkArchitectureOption: 'x64'
    jdkSourceOption: 'PreInstalled'

المتطلبات

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

راجع أيضًا

للحصول على شرح لمثبتات الأدوات والأمثلة، راجع مثبتات الأدوات.