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 |