Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Använd den här uppgiften för att installera det Apple-certifikat som krävs för att bygga på en macOS-agent. Du kan använda den här uppgiften för att installera ett Apple-certifikat som lagras som en säker fil på servern.
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.
Ingångar
              certSecureFile
               - 
              certifikat (P12)
              string. Obligatoriskt.
Anger det certifikat (.p12) som laddades upp till Secure Files som ska installeras på macOS-agenten.
              certPwd
               - 
              certifikat (P12) lösenord
              string.
Anger lösenordet till Apple-certifikatet (.p12). Använd en ny byggvariabel med låset aktiverat på fliken Variables för att kryptera det här värdet.
              keychain
               - 
              nyckelring
              string. Obligatoriskt. Tillåtna värden: default (standardnyckelring), temp (tillfällig nyckelring), custom (anpassad nyckelring). Standardvärde: temp.
Anger den nyckelring där Apple-certifikatet ska installeras. För Microsoft-värdbaserade versioner använder du Temporary Keychain. En tillfällig nyckelring tas alltid bort när bygget eller versionen har slutförts.
              keychainPassword
               - 
              nyckelringslösenord
              string. Krävs när keychain = custom || keychain = default.
Anger lösenordet för att låsa upp nyckelringen. Använd en ny byggvariabel med låset aktiverat på fliken Variables för att kryptera det här värdet. Ett lösenord genereras för den tillfälliga nyckelringen om det inte anges.
              customKeychainPath
               - 
              Anpassad nyckelringssökväg
              string. Krävs när keychain = custom.
Anger den fullständiga sökvägen till en anpassad nyckelringsfil. Nyckelringen skapas om den inte redan finns.
              deleteCert
               - 
              Ta bort certifikat från nyckelringen
              boolean. Valfritt. Använd när keychain = custom || keychain = default.
Anger certifikatet som ska tas bort från nyckelringen när bygget eller versionen har slutförts.
              deleteCustomKeychain
               - 
              Ta bort anpassad nyckelring
              boolean. Valfritt. Använd när keychain = custom.
Anger den anpassade nyckelring som ska tas bort från agenten när bygget eller versionen är klar.
              signingIdentity
               - 
              certifikatsigneringsidentitet
              string.
Anger Common Name för ämnet i signeringscertifikatet.  Försöker parsa Common Name om detta lämnas tomt.
              setUpPartitionIdACLForPrivateKey
               - 
              Konfigurera partition_id ACL för den importerade privata nyckeln
              boolean.
Om trueanger du partition_id ACL för den importerade privata nyckeln så att codesign inte uppmanas att använda nyckeln för signering. Detta är inte nödvändigt för tillfälliga nyckelringar på MacOS High Sierra. Läs mer om Open Radar.
              opensslPkcsArgs
               - 
              OpenSSL-argument för PKCS12
              string.
Argument för extrahering av certifikatinformation med hjälp av openssl.
Kontrollalternativ för aktivitet
Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.
Utdatavariabler
Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.
signingIdentity
               Anger den lösta Common Name för ämnet i signeringscertifikatet. Tillhandahålls antingen som indata eller parsas från P12-certifikatfilen.
keychainPath
               Anger sökvägen för nyckelringsfilen med certifikatet.
Anmärkningar
Använd den här uppgiften för att installera ett Apple-certifikat som krävs för att bygga på en macOS-agent. Du kan använda den här uppgiften för att installera ett Apple-certifikat som lagras som en säker fil på servern.
Krav
| Krav | Beskrivning | 
|---|---|
| Pipelinetyper | YAML, klassisk version, klassisk version | 
| Körs på | Agent, DeploymentGroup | 
| kräver | Lokalt installerade agenter måste ha funktioner som matchar följande kräver att köra jobb som använder den här uppgiften: xcode | 
| funktioner | Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet. | 
| Kommandobegränsningar | Den här aktiviteten körs med hjälp av följande kommandobegränsningar: begränsad | 
| variabler som kan | Den här uppgiften har behörighet att ange följande variabler: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN | 
| Agentversion | 2.182.1 eller senare | 
| Aktivitetskategori | Nytta | 
| Krav | Beskrivning | 
|---|---|
| Pipelinetyper | YAML, klassisk version, klassisk version | 
| Körs på | Agent, DeploymentGroup | 
| kräver | Lokalt installerade agenter måste ha funktioner som matchar följande kräver att köra jobb som använder den här uppgiften: xcode | 
| funktioner | Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet. | 
| Kommandobegränsningar | Vilken som helst | 
| variabler som kan | Vilken som helst | 
| Agentversion | 2.116.0 eller senare | 
| Aktivitetskategori | Nytta |