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 true
es , 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 |