Menggunakan alat transfer data di Azure Stack Hub Storage

Azure Stack Hub menyediakan serangkaian layanan penyimpanan untuk disk, blob, tabel, antrean, dan fungsi manajemen akun. Beberapa alat Azure Storage tersedia jika Anda ingin mengelola atau memindahkan data ke atau dari Azure Stack Hub Storage. Artikel ini menyediakan gambaran umum tentang alat yang tersedia.

Persyaratan Anda menentukan alat mana yang paling sesuai untuk Anda:

  • AzCopy: Utilitas baris perintah khusus penyimpanan yang dapat Anda unduh untuk menyalin data dari satu objek ke objek lain di dalam atau di antara akun penyimpanan Anda.
  • Azure PowerShell: Bahasa shell dan skrip baris perintah berbasis tugas yang dirancang khusus untuk administrasi sistem.
  • Azure CLI: Alat lintas platform sumber terbuka yang menyediakan serangkaian perintah untuk bekerja dengan platform Azure dan Azure Stack Hub.
  • Microsoft Azure Storage Explorer: Aplikasi mandiri yang mudah digunakan dengan antarmuka pengguna.
  • Blobfuse: Driver sistem file virtual untuk Azure Blob Storage, yang memungkinkan Anda mengakses data blob blok yang ada di akun penyimpanan Anda melalui sistem file Linux.

Karena perbedaan layanan penyimpanan antara Azure dan Azure Stack Hub, mungkin ada beberapa persyaratan khusus untuk setiap alat yang dijelaskan di bagian berikut. Untuk perbandingan antara Azure Stack Hub Storage dan Azure Storage, lihat Azure Stack Hub Storage: Perbedaan dan pertimbangan.

AzCopy

AzCopy adalah utilitas baris perintah yang dirancang untuk menyalin data ke dan dari penyimpanan blob dan tabel Microsoft Azure menggunakan perintah sederhana dengan performa optimal. Anda dapat menyalin data dari satu objek ke objek lain di dalam atau di antara akun penyimpanan Anda.

Mengunduh dan Memasang AzCopy

Unduh AzCopy V10+.

Konfigurasi dan batasan AzCopy 10.1

AzCopy 10.1 sekarang dapat dikonfigurasi untuk menggunakan versi API yang lebih lama. Ini memungkinkan dukungan (terbatas) untuk Azure Stack Hub. Untuk mengonfigurasi versi API untuk AzCopy guna mendukung Azure Stack Hub, atur AZCOPY_DEFAULT_SERVICE_API_VERSION variabel lingkungan ke 2017-11-09.

Sistem operasi Perintah
Windows Dalam command prompt, gunakan: set AZCOPY_DEFAULT_SERVICE_API_VERSION=2017-11-09
Di PowerShell gunakan: $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

Di AzCopy 10.1, fitur berikut ini didukung untuk Azure Stack Hub:

Fitur Tindakan yang didukung
Mengelola kontainer Membuat kontainer
Daftar isi kontainer
Mengelola pekerjaan Tampilkan pekerjaan
Melanjutkan pekerjaan
Menghapus blob Menghapus satu blob
Menghapus seluruh atau sebagian direktori virtual
Mengunggah file Mengunggah file
Mengunggah direktori
Mengunggah konten direktori
Unduh file Unduh sebuah file
Mengunduh direktori
Mengunduh konten direktori
Menyinkronkan file Menyinkronkan kontainer ke sistem file lokal
Menyinkronkan sistem file lokal ke kontainer

Nota

Azure Stack Hub tidak mendukung penyediaan kredensial otorisasi ke AzCopy dengan menggunakan ID Microsoft Entra. Anda harus mengakses objek penyimpanan di Azure Stack Hub menggunakan token Tanda Tangan Akses Bersama (SAS). Azure Stack Hub tidak mendukung transfer data sinkron antara dua lokasi blob Azure Stack Hub, dan antara Azure Storage dan Azure Stack Hub. Anda tidak dapat menggunakan azcopy cp untuk memindahkan data dari Azure Stack Hub ke Azure Storage (atau sebaliknya) langsung dengan AzCopy 10.1.

Contoh perintah AzCopy untuk transfer data

Contoh berikut mengikuti skenario umum untuk menyalin data ke dan dari blob Azure Stack Hub. Untuk mempelajari selengkapnya, lihat Mulai menggunakan AzCopy.

Mengunduh semua blob ke disk lokal

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

Mengunggah file tunggal ke direktori virtual

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

