다음을 통해 공유


InstallAppleCertificate@2 - Apple 인증서 v2 작업 설치

이 작업을 사용하여 macOS 에이전트에서 빌드하는 데 필요한 Apple 인증서를 설치합니다. 이 작업을 사용하여 서버에 보안 파일 로 저장된 Apple 인증서를 설치할 수 있습니다.

macOS 에이전트에서 빌드하는 데 필요한 Apple 인증서를 설치합니다.

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.

입력

certSecureFile - 인증서(P12)
string. 필수 요소.

macOS 에이전트에 설치하기 위해 Secure Files 업로드된 인증서(.p12)를 지정합니다.


certPwd - 인증서(P12) 암호
string.

Apple 인증서(.p12)에 대한 암호를 지정합니다. 탭에서 잠금을 사용하도록 설정된 새 빌드 변수를 Variables 사용하여 이 값을 암호화합니다.


keychain - 키체인
string. 필수 요소. 허용되는 값: default (기본 키 집합), temp (임시 키 집합), custom (사용자 지정 키 집합). 기본값은 temp입니다.

Apple 인증서를 설치할 키체인 지정합니다. Microsoft 호스팅 빌드의 경우 를 사용합니다 Temporary Keychain. 임시 키체인 빌드 또는 릴리스가 완료된 후 항상 삭제됩니다.


keychainPassword - 키 집합 암호
string. 필요한 경우 keychain = custom || keychain = default입니다.

키체인 잠금을 해제할 암호를 지정합니다. 탭에서 잠금을 사용하도록 설정된 새 빌드 변수를 Variables 사용하여 이 값을 암호화합니다. 지정하지 않으면 임시 키체인 대한 암호가 생성됩니다.


customKeychainPath - 사용자 지정 키체인 경로
string. 필요한 경우 keychain = custom입니다.

사용자 지정 키체인 파일의 전체 경로를 지정합니다. 키체인 아직 없는 경우 만들어집니다.


deleteCert - 키체인 인증서 삭제
boolean. 선택 사항입니다. 을 사용할 때 keychain = custom || keychain = default사용합니다.

빌드 또는 릴리스가 완료된 후 키체인 삭제할 인증서를 지정합니다.


deleteCustomKeychain - 사용자 지정 키체인 삭제
boolean. 선택 사항입니다. 을 사용할 때 keychain = custom사용합니다.

빌드 또는 릴리스가 완료된 후 에이전트에서 삭제할 사용자 지정 키체인 지정합니다.


signingIdentity - 인증서 서명 ID
string.

서명 인증서에 있는 주체의 를 지정 Common Name 합니다. 가 비어 있는 경우 를 구문 분석 Common Name 하려고 시도합니다.


setUpPartitionIdACLForPrivateKey - 가져온 프라이빗 키에 대한 partition_id ACL 설정
boolean.

이면 true가져온 프라이빗 키에 대한 ACL을 설정 partition_id 하므로 codesign 서명에 키를 사용하라는 메시지가 표시되지 않습니다. MacOS High Sierra의 임시 키 집합에는 필요하지 않습니다. Open Radar에 대해 자세히 알아보세요.


opensslPkcsArgs - PKCS12에 대한 OpenSSL 인수
string.

openssl을 사용하여 인증서 정보를 추출하기 위한 인수입니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수를 정의합니다.

signingIdentity
서명 인증서에서 주체의 확인됨 Common Name 을 지정합니다. 입력으로 제공되거나 P12 인증서 파일에서 구문 분석됩니다.

keychainPath
인증서를 사용하여 키체인 파일의 경로를 지정합니다.

설명

이 작업을 사용하여 macOS 에이전트에서 빌드하는 데 필요한 Apple 인증서를 설치합니다. 이 작업을 사용하여 서버에 보안 파일 로 저장된 Apple 인증서를 설치할 수 있습니다.

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위한 다음 요구 사항과 일치하는 기능이 있어야 합니다. xcode
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 이 작업은 다음 명령 제한을 사용하여 실행됩니다. 제한됨
설정 가능한 변수 이 작업에는 signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN 변수를 설정할 수 있는 권한이 있습니다.
에이전트 버전 2.182.1 이상
작업 범주 유틸리티
요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위한 다음 요구 사항과 일치하는 기능이 있어야 합니다. xcode
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 2.116.0 이상
작업 범주 유틸리티