Udostępnij przez

Korzystanie z narzędzi transferu danych w usłudze Azure Stack Hub Storage

Azure Stack Hub udostępnia zestaw usług magazynowania obejmujących dyski, bloki blob, tabele, kolejki i funkcje zarządzania kontami. Niektóre narzędzia usługi Azure Storage są dostępne, jeśli chcesz zarządzać danymi lub przenosić je do lub z usługi Azure Stack Hub Storage. Ten artykuł zawiera omówienie dostępnych narzędzi.

Wymagania określają, które z następujących narzędzi najlepiej sprawdza się w Twoim przypadku:

  • AzCopy: narzędzie wiersza polecenia specyficzne dla magazynu, które można pobrać, aby skopiować dane z jednego obiektu do innego obiektu w ramach kont magazynu lub między nimi.
  • Azure PowerShell: powłoka wiersza polecenia i język skryptowy oparty na zadaniach, zaprojektowany specjalnie do administracji systemami.
  • Interfejs wiersza polecenia platformy Azure: wieloplatformowe narzędzie typu open source, które udostępnia zestaw poleceń do pracy z platformami Azure i Azure Stack Hub.
  • Eksplorator usługi Microsoft Azure Storage: łatwa w użyciu aplikacja autonomiczna z interfejsem użytkownika.
  • Blobfuse: wirtualny sterownik systemu plików dla usługi Azure Blob Storage, który umożliwia dostęp do istniejących danych blokowych na koncie magazynu przez system plików Linux.

Ze względu na różnice usług magazynowania między platformą Azure i usługą Azure Stack Hub może istnieć pewne specyficzne wymagania dotyczące każdego narzędzia opisanego w poniższych sekcjach. Aby porównać Azure Stack Hub Storage i Azure Storage, zobacz Azure Stack Hub Storage: Differences and considerations.

AzCopy

AzCopy to narzędzie wiersza polecenia przeznaczone do kopiowania danych do i z magazynu obiektów blob i tabel platformy Microsoft Azure przy użyciu prostych poleceń z optymalną wydajnością. Możesz skopiować dane z jednego obiektu do innego w obrębie lub między kontami przechowywania.

Pobieranie i instalowanie narzędzia AzCopy

Pobierz narzędzie AzCopy w wersji 10+.

Konfiguracja i limity narzędzia AzCopy 10.1

Narzędzie AzCopy 10.1 można teraz skonfigurować do korzystania ze starszych wersji interfejsu API. Umożliwia to (ograniczoną) obsługę usługi Azure Stack Hub. Aby skonfigurować wersję interfejsu API dla narzędzia AzCopy do obsługi usługi Azure Stack Hub, ustaw zmienną AZCOPY_DEFAULT_SERVICE_API_VERSION środowiskową na 2017-11-09.

System operacyjny Komenda
Windows W wierszu polecenia użyj polecenia: set AZCOPY_DEFAULT_SERVICE_API_VERSION=2017-11-09
W programie PowerShell użyj: $env:AZCOPY_DEFAULT_SERVICE_API_VERSION="2017-11-09"
Linux export AZCOPY_DEFAULT_SERVICE_API_VERSION=2017-11-09
MacOS export AZCOPY_DEFAULT_SERVICE_API_VERSION=2017-11-09

W narzędziu AzCopy 10.1 obsługiwane są następujące funkcje w usłudze Azure Stack Hub:

Funkcja Obsługiwane akcje
Zarządzanie kontenerem Tworzenie kontenera
Wyświetlanie zawartości kontenerów
Zarządzanie zadaniem Wyświetlanie zadań
Wznawianie zadania
Usuń obiekt blob Usuń pojedynczy blob
Usuwanie całego lub częściowego katalogu wirtualnego
Przekaż plik Przekazywanie pliku
Przekazywanie katalogu
Przekazywanie zawartości katalogu
Pobierz plik Pobieranie pliku
Pobieranie katalogu
Pobieranie zawartości katalogu
Synchronizowanie pliku Synchronizowanie kontenera z lokalnym systemem plików
Synchronizowanie lokalnego systemu plików z kontenerem

Uwaga / Notatka

