Udostępnij za pośrednictwem

AzureFileCopy@2 — zadanie kopiowania plików platformy Azure w wersji 2

  • Artykuł

Kopiowanie plików do usługi Azure Blob Storage lub maszyn wirtualnych.

To zadanie zostało uznane za przestarzałe, ponieważ ta wersja zadania AzureFileCopy używa wycofanej wersji narzędzia AzCopy. Użyj najnowszej wersji zadania AzureFileCopy. Zobacz Przewodnik migracji narzędzia AzCopy dla wersji 8 do 10.

Uwaga

To zadanie nie obsługuje uwierzytelniania przy użyciu usługi Azure Resource Manager z federacją tożsamości przepływu pracy.

Kopiowanie plików do usługi Azure Blob Storage lub maszyn wirtualnych.

Uwaga

To zadanie nie obsługuje uwierzytelniania przy użyciu usługi Azure Resource Manager z federacją tożsamości przepływu pracy.

Składnia

# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.

Dane wejściowe

źródła SourcePath -
string. To jest wymagane.

Określ ścieżkę bezwzględną do folderu źródłowego, pliku na komputerze lokalnym lub udziału UNC. Określona wartość lub wyrażenie powinny zwracać pojedynczą nazwę folderu lub nazwę pliku.


azureConnectionType - typ połączenia platformy Azure
Alias wejściowy: ConnectedServiceNameSelector. string. Dozwolone wartości: ConnectedServiceName (wersja klasyczna platformy Azure), ConnectedServiceNameARM (Azure Resource Manager). Wartość domyślna: ConnectedServiceNameARM.

Określ typ połączenia platformy Azure.


azureClassicSubscription - klasycznej subskrypcji platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

Określ docelową klasyczną subskrypcję platformy Azure.


azureSubscription - subskrypcji platformy Azure
Alias wejściowy: ConnectedServiceNameARM. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameARM.

Określ docelową subskrypcję usługi Azure Resource Manager.


Destination - typ docelowy
string. To jest wymagane. Dozwolone wartości: AzureBlob (Azure Blob), AzureVMs (maszyny wirtualne platformy Azure).

Określ typ docelowy, który ma być używany do kopiowania plików.


klasycznego konta magazynu classicStorage -
Alias wejściowy: StorageAccount. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

Określ istniejące wcześniej klasyczne konto magazynu. Jest to konto magazynu używane jako pośrednik do kopiowania plików na maszyny wirtualne platformy Azure.


storage - konta magazynu usługi RM
Alias wejściowy: StorageAccountRM. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameARM.

Określ istniejące wcześniej konto magazynu usługi ARM. Jest to konto magazynu używane jako pośrednik do kopiowania plików na maszyny wirtualne platformy Azure.


ContainerName - nazwa kontenera
string. Wymagane, gdy Destination = AzureBlob.

Określ nazwę kontenera, do którego są kopiowane pliki. Jeśli określony kontener nie istnieje na koncie magazynu, zostanie utworzony.

Aby utworzyć katalog wirtualny wewnątrz kontenera, użyj danych wejściowych prefiksu obiektu blob. Na przykład dla lokalizacji docelowej https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/określ nazwę kontenera mycontainer i prefiks obiektów blob vd1/vd2.


prefiks BlobPrefix - obiektów blob
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureBlob.

Określ prefiks, który może służyć do filtrowania plików.

Przykład: możesz dołączyć numer kompilacji, aby filtrować pliki ze wszystkich obiektów blob przy użyciu tego samego numeru kompilacji.

Przykład: jeśli określisz prefiks obiektu blob myvd1, katalog wirtualny zostanie utworzony wewnątrz kontenera. Pliki są kopiowane ze źródła do https://myaccount.blob.core.windows.net/mycontainer/myvd1/.


usługi w chmurze cloudService -
Alias wejściowy: EnvironmentName. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Określ nazwę docelowej usługi w chmurze.


resourceGroup - grupy zasobów
Alias wejściowy: EnvironmentNameRM. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Określ nazwę docelowej grupy zasobów.


ResourceFilteringMethod - wybierz maszyny według
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Dozwolone wartości: machineNames (nazwy maszyn), tags. Wartość domyślna: machineNames.

Określ nazwę hosta lub tag maszyny wirtualnej, który identyfikuje podzbiór maszyn wirtualnych w grupie zasobów. tagi są obsługiwane tylko dla zasobów utworzonych za pośrednictwem usługi Azure Resource Manager.


MachineNames - kryteria filtrowania
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs.

Podaj listę nazw hostów maszyn wirtualnych platformy Azure, takich jak ffweb, ffdblub tagi, takie jak Role:DB, Web, OS:Win8.1.

