Udostępnij za pośrednictwem


DownloadSecureFile@1 — pobieranie zadania bezpiecznego pliku w wersji 1

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

To zadanie służy do pobierania bezpiecznego pliku do lokalizacji tymczasowej na maszynie agenta.

To zadanie służy do pobierania bezpiecznego pliku do tymczasowej lokalizacji na agencie kompilacji lub wydania.

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

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.


retryCount - Liczba ponownych prób
string. Wartość domyślna: 5.

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
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ń Dowolne
Zmienne w formie tabeli settable Dowolne
Wersja agenta 2.116.0 lub nowsza
Kategoria zadania Narzędzie