InstallAppleCertificate@2: tarea Instalar el certificado de Apple v2

Use esta tarea para instalar el certificado de Apple necesario para compilar en un agente de macOS. Puede usar esta tarea para instalar un certificado de Apple que se almacena como archivo seguro en el servidor.

Sintaxis

# 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.

Entradas

certificado de certSecureFile - (P12)
string. Obligatorio.

Especifica el certificado (.p12) que se cargó en Secure Files para instalarlo en el agente de macOS.

de contraseña de certificado de certPwd - (P12)
string.

Especifica la contraseña para el certificado de Apple (.p12). Use una nueva variable de compilación con su bloqueo habilitado en la pestaña Variables para cifrar este valor.

de cadena de claves de keychain -
string. Obligatorio. Valores permitidos: default (cadena de claves predeterminada), temp (cadena de claves temporal), custom (cadena de claves personalizada). Valor predeterminado: temp.

Especifica la cadena de claves en la que se va a instalar el certificado de Apple. Para las compilaciones hospedadas por Microsoft, use Temporary Keychain. Una cadena de claves temporal siempre se eliminará una vez completada la compilación o la versión.

keychainPassword - contraseña de cadena de claves
string. Obligatorio cuando keychain = custom || keychain = default.

Especifica la contraseña para desbloquear la cadena de claves. Use una nueva variable de compilación con su bloqueo habilitado en la pestaña Variables para cifrar este valor. Si no se especifica, se genera una contraseña para la cadena de claves temporal.

customKeychainPath - ruta de acceso de cadena de claves personalizada
string. Obligatorio cuando keychain = custom.

Especifica la ruta de acceso completa a un archivo de cadena de claves personalizado. La cadena de claves se creará si aún no existe.

deleteCert - Eliminar certificado de la cadena de claves
boolean. Opcional. Use cuando keychain = custom || keychain = default.

Especifica el certificado que se va a eliminar de la cadena de claves una vez completada la compilación o la versión.

deleteCustomKeychain - Eliminar cadena de claves personalizada
boolean. Opcional. Use cuando keychain = custom.

Especifica la cadena de claves personalizada que se va a eliminar del agente una vez completada la compilación o la versión.

de identidad de firma de certificados de signingIdentity -
string.

Especifica el Common Name del firmante en el certificado de firma. Intentará analizar el Common Name si se deja vacío.

setUpPartitionIdACLForPrivateKey - Configurar partition_id ACL para la clave privada importada
boolean.

Si true, establece la ACL de partition_id para la clave privada importada para que codesign no pida que use la clave para la firma. Esto no es necesario para cadenas de claves temporales en MacOS High Sierra. Obtenga más información sobre Open Radar.

opensslPkcsArgs - argumentos openSSL para la PKCS12
string.

Argumentos para extraer información del certificado mediante openssl.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Esta tarea define las siguientes variables de salida , que puede consumir en pasos, trabajos y fases de bajada.

signingIdentity
Especifica el Common Name resuelto del sujeto en el certificado de firma. Se proporciona como entrada o se analiza desde el archivo de certificado P12.

keychainPath
Especifica la ruta de acceso del archivo de cadena de claves con el certificado.

Observaciones

Use esta tarea para instalar un certificado de Apple necesario para compilar en un agente de macOS. Puede usar esta tarea para instalar un certificado de Apple que se almacena como archivo seguro en el servidor.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas ejecutar trabajos que usen esta tarea: xcode
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Esta tarea se ejecuta con las restricciones de comandos siguientes: restringido
variables settable	Esta tarea tiene permiso para establecer las siguientes variables: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN
Versión del agente	2.182.1 o superior
Categoría de tarea	Utilidad