다음을 통해 공유


InstallAppleCertificate@1 - Apple Certificate v1 작업 설치

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

구문론

# Install Apple Certificate v1
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@1
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. 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 인증서를 설치할 키 집합을 지정합니다. 임시 키 집합은 빌드 또는 릴리스가 완료된 후에 항상 삭제됩니다.


키 집합 암호keychainPassword -
string;

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


사용자 지정 키 집합 경로customKeychainPath -
string; keychain = custom때 필요합니다.

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


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

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


deleteCustomKeychain - 사용자 지정 키 집합 삭제
boolean; 선택 사항. keychain = custom때 사용합니다.

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


signingIdentity - 인증서 서명 ID
string;

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


작업 제어 옵션

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

출력 변수

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

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

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

요구 사항

요구 사항 설명
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위해 요구 사항과 일치하는 기능이 있어야 합니다.
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어느 것이든
settable 변수 어느 것이든
에이전트 버전 2.116.0 이상
작업 범주 유틸리티