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

Artykuł
2025-04-08

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.

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

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.

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.

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.

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/

Zaimportuj certyfikat do magazynu głównego CurrentUser:

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

- powershell: |
    $certPath = '$(caCertificate.secureFilePath)'
    $certStoreLocation = 'Cert:\CurrentUser\Root'

    Write-Host "Importing certificate $certPath to $certStoreLocation..."
    $params = @{
        FilePath = $certPath
        CertStoreLocation = $certStoreLocation
    }
    Import-Certificate @params
  displayName: 'Import CA certificate to CurrentUser root store'

Zaimportuj certyfikat do magazynu głównego LocalMachine:

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

- powershell: |
    $certPath = '$(caCertificate.secureFilePath)'
    $certStoreLocation = 'Cert:\LocalMachine\Root'

    Write-Host "Importing certificate $certPath to $certStoreLocation..."
    $params = @{
        FilePath = $certPath
        CertStoreLocation = $certStoreLocation
    }
    Import-Certificate @params
  displayName: 'Import CA certificate to LocalMachine root store'

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ść

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ń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	2.116.0 lub nowsza
Kategoria zadań	Użyteczność

Udostępnij za pośrednictwem