InstallAppleCertificate@1 - Installer la tâche Apple Certificate v1

Article
05/16/2024

Utilisez cette tâche pour installer le certificat Apple requis pour générer sur un agent macOS. Vous pouvez utiliser cette tâche pour installer un certificat Apple stocké en tant que fichier sécurisé sur le serveur.

Syntaxe

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

Entrées

certSecureFile - Certificat (P12)
string. Obligatoire.

Spécifie le certificat (.p12) qui a été chargé pour Secure Files l’installer sur l’agent macOS.

certPwd - Mot de passe du certificat (P12)
string.

Spécifie le mot de passe du certificat Apple (.p12). Utilisez une nouvelle variable de build avec son verrou activé sur l’onglet Variables pour chiffrer cette valeur.

keychain - Porte-clés
string. Obligatoire. Valeurs autorisées : default (trousseau par défaut), temp (trousseau temporaire), custom (trousseau personnalisé). Valeur par défaut : temp.

Spécifie le trousseau dans lequel installer le certificat Apple. Un trousseau temporaire est toujours supprimé une fois la build ou la mise en production terminée.

keychainPassword - Mot de passe du trousseau
string.

Spécifie le mot de passe pour déverrouiller le trousseau. Utilisez une nouvelle variable de build avec son verrou activé sur l’onglet Variables pour chiffrer cette valeur. Un mot de passe est généré pour le trousseau temporaire si aucun mot de passe n’est déjà spécifié.

customKeychainPath - Chemin du trousseau personnalisé
string. Obligatoire lorsque keychain = custom.

Spécifie le chemin d’accès complet à un fichier de trousseau personnalisé. Le trousseau est créé s’il n’existe pas déjà.

deleteCert - Supprimer le certificat du trousseau
boolean. facultatif. Utilisez quand keychain = custom || keychain = default.

Spécifie le certificat à supprimer du trousseau une fois la build ou la mise en production terminée.

deleteCustomKeychain - Supprimer un trousseau personnalisé
boolean. Optionnel. Utilisez quand keychain = custom.

Spécifie le trousseau personnalisé à supprimer de l’agent une fois la build ou la mise en production terminée.

signingIdentity - Identité de signature de certificat
string.

Spécifie l’objet Common Name dans le certificat de signature. Tente d’analyser le Common Name cas échéant.

Options de contrôle de tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser dans les étapes, travaux et étapes en aval.

signingIdentity
Spécifie le sujet résolu Common Name dans le certificat de signature. Fourni en tant qu’entrée ou analysé à partir du fichier de certificat P12.

keychainPath
Spécifie le chemin d’accès du fichier de trousseau avec le certificat.

Spécifications

Condition requise	Description
Types de pipelines	YAML, build classique, version classique
Exécutions sur	Agent, DeploymentGroup
Demandes	Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : xcode
Capabilities	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
Restrictions de commande	Quelconque
Variables settables	Quelconque
Version de l’agent	2.116.0 ou version ultérieure
Catégorie de la tâche	Utilitaire

Share via