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 |