InstallAppleCertificate@2 – instalace úlohy Certifikátu Apple v2

Pomocí této úlohy nainstalujte certifikát Apple, který je nutný k sestavení na agentu macOS. Tuto úlohu můžete použít k instalaci certifikátu Apple, který je uložený jako zabezpečený soubor na serveru.

Syntaxe

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

Vstupy

certifikátu certSecureFile - (P12)
string. Povinné.

Určuje certifikát (.p12), který se nahrál do Secure Files pro instalaci do agenta macOS.

hesla certPwd - certifikátu (P12)
string.

Určuje heslo k certifikátu Apple (.p12). K zašifrování této hodnoty použijte novou proměnnou sestavení s povoleným zámkem na kartě Variables.

řetězce klíčů keychain -
string. Povinné. Povolené hodnoty: default (výchozí klíčová zkratka), temp (dočasná sada klíčů), custom (vlastní klíčenky). Výchozí hodnota: temp.

Určuje klíčence, do které se má certifikát Apple nainstalovat. Pro buildy hostované Microsoftem použijte Temporary Keychain. Po dokončení sestavení nebo vydání se vždy odstraní dočasná sada klíčů.

keychainPassword - klíčenky
string. Požadováno při keychain = custom || keychain = default.

Určuje heslo k odemknutí klíčenky. K zašifrování této hodnoty použijte novou proměnnou sestavení s povoleným zámkem na kartě Variables. Heslo se vygeneruje pro dočasnou klíčence, pokud není zadáno.

customKeychainPath - cesta k vlastní klíčence
string. Požadováno při keychain = custom.

Určuje úplnou cestu k vlastnímu souboru řetězce klíčů. Klíčence se vytvoří, pokud ještě neexistuje.

deleteCert - odstranění certifikátu z klíčenky
boolean. Volitelný. Používá se při keychain = custom || keychain = default.

Určuje certifikát, který se má odstranit z řetězce klíčů po dokončení sestavení nebo vydání.

deleteCustomKeychain - Odstranění vlastních řetězce klíčů
boolean. Volitelný. Používá se při keychain = custom.

Určuje vlastní klíčence, který se má odstranit z agenta po dokončení sestavení nebo vydání.

signingIdentity - identita podepisování certifikátů
string.

Určuje Common Name předmětu v podpisovém certifikátu. Pokusí se analyzovat Common Name, pokud je tato možnost prázdná.

setUpPartitionIdACLForPrivateKey - Nastavení partition_id seznamu ACL pro importovaný privátní klíč
boolean.

Pokud true, nastaví seznam ACL partition_id pro importovaný privátní klíč tak, aby codesign k podepisování nezokáže na použití klíče. To není nutné pro dočasné klíčenky v macOS High Sierra. Přečtěte si další informace o Open Radar.

opensslPkcsArgs - argumenty OpenSSL pro PKCS12
string.

Argumenty pro extrahování informací o certifikátu pomocí openssl.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.

Výstupní proměnné

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

signingIdentity
Určuje vyřešené Common Name subjektu v podpisovém certifikátu. Buď je zadaný jako vstup, nebo parsovaný ze souboru certifikátu P12.

keychainPath
Určuje cestu k souboru řetězce klíčů s certifikátem.

Poznámky

Tuto úlohu použijte k instalaci certifikátu Apple, který je nutný k sestavení na agentu macOS. Tuto úlohu můžete použít k instalaci certifikátu Apple, který je uložený jako zabezpečený soubor na serveru.

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, skupina nasazení
požadavky	Agenti v místním prostředí musí mít schopnosti, které odpovídají následujícím požadavkům ke spouštění úloh, které používají tuto úlohu: xcode
možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
omezení příkazů	Tato úloha se spouští s následujícími omezeními příkazů : omezeno:
nastavitelné proměnné	Tato úloha má oprávnění k nastavit následující proměnné: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN
Verze agenta	2.182.1 nebo vyšší
Kategorie úkolu	Užitnost