DownloadSecureFile@1 - セキュリティで保護されたファイル v1 タスクをダウンロードする
このタスクを使用して、セキュリティで保護されたファイルをエージェント コンピューターにダウンロードします。
構文
# 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.
入力
セキュリティで保護されたファイルを secureFile - する
string. 必須。
エージェント コンピューターにダウンロードされるセキュリティで保護されたファイルの名前または一意識別子 (GUID) を指定します。 パイプライン ジョブが完了すると、ファイルが削除されます。
retryCount
-
再試行回数の
string. 既定値: 8.
任意 ダウンロードが失敗した場合にセキュリティで保護されたファイルのダウンロードを再試行する回数を指定します。
retryCount
-
再試行回数の
string. 既定値: 5.
任意 ダウンロードが失敗した場合にセキュリティで保護されたファイルのダウンロードを再試行する回数を指定します。
socketTimeout
-
ソケット タイムアウト
string.
任意 Microsoft でセキュリティで保護されたファイル要求をダウンロードする場合、この入力はソケットのタイムアウトを指定します。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
このタスクでは、次の 出力変数を定義します。この変数は、ダウンストリームのステップ、ジョブ、およびステージで使用できます。
secureFilePath
ダウンロードされたセキュリティで保護されたファイルの場所を指定します。
注釈
パイプラインでこのタスクを使用して、セキュリティで保護された ファイル をエージェント コンピューターにダウンロードします。 (secureFile 入力を使用して) ファイルの名前を指定する場合は、実際のファイル名ではなく、アップロード時に指定した名前を使用します。
注
このタスクは、ジョブ内の場所に関係なく、ステージの先頭で実行されます。
ダウンロードしたら、タスクに設定されている name 値 (クラシック エディターでは "参照名" ) を使用して、エージェント コンピューター上のセキュリティで保護されたファイルへのパスを参照します。 たとえば、タスクに mySecureFile名前が付けられた場合、そのパスはパイプライン内で $(mySecureFile.secureFilePath)として参照できます。 または、ダウンロードしたセキュリティで保護されたファイルは、$(Agent.TempDirectory)によって与えられたディレクトリにあります。 以下の 完全な例を参照してください。
パイプライン ジョブが完了すると、成功、失敗、または取り消されたかどうかに関係なく、セキュリティで保護されたファイルはダウンロード場所から削除されます。
このタスクは、セキュリティで保護されたファイルを (パイプライン ジョブの最後に) 自動的にダウンロード、インストール、および削除するため、Apple Certificate のインストールまたは apple Provisioning Profile タスクのインストール で使用する必要があります。
現在、このタスクはインスタンスごとに 1 つのファイル タスクのみをサポートしています。
例示
この例では、セキュリティで保護された証明書ファイルをダウンロードし、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/