Поделиться через


InstallAppleCertificate@2 . Установка сертификата Apple версии 2

Используйте эту задачу, чтобы установить сертификат 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. Для сборок, размещенных у Майкрософт, используйте 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 задает список ACL для импортированного закрытого ключа, codesign чтобы не запрашивать использование ключа для подписывания. Это не требуется для временных цепочек ключей в MacOS High Sierra. Узнайте больше об Открытом радаре.


opensslPkcsArgs - Аргументы OpenSSL для PKCS12
string.

Аргументы для извлечения сведений о сертификате с помощью openssl.


Параметры управления задачами

Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задачи.

Выходные переменные

Эта задача определяет следующие выходные переменные, которые можно использовать в последующих шагах, заданиях и этапах.

signingIdentity
Указывает разрешение Common Name субъекта в сертификате подписи. Предоставляется в качестве входных данных или анализируется из файла сертификата P12.

keychainPath
Указывает путь к файлу связка ключей с сертификатом.

Комментарии

Используйте эту задачу, чтобы установить сертификат Apple, необходимый для сборки на агенте macOS. Эту задачу можно использовать для установки сертификата Apple, хранящегося на сервере в качестве защищенного файла .

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: xcode
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Эта задача выполняется с использованием следующих ограничений команд: restricted
Устанавливаемые переменные Эта задача имеет разрешение на задание следующих переменных: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN
Версия агента 2.182.1 или более поздней версии
Категория задач Служебная программа
Требование Описание
Типы конвейеров YAML, классическая сборка, классический выпуск
Выполняется в Агент, DeploymentGroup
Требования Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: xcode
Capabilities Эта задача не удовлетворяет требованиям для последующих задач в задании.
Ограничения команд Любой
Устанавливаемые переменные Любой
Версия агента 2.116.0 или более поздней версии
Категория задач Служебная программа