Sdílet prostřednictvím


InstallAppleCertificate@2 – Instalace certifikátu Apple v2

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

Nainstalujte si certifikát Apple potřebný k sestavení na agenta 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.

Vstupy

certSecureFile - Certifikát (P12)
string. Povinná hodnota.

Určuje certifikát (.p12), do Secure Files kterého se nahrál, aby se nainstaloval na agenta macOS.


certPwd - Heslo 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 Variables na kartě.


keychain - Keychain
string. Povinná hodnota. Povolené hodnoty: default (Výchozí klíčenka), temp (Dočasný custom klíč), (Vlastní klíčenka). Výchozí hodnota: temp.

Určuje řetězce klíčů, do kterého se má nainstalovat certifikát Apple. V případě buildů hostovaných Microsoftem použijte Temporary Keychain. Dočasný řetězec klíčů se po dokončení sestavení nebo vydání vždy odstraní.


keychainPassword - Heslo řetězce klíčů
string. Vyžaduje se, když keychain = custom || keychain = default.

Určuje heslo pro odemknutí řetězce klíčů. K zašifrování této hodnoty použijte novou proměnnou sestavení s povoleným zámkem Variables na kartě. Heslo se vygeneruje pro dočasný řetězec klíčů, pokud není zadané.


customKeychainPath - Vlastní cesta řetězce klíčů
string. Vyžaduje se, když keychain = custom.

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


deleteCert - Odstranění certifikátu z řetězce klíčů
boolean. Nepovinný parametr. Použijte, když 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ího řetězce klíčů
boolean. Nepovinný parametr. Použijte, když keychain = custom.

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


signingIdentity - Identita podepisování certifikátu
string.

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


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

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


opensslPkcsArgs - Argumenty OpenSSL pro PKCS12
string.

Argumenty pro extrakci 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 najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

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 předmět v podpisovém certifikátu. Buď 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 agenta macOS. Tuto úlohu můžete použít k instalaci certifikátu Apple, který je na serveru uložený jako zabezpečený soubor .

Požadavky

Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům , aby bylo možné spouštět úlohy, 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 spustí pomocí následujících omezení příkazů: restricted
Nastavitelné proměnné Tato úloha má oprávnění k nastavení následujících proměnných: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY APPLE_CERTIFICATE_KEYCHAIN
Verze agenta 2.182.1 nebo vyšší
Kategorie úloh Nástroj
Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům , aby bylo možné spouštět úlohy, které používají tuto úlohu: xcode
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 2.116.0 nebo vyšší
Kategorie úloh Nástroj