InstallAppleCertificate@2. Установка задачи сертификата Apple версии 2
Используйте эту задачу для установки сертификата Apple, необходимого для сборки агента macOS. Эту задачу можно использовать для установки сертификата Apple, хранящегося в виде безопасного файла на сервере.
Синтаксис
# 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.
Входные данные
сертификата 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. Дополнительные сведения о Open Radar.
opensslPkcsArgs
-
аргументы OpenSSL для PKCS12
string
.
Аргументы для извлечения сведений о сертификате с помощью opensl.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Эта задача определяет следующие выходные переменные, которые можно использовать в подчиненных шагах, заданиях и этапах.
signingIdentity
Указывает разрешенные Common Name
субъекта в сертификате подписи. Либо предоставляется в качестве входного или синтаксического анализа из файла сертификата P12.
keychainPath
Указывает путь к файлу цепочки ключей с сертификатом.
Замечания
Используйте эту задачу для установки сертификата Apple, необходимого для сборки агента macOS. Эту задачу можно использовать для установки сертификата Apple, хранящегося в виде безопасного файла на сервере.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
требования | Локальные агенты должны иметь возможности, которые соответствуют следующим требованиям требуют выполнения заданий, использующих эту задачу: xcode |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Эта задача выполняется с помощью следующих ограничений команд : ограничено. |
переменные settable | Эта задача имеет разрешение на задать следующие переменные: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN |
Версия агента | 2.182.1 или более поздней версии |
Категория задач | Полезность |
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка, классический выпуск |
Выполняется в | Агент, DeploymentGroup |
требования | Локальные агенты должны иметь возможности, которые соответствуют следующим требованиям требуют выполнения заданий, использующих эту задачу: xcode |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Любое |
переменные settable | Любое |
Версия агента | 2.116.0 или более поздней версии |
Категория задач | Полезность |