Masalah yang diketahui AzCopy

  • Operasi AzCopy apa pun pada penyimpanan file tidak tersedia karena penyimpanan file belum tersedia di Azure Stack Hub.
  • Jika Anda ingin mentransfer data antara dua lokasi blob Azure Stack Hub, atau antara Azure Stack Hub dan Azure Storage dengan menggunakan AzCopy 10.1, unduh data ke lokasi lokal terlebih dahulu, lalu unggah lagi ke direktori target di Azure Stack Hub atau Azure Storage.
  • Versi Linux AzCopy hanya mendukung pembaruan 1802 atau versi yang lebih baru; ini tidak mendukung layanan Tabel.
  • Jika Anda ingin menyalin data ke dan dari layanan Azure Table Storage, Anda bisa menggunakan PowerShell, CLI, atau pustaka klien Azure.

Azure PowerShell

Azure PowerShell adalah modul yang menyediakan cmdlet untuk mengelola layanan di Azure dan Azure Stack Hub. Ini adalah bahasa shell dan skrip baris perintah berbasis tugas yang dirancang khusus untuk administrasi sistem.

Menginstal dan Mengonfigurasi PowerShell untuk Azure Stack Hub

Modul Azure PowerShell yang kompatibel dengan Azure Stack Hub diperlukan untuk bekerja dengan Azure Stack Hub. Untuk informasi selengkapnya, lihat Menginstal PowerShell untuk Azure Stack Hub dan Mengonfigurasi lingkungan PowerShell pengguna Azure Stack Hub.

Skrip Sampel PowerShell untuk Azure Stack Hub

Sampel ini mengasumsikan Anda telah berhasil Menginstal PowerShell untuk Azure Stack Hub. Skrip ini akan membantu Anda menyelesaikan konfigurasi dan meminta kredensial penyewa Azure Stack Hub Anda untuk menambahkan akun Anda ke lingkungan PowerShell lokal. Skrip kemudian akan mengatur langganan Azure default, membuat akun penyimpanan baru di Azure, membuat kontainer baru di akun penyimpanan baru ini, dan mengunggah file gambar (blob) yang sudah ada ke kontainer tersebut. Setelah skrip mencantumkan semua blob dalam kontainer tersebut, skrip akan membuat direktori tujuan baru di komputer lokal Anda dan mengunduh file gambar.

  1. Instal modul Azure PowerShell yang kompatibel dengan Azure Stack Hub.
  2. Unduh alat yang diperlukan untuk bekerja dengan Azure Stack Hub.
  3. Buka Windows PowerShell ISE dan Jalankan sebagai Administrator, lalu klik File>Baru untuk membuat file skrip baru.
  4. Salin skrip di bawah ini dan tempelkan ke file skrip baru.
  5. Perbarui variabel skrip berdasarkan pengaturan konfigurasi Anda.

    Nota

    Skrip ini harus dijalankan di direktori akar untuk 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

Masalah yang diketahui PowerShell

perbedaan Get-AzStorageAccountKey

Versi modul Azure PowerShell yang kompatibel saat ini untuk Azure Stack Hub adalah 1.2.11 untuk operasi pengguna. Ini berbeda dari versi terbaru Azure PowerShell. Perbedaan ini berdampak pada operasi layanan penyimpanan dengan cara berikut:

Format Get-AzStorageAccountKey nilai yang dikembalikan dalam versi 1.2.11 memiliki dua properti: Key1 dan Key2, sementara versi Azure saat ini mengembalikan array yang berisi semua kunci akun.

# 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

Untuk informasi selengkapnya, lihat Get-AzureRMStorageAccountKey.

Menyalin blob antara kluster Azure Stack Hub

Start-AzStorageBlobCopy dapat digunakan untuk memulai pekerjaan penyalinan untuk memindahkan blob. Saat mengatur properti AbsoluteUri sebagai uri blob pada kluster Azure Stack Hub lain, cmdlet ini dapat digunakan untuk menyalin blob di antara dua kluster Azure Stack Hub. Pastikan kluster Azure Stack Hub sumber dan tujuan berada pada versi pembaruan yang sama. Azure Stack Hub saat ini tidak mendukung penggunaan Start-AzStorageBlobCopy untuk menyalin blob antara dua kluster Azure Stack Hub yang telah menyebarkan versi pembaruan yang berbeda.

Azure CLI (antarmuka baris perintah Azure)

