InstallAppleCertificate@2 - تثبيت مهمة شهادة Apple v2

استخدم هذه المهمة لتثبيت شهادة Apple المطلوبة للبناء على عامل macOS. يمكنك استخدام هذه المهمة لتثبيت شهادة Apple المخزنة كملف آمن على الخادم.

قم بتثبيت شهادة Apple المطلوبة للبناء على عامل macOS.

بناء الجملة

# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password. 
    #customKeychainPath: # string. Required when keychain = custom. Custom keychain path. 
    #deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain. 
    #deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain. 
    #signingIdentity: # string. Certificate signing identity. 
    #setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key. 
    #opensslPkcsArgs: # string. OpenSSL arguments for PKCS12.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password. 
    #customKeychainPath: # string. Required when keychain = custom. Custom keychain path. 
    #deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain. 
    #deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain. 
    #signingIdentity: # string. Certificate signing identity. 
    #setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password. 
    #customKeychainPath: # string. Required when keychain = custom. Custom keychain path. 
    #deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain. 
    #deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain. 
    #signingIdentity: # string. Certificate signing identity.
# Install Apple Certificate v2
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@2
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password. 
    #customKeychainPath: # string. Required when keychain = custom. Custom keychain path. 
    #deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain. 
    #deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain. 
    #signingIdentity: # string. Certificate signing identity.

الإدخالات

certSecureFile - الشهادة (P12)
string. مطلوب

يحدد الشهادة (.p12) التي تم تحميلها إلى Secure Files لتثبيتها على عامل macOS.


certPwd - كلمة مرور الشهادة (P12)
string.

يحدد كلمة المرور إلى شهادة Apple (.p12). استخدم متغير بناء جديدا مع تمكين تأمينه على Variables علامة التبويب لتشفير هذه القيمة.


keychain - المفاتيح
string. مطلوب القيم المسموح بها: default (سلسلة المفاتيح الافتراضية)، temp (سلسلة المفاتيح المؤقتة)، custom (سلسلة المفاتيح المخصصة). القيمة الافتراضية: temp.

يحدد سلسلة المفاتيح التي سيتم تثبيت شهادة Apple فيها. بالنسبة للإنشاءات المستضافة من Microsoft، استخدم Temporary Keychain. سيتم دائما حذف سلسلة مفاتيح مؤقتة بعد اكتمال الإنشاء أو الإصدار.


keychainPassword - كلمة مرور سلسلة المفاتيح
string. مطلوب عند keychain = custom || keychain = default.

يحدد كلمة المرور لإلغاء تأمين سلسلة المفاتيح. استخدم متغير بناء جديدا مع تمكين تأمينه على Variables علامة التبويب لتشفير هذه القيمة. يتم إنشاء كلمة مرور لسلسلة المفاتيح المؤقتة إذا لم يتم تحديدها.


customKeychainPath - مسار سلسلة المفاتيح المخصصة
string. مطلوب عند keychain = custom.

يحدد المسار الكامل إلى ملف سلسلة مفاتيح مخصص. سيتم إنشاء سلسلة المفاتيح إذا لم تكن موجودة بالفعل.


deleteCert - حذف الشهادة من سلسلة المفاتيح
boolean. ‏‏اختياري. استخدم عندما keychain = custom || keychain = default.

يحدد الشهادة المراد حذفها من سلسلة المفاتيح بعد اكتمال الإنشاء أو الإصدار.


deleteCustomKeychain - حذف سلسلة المفاتيح المخصصة
boolean. ‏‏اختياري. استخدم عندما keychain = custom.

يحدد سلسلة المفاتيح المخصصة لحذفها من العامل بعد اكتمال الإنشاء أو الإصدار.


signingIdentity - هوية توقيع الشهادة
string.

Common Name يحدد الموضوع في شهادة التوقيع. سيحاول تحليل Common Name إذا ترك هذا فارغا.


setUpPartitionIdACLForPrivateKey - إعداد partition_id ACL للمفتاح الخاص المستورد
boolean.

إذا true، قم بتعيين قائمة التحكم بالوصول partition_id للمفتاح الخاص المستورد بحيث codesign لا يطالب باستخدام المفتاح للتوقيع. هذا ليس ضروريا لسلسلة المفاتيح المؤقتة على MacOS High Sierra. Mer informasjon عن الرادار المفتوح.


opensslPkcsArgs - وسيطات OpenSSL ل PKCS12
string.

وسيطات لاستخراج معلومات الشهادة باستخدام openssl.


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

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

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

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

signingIdentity
يحدد الموضوع الذي تم حله Common Name في شهادة التوقيع. إما تم توفيره كإدخال أو تم تحليله من ملف شهادة P12.

keychainPath
يحدد مسار ملف سلسلة المفاتيح مع الشهادة.

الملاحظات

استخدم هذه المهمة لتثبيت شهادة Apple المطلوبة للبناء على عامل macOS. يمكنك استخدام هذه المهمة لتثبيت شهادة Apple المخزنة كملف آمن على الخادم.

المتطلبات

المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب يجب أن يكون لدى الوكلاء المستضافين ذاتيا قدرات تطابق المتطلبات التالية لتشغيل المهام التي تستخدم هذه المهمة: xcode
القدرات لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر يتم تشغيل هذه المهمة باستخدام قيود الأمر التالية: مقيدة
متغيرات Settable هذه المهمة لديها إذن لتعيين المتغيرات التالية: signingIdentity، keychainPassword، keychainPath، APPLE_CERTIFICATE_SIGNING_IDENTITY، APPLE_CERTIFICATE_KEYCHAIN
إصدار الوكيل 2.182.1 أو أحدث
فئة المهمة الأداة المساعدة
المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب يجب أن يكون لدى الوكلاء المستضافين ذاتيا قدرات تطابق المتطلبات التالية لتشغيل المهام التي تستخدم هذه المهمة: xcode
القدرات لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 2.116.0 أو أحدث
فئة المهمة الأداة المساعدة