Usługa Azure Stack Hub nie obsługuje dostarczania poświadczeń autoryzacji do narzędzia AzCopy przy użyciu identyfikatora Entra firmy Microsoft. Musisz uzyskać dostęp do obiektów magazynu w usłudze Azure Stack Hub przy użyciu tokenu sygnatury dostępu współdzielonego (SAS). Usługa Azure Stack Hub nie obsługuje synchronicznego transferu danych między dwiema lokalizacjami obiektów blob usługi Azure Stack Hub oraz między usługą Azure Storage i usługą Azure Stack Hub. Nie można użyć azcopy cp polecenia , aby przenieść dane z usługi Azure Stack Hub do usługi Azure Storage (lub odwrotnie) bezpośrednio za pomocą narzędzia AzCopy 10.1.

Przykłady poleceń narzędzia AzCopy na potrzeby transferu danych

Poniższe przykłady są zgodne z typowymi scenariuszami kopiowania danych do i z obiektów blob usługi Azure Stack Hub. Aby dowiedzieć się więcej, zobacz Wprowadzenie do narzędzia AzCopy.

Pobierz wszystkie bloby na dysk lokalny

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" "/path/to/dir" --recursive=true

Przekazywanie pojedynczego pliku do katalogu wirtualnego

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Znane problemy z narzędziem AzCopy

  • Żadna operacja narzędzia AzCopy w magazynie plików nie jest dostępna, ponieważ magazyn plików nie jest jeszcze dostępny w usłudze Azure Stack Hub.
  • Jeśli chcesz przesyłać dane między dwiema lokalizacjami obiektów blob usługi Azure Stack Hub lub między usługami Azure Stack Hub i Azure Storage przy użyciu narzędzia AzCopy 10.1, najpierw pobierz dane do lokalizacji lokalnej, a następnie przekaż ponownie do katalogu docelowego w usłudze Azure Stack Hub lub Azure Storage.
  • Wersja narzędzia AzCopy dla systemu Linux obsługuje tylko aktualizację 1802 lub nowsze wersje; nie obsługuje usługi Table Service.
  • Jeśli chcesz skopiować dane do i z usługi Azure Table Storage, możesz użyć programu PowerShell, interfejsu wiersza polecenia lub bibliotek klienckich platformy Azure.

Azure PowerShell

Azure PowerShell to moduł, który udostępnia polecenia cmdlet do zarządzania usługami na platformie Azure i w usłudze Azure Stack Hub. Jest to oparta na zadaniach powłoka wiersza polecenia i język skryptowy przeznaczony specjalnie do administrowania systemem.

Instalowanie i konfigurowanie programu PowerShell dla usługi Azure Stack Hub

Moduły programu Azure PowerShell zgodne z usługą Azure Stack Hub są wymagane do pracy z usługą Azure Stack Hub. Aby uzyskać więcej informacji, zobacz Instalowanie programu PowerShell dla usługi Azure Stack Hub i Konfigurowanie środowiska programu PowerShell użytkownika usługi Azure Stack Hub.

Przykładowy skrypt programu PowerShell dla usługi Azure Stack Hub

W tym przykładzie założono, że pomyślnie zainstalowano program PowerShell dla usługi Azure Stack Hub. Ten skrypt pomoże Ci ukończyć konfigurację i poprosić o podanie poświadczeń dzierżawy usługi Azure Stack Hub w celu dodania konta do lokalnego środowiska programu PowerShell. Następnie skrypt ustawi domyślną subskrypcję platformy Azure, utworzy nowe konto magazynu na platformie Azure, utworzy nowy kontener na tym nowym koncie magazynu i przekaże istniejący plik obrazu (blob) do tego kontenera. Po wyświetleniu listy wszystkich obiektów blob w tym kontenerze, skrypt utworzy nowy katalog docelowy na komputerze lokalnym i pobierze plik obrazu.

  1. Zainstaluj moduły programu Azure PowerShell zgodne z usługą Azure Stack Hub .
  2. Pobierz narzędzia wymagane do pracy z usługą Azure Stack Hub.
  3. Otwórz program Windows PowerShell ISE i Uruchom jako administrator, a następnie kliknij pozycję Plik>nowy , aby utworzyć nowy plik skryptu.
  4. Skopiuj poniższy skrypt i wklej go do nowego pliku skryptu.
  5. Zaktualizuj zmienne skryptu na podstawie ustawień konfiguracji.

    Uwaga / Notatka

    Ten skrypt musi zostać uruchomiony w katalogu głównym dla AzureStack_Tools.

