Comparteix a través de


InstallAppleCertificate@2: instalación de la tarea 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 almacenado como archivo seguro en el servidor.

Instale un certificado de Apple necesario para compilar en un agente de macOS.

Syntax

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

Entradas

certSecureFile - Certificado (P12)
string. Obligatorio.

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


certPwd - Contraseña de certificado (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 Variables pestaña para cifrar este valor.


keychain - Llavero
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 elimina una vez completada la compilación o la versión.


keychainPassword - Contraseña de cadena de claves
string. Necesario 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 Variables pestaña para cifrar este valor. Se genera una contraseña para la cadena de claves temporal, si no se ha especificado.


customKeychainPath - Ruta de acceso de cadena de claves personalizada
string. Necesario 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 - Eliminación del 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.


signingIdentity - Identidad de firma de certificado
string.

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


setUpPartitionIdACLForPrivateKey - Configuración de partition_id ACL para la clave privada importada
boolean.

Si truees , establece la partition_id ACL de la clave privada importada para que codesign no se le 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 de OpenSSL para PKCS12
string.

Argumentos para la información del certificado de extracción mediante openssl.


Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea 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 la resolución Common Name del asunto 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.

Comentarios

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 almacenado 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
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: xcode
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Esta tarea se ejecuta con las siguientes restricciones de comandos: restringido
Variables que se pueden establecer 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 la tarea: Utilidad
Requisito Descripción
Tipos de canalización YAML, compilación clásica, versión clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: xcode
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 2.116.0 o superior
Categoría de la tarea: Utilidad