DownloadSecureFile@1 — pobieranie bezpiecznego pliku w wersji 1 — zadanie

To zadanie służy do pobierania bezpiecznego pliku na maszynę agenta.

Składnia

# 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.

Dane wejściowe

bezpiecznego pliku secureFile -
string. To jest wymagane.

Określa nazwę lub unikatowy identyfikator (GUID) bezpiecznego pliku pobranego na maszynę agenta. Plik zostanie usunięty po zakończeniu zadania potoku.

retryCount - liczba ponownych prób
string. Wartość domyślna: 8.

Opcjonalny. Określa liczbę ponownych prób pobrania bezpiecznego pliku, jeśli pobieranie zakończy się niepowodzeniem.

limit czasu gniazda socketTimeout -
string.

Opcjonalny. Podczas pobierania żądania bezpiecznego pliku w firmie Microsoft dane wejściowe określają limit czasu gniazda.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz opcje kontroli i typowe właściwości zadań.

Zmienne wyjściowe

To zadanie definiuje następujące zmienne wyjściowe , które można używać w krokach podrzędnych, zadaniach i etapach.

secureFilePath
Określa lokalizację pobranego bezpiecznego pliku.

Uwagi

Użyj tego zadania w potoku, aby pobrać bezpieczny plik na maszynę agenta. Podczas określania nazwy pliku (przy użyciu secureFile danych wejściowych) użyj nazwy określonej podczas jego przekazywania, a nie rzeczywistej nazwy pliku.

Uwaga

To zadanie jest uruchamiane na początku etapu, niezależnie od tego, gdzie znajduje się w ramach zadania.

Po pobraniu użyj wartości name ustawionej w zadaniu (lub "Nazwa odwołania" w edytorze klasycznym), aby odwołać się do ścieżki do bezpiecznego pliku na maszynie agenta. Jeśli na przykład zadanie ma nazwę mySecureFile, można odwoływać się do jego ścieżki w potoku jako $(mySecureFile.secureFilePath). Alternatywnie pobrane bezpieczne pliki można znaleźć w katalogu podanym przez $(Agent.TempDirectory). Zobacz pełny przykład poniżej.

Gdy zadanie potoku zostanie zakończone, niezależnie od tego, czy zakończy się pomyślnie, niepowodzeniem, czy zostanie anulowane, plik zabezpieczony zostanie usunięty z lokalizacji pobierania.

Nie trzeba używać tego zadania z Install Apple Certificate or Install Apple Provisioning Profile (Instalowanie profilu aprowizacji firmy Apple) zadań, ponieważ automatycznie pobierają, instalują i usuwają (na końcu zadania potoku) bezpieczny plik.

To zadanie obsługuje obecnie tylko jedno zadanie pliku na wystąpienie.

Przykłady

W tym przykładzie pobiera bezpieczny plik certyfikatu i instaluje go w katalogu zaufanego urzędu certyfikacji w systemie Linux:

- 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/ 

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	To zadanie jest uruchamiane przy użyciu następujących ograniczeń poleceń : ograniczone
zmienne ustawiane	To zadanie ma uprawnienia do ustawić następujące zmienne: secureFilePath
Wersja agenta	2.182.1 lub nowsza
Kategoria zadań	Użyteczność