Uwaga: prawidłowe ograniczniki dla tagów to ,(przecinek), :(colon) i ;(semicolon). W przypadku podawania wielu tagów zadanie zostanie uruchomione na wszystkich maszynach wirtualnych, które zawierają określone tagi. Domyślnie zadanie jest uruchamiane na wszystkich maszynach wirtualnych.


logowania administratora vmsAdminUserName -
string. Wymagane, gdy Destination = AzureVMs.

Podaj nazwę użytkownika konta administratora maszyny wirtualnej platformy Azure.


haseł vmsAdminPassword -
string. Wymagane, gdy Destination = AzureVMs.

Podaj hasło dla konta administratora maszyny wirtualnej platformy Azure.

Prawidłowe dane wejściowe obejmują zmienne zdefiniowane w potokach kompilacji lub wydania, takie jak $(passwordVariable). Aby zabezpieczyć hasło, oznacz je jako secret.


folderu docelowego TargetPath -
string. Wymagane, gdy Destination = AzureVMs.

Określ ścieżkę lokalną na docelowych maszynach wirtualnych.

Prawidłowe dane wejściowe obejmują zmienne środowiskowe, takie jak $env:windir\BudgetIT\Web.


AdditionalArgumentsForBlobCopy - opcjonalnych argumentów (do przekazywania plików do obiektu blob)
string.

Podaj dodatkowe argumenty do AzCopy.exe, które można zastosować podczas przekazywania do obiektów blob, takich jak /NC:10.

Jeśli nie określono żadnych opcjonalnych argumentów, następujące argumenty są domyślnie dodawane.

  • /Y
  • /SetContentType
  • /Z
  • /V
  • /S — dodano, gdy nazwa kontenera nie jest $root.
  • /BlobType:page — dodano, gdy określone konto magazynu jest kontem w warstwie Premium.
  • /Pattern — dodano, gdy ścieżka źródłowa jest plikiem. Dołączone do innych określonych argumentów opcjonalnych.

AdditionalArgumentsForVMCopy - opcjonalnych argumentów (do pobierania plików na maszynę wirtualną)
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs.

Podaj dodatkowe argumenty do AzCopy.exe, które można zastosować podczas pobierania do maszyn wirtualnych, takich jak /NC:10.

Jeśli nie określono żadnych opcjonalnych argumentów, domyślnie są dodawane następujące argumenty.

  • /Y
  • /S
  • /Z
  • /V

enableCopyPrerequisites - włączanie wymagań wstępnych kopiowania
boolean. Opcjonalny. Użyj polecenia , gdy ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Wartość domyślna: false.

Po włączeniu użyje certyfikatu z podpisem własnym do skonfigurowania odbiornika zdalnego zarządzania systemem Windows (WinRM) na porcie 5986 zamiast protokołu HTTPS. Wymagane do wykonywania operacji kopiowania na maszynach wirtualnych platformy Azure. Jeśli docelowe maszyny wirtualne używają modułu równoważenia obciążenia, skonfiguruj reguły NAT dla portu docelowego (5986). Dotyczy tylko maszyn wirtualnych usługi ARM.


CopyFilesInParallel - kopiowanie w równoległych
boolean. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Wartość domyślna: true.

Akceptowanie domyślnego ustawienia kopiuje pliki równolegle do docelowych maszyn wirtualnych.


CleanTargetBeforeCopy - czysty cel
boolean. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Wartość domyślna: false.

Ustawienie tej wartości na true czyści folder docelowy przed wykonaniem akcji kopiowania.


skipCACheck - certyfikatu testowego
boolean. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Wartość domyślna: true.

Wartość domyślna nie sprawdzi, czy certyfikat serwera został podpisany przez zaufany urząd certyfikacji przed nawiązaniem połączenia za pośrednictwem protokołu HTTPS.


outputStorageUri - identyfikator URI kontenera magazynu
string.

Określ nazwę zmiennej używanej dla identyfikatora URI kontenera magazynu, do którego skopiowano pliki. Prawidłowe tylko wtedy, gdy wybrane miejsce docelowe jest obiektem blob platformy Azure.


tokenu SAS kontenera magazynu outputStorageContainerSasToken -
string.

Określ nazwę zmiennej używanej dla tokenu SAS kontenera magazynu, który uzyskuje dostęp do skopiowanych plików. Prawidłowe tylko wtedy, gdy wybrane miejsce docelowe jest obiektem blob platformy Azure.


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

Żaden.

Uwagi

Co nowego w wersji 2.0: korzystanie z nowszej wersji narzędzia AzCopy.

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do uruchamiania zadań korzystających z tego zadania: azureps
możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń Jakikolwiek
zmienne ustawiane Jakikolwiek
Wersja agenta 1.103.0 lub nowsza
Kategoria zadań Zastosuj