# begin

$ARMEvnName = "AzureStackUser" # set AzureStackUser as your Azure Stack Hub environment name
$ARMEndPoint = "https://management.local.azurestack.external" 
$GraphAudience = "https://graph.windows.net/" 
$AADTenantName = "<myDirectoryTenantName>.onmicrosoft.com" 

$SubscriptionName = "basic" # Update with the name of your subscription.
$ResourceGroupName = "myTestRG" # Give a name to your new resource group.
$StorageAccountName = "azsblobcontainer" # Give a name to your new storage account. It must be lowercase.
$Location = "Local" # Choose "Local" as an example.
$ContainerName = "photo" # Give a name to your new container.
$ImageToUpload = "C:\temp\Hello.jpg" # Prepare an image file and a source directory in your local computer.
$DestinationFolder = "C:\temp\download" # A destination directory in your local computer.

# Import the Connect PowerShell module"
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
Import-Module .\Connect\AzureStack.Connect.psm1

# Configure the PowerShell environment
# Register an Az environment that targets your Azure Stack Hub instance
Add-AzEnvironment -Name $ARMEvnName -ARMEndpoint $ARMEndPoint 

# Login
$TenantID = Get-AzsDirectoryTenantId -AADTenantName $AADTenantName -EnvironmentName $ARMEvnName
Connect-AzAccount -EnvironmentName $ARMEvnName -TenantId $TenantID 

# Set a default Azure subscription.
Select-AzSubscription -SubscriptionName $SubscriptionName

# Create a new Resource Group 
New-AzResourceGroup -Name $ResourceGroupName -Location $Location

# Create a new storage account.
New-AzStorageAccount -ResourceGroupName $ResourceGroupName -Name $StorageAccountName -Location $Location -Type Standard_LRS

# Set a default storage account.
Set-AzCurrentStorageAccount -StorageAccountName $StorageAccountName -ResourceGroupName $ResourceGroupName 

# Create a new container.
New-AzStorageContainer -Name $ContainerName -Permission Off

# Upload a blob into a container.
Set-AzStorageBlobContent -Container $ContainerName -File $ImageToUpload

# List all blobs in a container.
Get-AzStorageBlob -Container $ContainerName

# Download blobs from the container:
# Get a reference to a list of all blobs in a container.
$blobs = Get-AzStorageBlob -Container $ContainerName

# Create the destination directory.
New-Item -Path $DestinationFolder -ItemType Directory -Force  

# Download blobs into the local destination directory.
$blobs | Get-AzureStorageBlobContent -Destination $DestinationFolder

# end

Znane problemy dotyczące programu PowerShell

różnica Get-AzStorageAccountKey

Bieżąca zgodna wersja modułu azure PowerShell dla usługi Azure Stack Hub to 1.2.11 dla operacji użytkownika. Różni się ona od najnowszej wersji programu Azure PowerShell. Ta różnica ma wpływ na operację usług magazynowania w następujący sposób:

Format wartości zwracanej Get-AzStorageAccountKey w wersji 1.2.11 ma dwie właściwości: Key1 i Key2, podczas gdy bieżąca wersja platformy Azure zwraca tablicę zawierającą wszystkie klucze konta.

# This command gets a specific key for a storage account, 
# and works for Azure PowerShell version 1.4, and later versions.
(Get-AzStorageAccountKey -ResourceGroupName "RG01" `
-AccountName "MyStorageAccount").Value[0]

# This command gets a specific key for a storage account, 
# and works for Azure PowerShell version 1.3.2, and previous versions.
(Get-AzStorageAccountKey -ResourceGroupName "RG01" `
-AccountName "MyStorageAccount").Key1

