InstallAppleCertificate@2 - Instalar a tarefa de certificado da Apple v2

Utilize esta tarefa para instalar o certificado da Apple que é necessário para criar num agente macOS. Pode utilizar esta tarefa para instalar um certificado da Apple armazenado como um ficheiro seguro no servidor.

Instale um certificado da Apple necessário para criar num agente 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. Obrigatório.

Especifica o certificado (.p12) para o qual foi carregado Secure Files para instalar no agente macOS.


certPwd - Palavra-passe do certificado (P12)
string.

Especifica a palavra-passe para o certificado da Apple (.p12). Utilize uma nova variável de compilação com o respetivo bloqueio ativado no Variables separador para encriptar este valor.


keychain - Porta-chaves
string. Obrigatório. Valores permitidos: default (Keychain Predefinido), temp (Keychain Temporário), custom (Keychain Personalizado). Valor predefinido: temp.

Especifica o keychain no qual pretende instalar o certificado da Apple. Para compilações alojadas na Microsoft, utilize Temporary Keychain. Um keychain temporário será sempre eliminado após a conclusão da compilação ou versão.


keychainPassword - Palavra-passe de porta-chaves
string. Necessário quando keychain = custom || keychain = default.

Especifica a palavra-passe para desbloquear o keychain. Utilize uma nova variável de compilação com o respetivo bloqueio ativado no Variables separador para encriptar este valor. É gerada uma palavra-passe para o keychain temporário, se não for especificada.


customKeychainPath - Caminho do porta-chaves personalizado
string. Necessário quando keychain = custom.

Especifica o caminho completo para um ficheiro de keychain personalizado. O keychain será criado se ainda não existir.


deleteCert - Eliminar certificado do keychain
boolean. Opcional. Utilize quando keychain = custom || keychain = default.

Especifica o certificado a eliminar do keychain após a conclusão da compilação ou versão.


deleteCustomKeychain - Eliminar porta-chaves personalizada
boolean. Opcional. Utilize quando keychain = custom.

Especifica a keychain personalizada a eliminar do agente após a conclusão da compilação ou versão.


signingIdentity - Identidade de assinatura do certificado
string.

Especifica o Common Name assunto no certificado de assinatura. Tentará analisar se Common Name esta opção for deixada em branco.


setUpPartitionIdACLForPrivateKey - Configurar partition_id ACL para a chave privada importada
boolean.

Se true, define a partition_id ACL para a chave privada importada para que codesign não seja pedido para utilizar a chave para assinatura. Isto não é necessário para porta-chaves temporárias no MacOS High Sierra. Saiba mais sobre o Open Radar.


opensslPkcsArgs - Argumentos OpenSSL para PKCS12
string.

Argumentos para informações de certificado de extração com openssl.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída, que pode consumir em passos, tarefas e fases a jusante.

signingIdentity
Especifica o assunto resolvido Common Name no certificado de assinatura. Fornecido como uma entrada ou analisado a partir do ficheiro de certificado P12.

keychainPath
Especifica o caminho para o ficheiro keychain com o certificado.

Observações

Utilize esta tarefa para instalar um certificado da Apple necessário para criar num agente macOS. Pode utilizar esta tarefa para instalar um certificado da Apple armazenado como um ficheiro seguro no servidor.

Requisitos

Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: xcode
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Esta tarefa é executada com as seguintes restrições de comando: restritas
Variáveis de definição Esta tarefa tem permissão para definir as seguintes variáveis: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN
Versão do agente 2.182.1 ou superior
Categoria da tarefa Utilitário
Requisito Description
Tipos de pipeline YAML, Compilação clássica, Versão clássica
É executado em Agent, DeploymentGroup
Exigências Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: xcode
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos Qualquer
Variáveis de definição Qualquer
Versão do agente 2.116.0 ou superior
Categoria da tarefa Utilitário