DownloadSecureFile@1 — pobieranie zadania bezpiecznego pliku w wersji 1

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

secureFile - Bezpieczny plik
string. Wymagane.

Określa nazwę lub unikatowy identyfikator (GUID) bezpiecznego pliku pobranego na maszynę agenta. Plik jest usuwany 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.

socketTimeout - Limit czasu gniazda
string.

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

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz ich danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania 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 przekazywania pliku, a nie rzeczywistej nazwy pliku.

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

Po zakończeniu zadania potoku, niezależnie od tego, czy zakończy się powodzeniem, niepowodzeniem, czy anulowaniem, bezpieczny plik zostanie usunięty z lokalizacji pobierania.

Nie trzeba używać tego zadania z zadaniami Zainstaluj certyfikat firmy Apple lub Zainstaluj profil aprowizacji firmy Apple , ponieważ automatycznie pobierają, instalują i usuwają (na końcu zadania potoku) bezpieczny plik.

To zadanie obecnie obsługuje 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, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
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 w formie tabeli settable	To zadanie ma uprawnienia do ustawiania następujących zmiennych: secureFilePath
Wersja agenta	2.182.1 lub nowsza
Kategoria zadania	Narzędzie