Partilhar via


InstallAppleCertificate@1 - Tarefa Instalar o Apple Certificate v1

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 v1
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@1
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. 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.

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

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 ainda não estiver 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.


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.

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 Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.116.0 ou superior
Categoria de tarefa Utilidade