다음을 통해 공유

DownloadSecureFile@1 - 보안 파일 v1 작업 다운로드

  • 아티클

이 작업을 사용하여 에이전트 컴퓨터에 보안 파일을 다운로드합니다.

이 작업을 사용하여 에이전트 컴퓨터의 임시 위치에 보안 파일을 다운로드합니다.

이 작업을 사용하여 빌드 또는 릴리스 에이전트의 임시 위치에 보안 파일을 다운로드합니다.

Syntax

# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File. 
    #retryCount: '8' # string. Retry Count. Default: 8.
    #socketTimeout: # string. Socket Timeout.

# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File. 
    #retryCount: '5' # string. Retry Count. Default: 5.

# Download secure file v1
# Download a secure file to a temporary location on the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File.

# Download Secure File v1
# Download a secure file to a temporary location on the build or release agent.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File.

입력

secureFile - 보안 파일
string. 필수 요소.

에이전트 컴퓨터에 다운로드되는 보안 파일의 이름 또는 GUID(고유 식별자)를 지정합니다. 파이프라인 작업이 완료되면 파일이 삭제됩니다.


retryCount - 재시도 횟수
string. 기본값은 8입니다.

(선택 사항) 다운로드가 실패할 경우 보안 파일 다운로드를 다시 시도할 횟수를 지정합니다.


retryCount - 재시도 횟수
string. 기본값은 5입니다.

(선택 사항) 다운로드가 실패할 경우 보안 파일 다운로드를 다시 시도할 횟수를 지정합니다.


socketTimeout - 소켓 시간 제한
string.

(선택 사항) Microsoft에서 보안 파일 요청을 다운로드할 때 이 입력은 소켓에 대한 시간 제한을 지정합니다.


작업 제어 옵션

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

출력 변수

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

secureFilePath
다운로드한 보안 파일의 위치를 지정합니다.

설명

파이프라인에서 이 작업을 사용하여 에이전트 컴퓨터에 보안 파일을 다운로드합니다. 입력을 사용하여 secureFile 파일 이름을 지정할 때는 실제 파일 이름이 아닌 파일 이름을 업로드할 때 지정한 이름을 사용합니다.

다운로드되면 태스크에 설정된 값(또는 클래식 편집기에서 "참조 이름")을 사용하여 name 에이전트 컴퓨터의 보안 파일 경로를 참조합니다. 예를 들어 태스크에 이름이 mySecureFile지정된 경우 파이프라인에서 해당 경로를 로 $(mySecureFile.secureFilePath)참조할 수 있습니다. 또는 다운로드한 보안 파일은 에서 제공하는 $(Agent.TempDirectory)디렉터리에서 찾을 수 있습니다. 아래의 전체 예제를 참조 하세요.

파이프라인 작업이 성공, 실패 또는 취소되었는지 여부에 관계없이 파이프라인 작업이 완료되면 보안 파일이 다운로드 위치에서 삭제됩니다.

Apple 인증서 설치 또는 Apple 프로비저닝 프로필 설치 작업은 보안 파일을 자동으로 다운로드, 설치 및 삭제하기 때문에 이 작업을 사용할 필요가 없습니다.

이 작업은 현재 인스턴스당 하나의 파일 작업만 지원합니다.

예제

다음은 보안 인증서 파일을 다운로드하여 Linux의 신뢰할 수 있는 CA(인증 기관) 디렉터리에 설치하는 예제입니다.

- task: DownloadSecureFile@1
  name: caCertificate
  displayName: 'Download CA certificate'
  inputs:
    secureFile: 'myCACertificate.pem'

- script: |
    echo Installing $(caCertificate.secureFilePath) to the trusted CA directory...
    sudo chown root:root $(caCertificate.secureFilePath)
    sudo chmod a+r $(caCertificate.secureFilePath)
    sudo ln -s $(caCertificate.secureFilePath) /etc/ssl/certs/

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 사항 이 작업은 다음 명령 제한을 사용하여 실행됩니다. 제한됨
설정 가능한 변수 이 작업에는 secureFilePath 변수를 설정할 수 있는 권한이 있습니다.
에이전트 버전 2.182.1 이상
작업 범주 유틸리티
요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 2.116.0 이상
작업 범주 유틸리티