InstallAppleCertificate@2 - Instalar a tarefa Apple certificate v2

Use esta tarefa para instalar o certificado da Apple necessário para criar em um agente do macOS. Pode utilizar esta tarefa para instalar um certificado Apple armazenado como um ficheiro seguro no servidor.

Sintaxe

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

Insumos

Certificado certSecureFile - (P12)
string. Obrigatório.

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

certPwd - senha do certificado (P12)
string.

Especifica a senha para o certificado Apple (.p12). Use uma nova variável de compilação com seu bloqueio ativado na guia Variables para criptografar esse valor.

keychain - Porta-chaves
string. Obrigatório. Valores permitidos: default (Porta-chaves padrão), temp (Porta-chaves temporárias) custom (Porta-chaves personalizadas). Valor padrão: temp.

Especifica as chaves nas quais instalar o certificado Apple. Para compilações hospedadas pela Microsoft, use Temporary Keychain. Um conjunto de chaves temporário sempre será excluído após a conclusão da compilação ou versão.

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

Especifica a senha para desbloquear as chaves. Use uma nova variável de compilação com seu bloqueio ativado na guia Variables para criptografar esse valor. Uma senha é gerada para as chaves temporárias, se não for especificada.

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

Especifica o caminho completo para um arquivo de conjunto de chaves personalizado. O porta-chaves será criado se ainda não existir.

deleteCert - Excluir certificado do de chaves
boolean. Opcional. Use quando keychain = custom || keychain = default.

Especifica o certificado a ser excluído das chaves após a conclusão da compilação ou versão.

deleteCustomKeychain - Excluir de chaveiro personalizado
boolean. Opcional. Use quando keychain = custom.

Especifica as chaves personalizadas a serem excluídas do agente após a conclusão da compilação ou versão.

signingIdentity - de identidade de assinatura de certificado
string.

Especifica a Common Name do assunto no certificado de assinatura. Tentará analisar o Common Name se este for deixado vazio.

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

Se true, define a ACL de partition_id para a chave privada importada para que codesign não solicite o uso da chave para assinatura. Isso não é necessário para chaveiros temporários no MacOS High Sierra. Saiba mais sobre Open Radar.

opensslPkcsArgs - argumentos OpenSSL para PKCS12
string.

Argumentos para extrair informações de certificado usando openssl.

Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída , que você pode consumir em etapas, trabalhos e estágios downstream.

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

keychainPath
Especifica o caminho para o arquivo de conjunto de chaves com o certificado.

Observações

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

Requerimentos

Requisito	Descrição
Tipos de pipeline	YAML, Construção clássica, Versão clássica
Funciona em	Agente, DeploymentGroup
Exigências	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: xcode
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando	Esta tarefa é executada usando as seguintes restrições de comando : restrito
Variáveis configuráveis	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 de tarefa	Utilidade