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 или более поздней версии |
Категория задач | Служебная программа |