Azure CLI adalah pengalaman baris perintah Azure untuk mengelola sumber daya Azure. Anda dapat menginstalnya di macOS, Linux, dan Windows dan menjalankannya dari baris perintah.

Azure CLI dioptimalkan untuk mengelola dan mengelola sumber daya Azure dari baris perintah, dan untuk membangun skrip otomatisasi yang berfungsi terhadap Azure Resource Manager. Ini menyediakan banyak fungsi yang sama yang ditemukan di portal Azure Stack Hub, termasuk akses data yang kaya.

Azure Stack Hub memerlukan Azure CLI versi 2.0 atau yang lebih baru. Untuk informasi selengkapnya tentang menginstal dan mengonfigurasi Azure CLI dengan Azure Stack Hub, lihat Menginstal dan mengonfigurasi Azure Stack Hub CLI. Untuk informasi selengkapnya tentang cara menggunakan Azure CLI untuk melakukan beberapa tugas yang bekerja dengan sumber daya di akun penyimpanan Azure Stack Hub Anda, lihat Menggunakan Azure CLI dengan penyimpanan Azure.

Skrip sampel Azure CLI untuk Azure Stack Hub

Setelah menyelesaikan penginstalan dan konfigurasi CLI, Anda dapat mencoba langkah-langkah berikut untuk bekerja dengan skrip sampel shell kecil untuk berinteraksi dengan sumber daya penyimpanan Azure Stack Hub. Skrip menyelesaikan tindakan berikut:

  • Membuat kontainer baru di akun penyimpanan Anda.
  • Mengunggah file yang ada (sebagai blob) ke kontainer.
  • Mencantumkan semua blob dalam kontainer.
  • Mengunduh file ke tujuan di komputer lokal yang Anda tentukan.

Sebelum menjalankan skrip ini, pastikan Anda dapat berhasil menyambungkan dan masuk ke Azure Stack Hub target.

  1. Buka editor teks favorit Anda, lalu salin dan tempel skrip sebelumnya ke editor.
  2. Perbarui variabel skrip untuk mencerminkan pengaturan konfigurasi Anda.
  3. Setelah Memperbarui variabel yang diperlukan, simpan skrip, dan keluar dari editor Anda. Langkah berikutnya mengasumsikan Anda telah menamai skrip Anda my_storage_sample.sh.
  4. Tandai skrip sebagai dapat dieksekusi, jika perlu: chmod +x my_storage_sample.sh
  5. Jalankan skrip. Misalnya, di 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"

Penjelajah Penyimpanan Microsoft Azure

Azure Storage Explorer adalah aplikasi mandiri dari Microsoft. Ini memungkinkan Anda untuk dengan mudah bekerja dengan data Azure Storage dan Azure Stack Hub Storage di komputer Windows, macOS, dan Linux. Jika Anda menginginkan cara mudah untuk mengelola data Azure Stack Hub Storage Anda, pertimbangkan untuk menggunakan Microsoft Azure Storage Explorer.

Blobfuse

Blobfuse adalah driver sistem file virtual untuk Azure Blob Storage, yang memungkinkan Anda mengakses data blob blok yang ada di akun penyimpanan Anda melalui sistem file Linux. Azure Blob Storage adalah layanan penyimpanan objek dan oleh karena itu tidak memiliki namespace hierarkis. Blobfuse menyediakan namespace layanan ini menggunakan skema direktori virtual dengan penggunaan garis miring / sebagai pemisah. Blobfuse berfungsi di Azure dan Azure Stack Hub.

Untuk mempelajari selengkapnya tentang memasang penyimpanan blob sebagai sistem file dengan Blobfuse di Linux, lihat Cara memasang penyimpanan Blob sebagai sistem file dengan Blobfuse.

Untuk Azure Stack Hub, blobEndpoint perlu ditentukan saat mengonfigurasi info masuk akun penyimpanan Anda bersama dengan accountName, accountKey/sasToken, dan containerName.

Dalam Azure Stack Development Kit (ASDK), blobEndpoint harus myaccount.blob.local.azurestack.external. Di sistem terintegrasi Azure Stack Hub, hubungi admin cloud Anda jika Anda tidak yakin tentang titik akhir Anda.

accountKey dan sasToken hanya dapat dikonfigurasi satu per satu. Saat kunci akun penyimpanan diberikan, file konfigurasi kredensial dalam format berikut:

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

Saat token akses bersama diberikan, file konfigurasi kredensial dalam format berikut:

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

Langkah selanjutnya

  • Terakhir diperbarui pada