Aby uzyskać więcej informacji, zobacz Get-AzureRMStorageAccountKey.

Kopiowanie obiektu blob między klastrami usługi Azure Stack Hub

Start-AzStorageBlobCopy może zostać użyty do uruchomienia zadania kopiowania w celu przeniesienia obiektu blob. Podczas ustawiania właściwości AbsoluteUri jako identyfikatora URI obiektu blob w innym klastrze usługi Azure Stack Hub to polecenie cmdlet może służyć do kopiowania obiektu blob między dwoma klastrami usługi Azure Stack Hub. Upewnij się, że źródłowe i docelowe klastry usługi Azure Stack Hub znajdują się w tej samej wersji aktualizacji. Usługa Azure Stack Hub obecnie nie obsługuje kopiowania za pomocą Start-AzStorageBlobCopy obiektów blob między dwoma klastrami usługi Azure Stack Hub, które mają wdrożone różne wersje aktualizacji.

Azure CLI (Interfejs wiersza polecenia platformy Azure)

Interfejs wiersza polecenia Azure to narzędzie do zarządzania zasobami Azure. Można go zainstalować w systemach macOS, Linux i Windows i uruchomić go z poziomu wiersza polecenia.

Interfejs wiersza polecenia platformy Azure jest zoptymalizowany pod kątem zarządzania zasobami platformy Azure i administrowania nimi z poziomu wiersza polecenia oraz tworzenia skryptów automatyzacji, które działają względem usługi Azure Resource Manager. Zapewnia wiele tych samych funkcji znalezionych w portalu usługi Azure Stack Hub, w tym bogaty dostęp do danych.

Usługa Azure Stack Hub wymaga interfejsu wiersza polecenia platformy Azure w wersji 2.0 lub nowszej. Aby uzyskać więcej informacji na temat instalowania i konfigurowania interfejsu wiersza polecenia platformy Azure za pomocą usługi Azure Stack Hub, zobacz Instalowanie i konfigurowanie interfejsu wiersza polecenia usługi Azure Stack Hub. Aby uzyskać więcej informacji na temat używania interfejsu wiersza polecenia platformy Azure do wykonywania kilku zadań roboczych z zasobami na koncie magazynu usługi Azure Stack Hub, zobacz Korzystanie z interfejsu wiersza polecenia platformy Azure z usługą Azure Storage.

Przykładowy skrypt interfejsu wiersza polecenia platformy Azure dla usługi Azure Stack Hub

Po zakończeniu instalacji i konfiguracji interfejsu wiersza polecenia możesz spróbować wykonać poniższe kroki, aby pracować z niewielkim przykładowym skryptem powłoki w celu interakcji z zasobami magazynu usługi Azure Stack Hub. Skrypt wykonuje następujące akcje:

  • Tworzy nowy kontener w Twoim koncie magazynowym.
  • Przesyła istniejący plik (jako blob) do kontenera.
  • Wyświetla listę wszystkich obiektów blob w kontenerze.
  • Pobiera plik do miejsca docelowego na określonym komputerze lokalnym.

Przed uruchomieniem tego skryptu upewnij się, że możesz pomyślnie nawiązać połączenie i zalogować się do docelowego centrum usługi Azure Stack Hub.

  1. Otwórz ulubiony edytor tekstów, a następnie skopiuj i wklej poprzedni skrypt do edytora.
  2. Zaktualizuj zmienne skryptu, aby odzwierciedlały ustawienia konfiguracji.
  3. Po zaktualizowaniu niezbędnych zmiennych zapisz skrypt i zamknij edytor. W następnych krokach założono, że nazwano skrypt my_storage_sample.sh.
  4. W razie potrzeby oznacz skrypt jako plik wykonywalny: chmod +x my_storage_sample.sh
  5. Uruchom skrypt. Na przykład w języku Bash: ./my_storage_sample.sh
#!/bin/bash
# A simple Azure Stack Hub storage example script

export AZURESTACK_RESOURCE_GROUP=<resource_group_name>
export AZURESTACK_RG_LOCATION="local"
export AZURESTACK_STORAGE_ACCOUNT_NAME=<storage_account_name>
export AZURESTACK_STORAGE_CONTAINER_NAME=<container_name>
export AZURESTACK_STORAGE_BLOB_NAME=<blob_name>
export FILE_TO_UPLOAD=<file_to_upload>
export DESTINATION_FILE=<destination_file>

echo "Creating the resource group..."
az group create --name $AZURESTACK_RESOURCE_GROUP --location $AZURESTACK_RG_LOCATION

echo "Creating the storage account..."
az storage account create --name $AZURESTACK_STORAGE_ACCOUNT_NAME --resource-group $AZURESTACK_RESOURCE_GROUP --account-type Standard_LRS

echo "Creating the blob container..."
az storage container create --name $AZURESTACK_STORAGE_CONTAINER_NAME --account-name $AZURESTACK_STORAGE_ACCOUNT_NAME

echo "Uploading the file..."
az storage blob upload --container-name $AZURESTACK_STORAGE_CONTAINER_NAME --file $FILE_TO_UPLOAD --name $AZURESTACK_STORAGE_BLOB_NAME --account-name $AZURESTACK_STORAGE_ACCOUNT_NAME

echo "Listing the blobs..."
az storage blob list --container-name $AZURESTACK_STORAGE_CONTAINER_NAME --account-name $AZURESTACK_STORAGE_ACCOUNT_NAME --output table

echo "Downloading the file..."
az storage blob download --container-name $AZURESTACK_STORAGE_CONTAINER_NAME --account-name $AZURESTACK_STORAGE_ACCOUNT_NAME --name $AZURESTACK_STORAGE_BLOB_NAME --file $DESTINATION_FILE --output table

echo "Done"

Eksplorator usługi Microsoft Azure Storage

Eksplorator usługi Azure Storage to autonomiczna aplikacja firmy Microsoft. Umożliwia ona łatwą pracę zarówno z danymi usługi Azure Storage, jak i usługi Azure Stack Hub Storage na komputerach z systemami Windows, macOS i Linux. Jeśli chcesz łatwo zarządzać danymi usługi Azure Stack Hub Storage, rozważ użycie Eksploratora usługi Microsoft Azure Storage.

Blobfuse

Blobfuse to wirtualny sterownik systemu plików dla usługi Azure Blob Storage, który umożliwia dostęp do istniejących danych blokowych obiektów na koncie magazynu za pośrednictwem systemu plików Linux. Usługa Azure Blob Storage jest usługą magazynu obiektów i dlatego nie ma hierarchicznej przestrzeni nazw. Blobfuse udostępnia tę przestrzeń nazw przy użyciu schematu katalogu wirtualnego z użyciem ukośnika / do przodu jako ogranicznika. System Blobfuse działa zarówno na platformie Azure, jak i w usłudze Azure Stack Hub.

Aby dowiedzieć się więcej na temat instalowania magazynu obiektów blob jako systemu plików przy użyciu systemu Blobfuse w systemie Linux, zobacz How to mount Blob Storage as a file system with Blobfuse (Jak zainstalować magazyn obiektów blob jako system plików przy użyciu systemu Blobfuse).

W przypadku usługi Azure Stack Hub należy określić blobEndpoint podczas konfigurowania poświadczeń konta magazynu wraz z danymi accountName, accountKey/sasToken i containerName.

W zestawie Azure Stack Development Kit (ASDK) obiekt blobEndpoint powinien mieć wartość myaccount.blob.local.azurestack.external. W zintegrowanym systemie usługi Azure Stack Hub skontaktuj się z administratorem chmury, jeśli nie masz pewności co do punktu końcowego.

accountKey i sasToken można skonfigurować tylko raz. Gdy podany jest klucz konta magazynu, plik konfiguracji poświadczeń ma następujący format:

accountName myaccount 
accountKey myaccesskey== 
containerName mycontainer 
blobEndpoint myaccount.blob.local.azurestack.external

Po podaniu tokenu dostępu współdzielonego plik konfiguracji poświadczeń ma następujący format:

accountName myaccount 
sasToken ?mysastoken 
containerName mycontainer 
blobEndpoint myaccount.blob.local.azurestack.external

Dalsze kroki

  • Last updated on