Szybki start: tworzenie i używanie udziału plików platformy Azure

Azure Files to łatwy w użyciu system plików w chmurze firmy Microsoft. Udziały plików platformy Azure można instalować w systemach Windows, Linux i macOS. W tym przewodniku pokazano, jak utworzyć udział plików SMB platformy Azure przy użyciu modułu Azure Portal, interfejsu wiersza polecenia platformy Azure lub Azure PowerShell.

Dotyczy

Typ udziału plików	SMB	NFS
Udziały plików w warstwie Standardowa (GPv2), LRS/ZRS
Udziały plików w warstwie Standardowa (GPv2), GRS/GZRS
Udziały plików w warstwie Premium (FileStorage), LRS/ZRS

Wymagania wstępne

Portal

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Program PowerShell

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Używanie usługi Azure Cloud Shell

Na platforma Azure hostowane jest Azure Cloud Shell, interaktywne środowisko powłoki, z którego można korzystać w przeglądarce. Do pracy z usługami platformy Azure można używać programu Bash lub PowerShell w środowisku Cloud Shell. Możesz użyć Cloud Shell wstępnie zainstalowanych poleceń, aby uruchomić kod w tym artykule bez konieczności instalowania niczego w środowisku lokalnym.

Aby uruchomić środowisko Azure Cloud Shell:

Opcja	Przykład/link
Wybierz pozycję Wypróbuj w prawym górnym rogu bloku kodu. Wybranie pozycji Wypróbuj nie spowoduje automatycznego skopiowania kodu do środowiska Cloud Shell.
Przejdź do witryny https://shell.azure.com lub wybierz przycisk Uruchom Cloud Shell, aby otworzyć środowisko Cloud Shell w przeglądarce.
Wybierz przycisk Cloud Shell na pasku menu w prawym górnym rogu witryny Azure Portal.

Aby uruchomić kod z tego artykułu w środowisku Azure Cloud Shell:

1. Uruchom usługę Cloud Shell.

2. Wybierz przycisk Kopiuj w bloku kodu, aby skopiować kod.

3. Wklej kod do sesji Cloud Shell, wybierając klawisze Ctrl+Shift+V w systemach Windows i Linux lub wybierając pozycję Cmd+Shift+V w systemie macOS.

4. Naciśnij klawisz Enter, aby uruchomić kod.

Jeśli chcesz zainstalować program PowerShell i używać go lokalnie, ten przewodnik wymaga modułu az Azure PowerShell w wersji 7.0.0 lub nowszej. Aby dowiedzieć się, która wersja modułu Azure PowerShell jest uruchomiona, wykonaj polecenie Get-InstalledModule Az. Jeśli konieczne będzie uaktualnienie, zobacz Instalowanie modułu Azure PowerShell. Jeśli używasz programu PowerShell lokalnie, musisz również uruchomić polecenie Login-AzAccount , aby zalogować się do konta platformy Azure. Aby korzystać z uwierzytelniania wieloskładnikowego, musisz podać identyfikator dzierżawy platformy Azure, taki jak Login-AzAccount -TenantId <TenantId>.

Interfejs wiersza polecenia platformy Azure

Wymagania wstępne

• Użyj środowiska Bash w usłudze Azure Cloud Shell. Aby uzyskać więcej informacji, zobacz Przewodnik Szybki start dotyczący usługi Azure Cloud Shell — Bash.

  

• Jeśli wolisz uruchamiać polecenia referencyjne interfejsu wiersza polecenia lokalnie, zainstaluj interfejs wiersza polecenia platformy Azure. Jeśli korzystasz z systemu Windows lub macOS, rozważ uruchomienie interfejsu wiersza polecenia platformy Azure w kontenerze platformy Docker. Aby uzyskać więcej informacji, zobacz Jak uruchomić interfejs wiersza polecenia platformy Azure w kontenerze platformy Docker.

  • Jeśli korzystasz z instalacji lokalnej, zaloguj się do interfejsu wiersza polecenia platformy Azure za pomocą polecenia az login. Aby ukończyć proces uwierzytelniania, wykonaj kroki wyświetlane w terminalu. Aby uzyskać informacje o innych opcjach logowania, zobacz Logowanie się przy użyciu interfejsu wiersza polecenia platformy Azure.

  • Po wyświetleniu monitu zainstaluj rozszerzenie interfejsu wiersza polecenia platformy Azure przy pierwszym użyciu. Aby uzyskać więcej informacji na temat rozszerzeń, zobacz Korzystanie z rozszerzeń w interfejsie wiersza polecenia platformy Azure.

  • Uruchom polecenie az version, aby znaleźć zainstalowane wersje i biblioteki zależne. Aby uaktualnić do najnowszej wersji, uruchom polecenie az upgrade.

• Ten artykuł wymaga wersji 2.0.4 lub nowszej interfejsu wiersza polecenia platformy Azure. Jeśli korzystasz z usługi Azure Cloud Shell, najnowsza wersja jest już zainstalowana.

• Domyślnie polecenia interfejsu wiersza polecenia platformy Azure zwracają kod JSON (JavaScript Object Notation). Kod JSON to standardowy sposób wysyłania i odbierania komunikatów w ramach komunikacji z interfejsami API REST. W celu ułatwienia pracy z odpowiedziami JSON przykłady w tym artykule korzystają z parametru query w poleceniach interfejsu wiersza polecenia platformy Azure. Ten parametr używa języka zapytań JMESPath do analizowania danych JSON. Aby dowiedzieć się więcej na temat używania wyników poleceń interfejsu wiersza polecenia platformy Azure, zobacz samouczek języka zapytań JMESPath.

Tworzenie konta magazynu

Portal

Konto magazynu to udostępniona pula magazynu, w której można wdrażać udziały plików platformy Azure lub inne zasoby magazynu, takie jak obiekty blob i kolejki. Konto magazynu może zawierać nieograniczoną liczbę udziałów. W udziale można przechowywać nieograniczoną liczbę plików, aż do osiągnięcia limitów pojemności konta magazynu.

Aby utworzyć konto magazynu przy użyciu Azure Portal:

1. W obszarze Usługi platformy Azure wybierz, + aby utworzyć zasób.

2. Wybierz pozycję Konto magazynu , aby utworzyć konto magazynu.

   

3. W obszarze Szczegóły projektu wybierz subskrypcję platformy Azure, w której chcesz utworzyć konto magazynu. Jeśli masz tylko jedną subskrypcję, powinna być ona wartością domyślną.

4. Wybierz pozycję Utwórz nową , aby utworzyć nową grupę zasobów. Wprowadź nazwę myResourceGroup.

5. W obszarze Szczegóły wystąpienia podaj nazwę konta magazynu, taką jak mystorageacct , a następnie kilka losowych liczb, aby była globalnie unikatowa. Nazwa konta magazynu musi zawierać tylko małe litery i cyfry i musi zawierać od 3 do 24 znaków. Zanotuj nazwę konta magazynu. Użyjesz jej później.

6. W obszarze Region wybierz pozycję Wschodnie stany USA.

7. W obszarze Wydajność zachowaj wartość domyślną standardu.

8. W obszarze Nadmiarowość wybierz pozycję Magazyn lokalnie nadmiarowy (LRS).

   

9. Wybierz pozycję Przejrzyj i utwórz , aby przejrzeć ustawienia i utworzyć konto magazynu.

10. Po wyświetleniu powiadomienia Weryfikacja zakończyła się powodzeniem , wybierz pozycję Utwórz. Powinno zostać wyświetlone powiadomienie, że wdrożenie jest w toku.

Program PowerShell

PowerShell — tworzenie grupy zasobów

Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi. Jeśli nie masz jeszcze grupy zasobów platformy Azure, utwórz nową grupę za pomocą polecenia cmdlet New-AzResourceGroup . Do utworzenia konta magazynu potrzebna jest grupa zasobów.

Poniższy przykład tworzy grupę zasobów o nazwie myResourceGroup w regionie Zachodnie stany USA 2:

$resourceGroupName = "myResourceGroup"
$region = "westus2"

New-AzResourceGroup `
    -Name $resourceGroupName `
    -Location $region | Out-Null

PowerShell — tworzenie konta magazynu

Konto magazynu to udostępniona pula magazynu, której można użyć do wdrażania udziałów plików platformy Azure.

W tym przykładzie tworzone jest konto magazynu przy użyciu polecenia cmdlet New-AzStorageAccount. Konto magazynu ma nazwę mystorageaccount<losowy numer> i odwołanie do tego konta magazynu jest przechowywane w zmiennej $storageAcct. Nazwy kont magazynu muszą być unikatowe, dlatego użyj polecenia Get-Random , aby dołączyć liczbę losową do nazwy, aby była unikatowa.

$storageAccountName = "mystorageacct$(Get-Random)"

$storageAcct = New-AzStorageAccount `
    -ResourceGroupName $resourceGroupName `
    -Name $storageAccountName `
    -Location $region `
    -Kind StorageV2 `
    -SkuName Standard_LRS `
    -EnableLargeFileShare

Interfejs wiersza polecenia platformy Azure

Interfejs wiersza polecenia — tworzenie grupy zasobów

Grupa zasobów to logiczny kontener przeznaczony do wdrażania zasobów platformy Azure i zarządzania nimi. Jeśli nie masz jeszcze grupy zasobów platformy Azure, możesz utworzyć nową grupę za pomocą polecenia az group create. Do utworzenia konta magazynu potrzebna jest grupa zasobów.

Poniższy przykład tworzy grupę zasobów o nazwie myResourceGroup w lokalizacji Zachodnie stany USA 2 :

export resourceGroupName="myResourceGroup"
region="westus2"

az group create \
    --name $resourceGroupName \
    --location $region \
    --output none

Interfejs wiersza polecenia — tworzenie konta magazynu

Konto magazynu to udostępniona pula magazynu, w której można wdrażać udziały plików platformy Azure.

Poniższy przykład tworzy konto magazynu przy użyciu polecenia az storage account create . Nazwy kont magazynu muszą być unikatowe, dlatego użyj polecenia $RANDOM , aby dołączyć liczbę losową do nazwy, aby była unikatowa.

export storageAccountName="mystorageacct$RANDOM"

az storage account create \
    --resource-group $resourceGroupName \
    --name $storageAccountName \
    --location $region \
    --kind StorageV2 \
    --sku Standard_LRS \
    --enable-large-file-share \
    --output none

Tworzenie udziału plików platformy Azure

Portal

Aby utworzyć udział plików platformy Azure, wykonaj następujące czynności:

1. Wybierz konto magazynu na pulpicie nawigacyjnym.

2. Na stronie konta magazynu w sekcji Usługi wybierz pozycję Pliki.

   

3. W menu w górnej części strony Usługa plików kliknij pozycję + Udział plików. Zostanie rozwinięta strona Nowy udział plików.

4. W polu Nazwa wpisz ciąg myshare. Pozostaw opcję Transakcja zoptymalizowana pod kątem warstwy.

5. Wybierz pozycję Utwórz , aby utworzyć udział plików platformy Azure.

Nazwy udziałów muszą być małymi literami, cyframi i pojedynczymi łącznikami, ale nie mogą rozpoczynać się od łącznika. Szczegółowe informacje o nazwach plików i udziałów plików można znaleźć w temacie Naming and Referencing Shares, Directories, Files, and Metadata (Nazywanie i odwoływanie się do udziałów, katalogów, plików i metadanych).

Program PowerShell

Po utworzeniu konta magazynu możesz utworzyć swój pierwszy udział plików platformy Azure przy użyciu polecenia cmdlet New-AzRmStorageShare . W tym przykładzie zostanie utworzony udział o nazwie myshare z limitem przydziału 1024 GiB. Limit przydziału może wynosić maksymalnie 5 TiB lub 100 TiB z włączonymi dużymi udziałami plików na koncie magazynu.

$shareName = "myshare"

New-AzRmStorageShare `
    -StorageAccount $storageAcct `
    -Name $shareName `
    -EnabledProtocol SMB `
    -QuotaGiB 1024 | Out-Null

Interfejs wiersza polecenia platformy Azure

Po utworzeniu konta magazynu możesz utworzyć swój pierwszy udział plików platformy Azure przy użyciu polecenia az storage share-rm create . W tym przykładzie zostanie utworzony udział o nazwie myshare z limitem przydziału 1024 GiB. Limit przydziału może wynosić maksymalnie 5 TiB lub 100 TiB z włączonymi dużymi udziałami plików na koncie magazynu.

shareName="myshare"

az storage share-rm create \
    --resource-group $resourceGroupName \
    --storage-account $storageAccountName \
    --name $shareName \
    --quota 1024 \
    --enabled-protocols SMB \
    --output none

Tworzenie katalogu

Portal

Aby utworzyć nowy katalog o nazwie myDirectory w katalogu głównym udziału plików platformy Azure:

1. Na stronie Ustawienia udziału plików wybierz udział plików myshare . Zostanie otwarta strona udziału plików wskazująca , że nie znaleziono plików.
2. W menu w górnej części strony wybierz pozycję + Dodaj katalog. Zostanie rozwinięta strona Nowy katalog.
3. Wpisz nazwę myDirectory, a następnie kliknij przycisk OK.

Program PowerShell

Aby utworzyć nowy katalog o nazwie myDirectory w katalogu głównym udziału plików platformy Azure, użyj polecenia cmdlet New-AzStorageDirectory.

New-AzStorageDirectory `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Path "myDirectory"

Interfejs wiersza polecenia platformy Azure

Aby utworzyć nowy katalog o nazwie myDirectory w katalogu głównym udziału plików platformy Azure, użyj polecenia az storage directory create:

az storage directory create \
   --account-name $storageAccountName \
   --account-key $storageAccountKey \
   --share-name $shareName \
   --name "myDirectory" \
   --output none

Przekazywanie pliku

Portal

Aby można było zademonstrować przekazywanie pliku, najpierw musisz utworzyć lub wybrać plik do przekazania. Możesz to zrobić w dowolny sposób. Po podjęciu decyzji o pliku, który chcesz przekazać:

1. Wybierz katalog myDirectory . Zostanie otwarty panel myDirectory.

2. W menu u góry wybierz pozycję Przekaż. Zostanie otwarty panel Przekazywanie plików.

   

3. Wybierz ikonę folderu, aby otworzyć okno przeglądania plików lokalnych.

4. Wybierz plik, a następnie wybierz pozycję Otwórz.

5. Na stronie Przekazywanie plików zweryfikuj nazwę pliku, a następnie wybierz pozycję Przekaż.

6. Po zakończeniu plik powinien być widoczny na liście na stronie myDirectory.

Program PowerShell

Aby zademonstrować przekazywanie pliku przy użyciu polecenia cmdlet Set-AzStorageFileContent, najpierw należy utworzyć plik do przekazania w obrębie dysku tymczasowego usługi Cloud Shell w programie PowerShell.

Ten przykład obejmuje umieszczenie bieżącej daty i godziny w nowym pliku na dysku tymczasowym, a następnie przekazanie tego pliku do udziału plików.

# this expression will put the current date and time into a new file on your scratch drive
cd "~/CloudDrive/"
Get-Date | Out-File -FilePath "SampleUpload.txt" -Force

# this expression will upload that newly created file to your Azure file share
Set-AzStorageFileContent `
   -Context $storageAcct.Context `
   -ShareName $shareName `
   -Source "SampleUpload.txt" `
   -Path "myDirectory\SampleUpload.txt"

Jeśli używasz programu PowerShell lokalnie, zastąp element ~/CloudDrive/ ścieżką, która istnieje na maszynie.

Po przekazaniu pliku możesz skorzystać z polecenia cmdlet Get-AzStorageFile, aby upewnić się, że plik został przekazany do udziału plików platformy Azure.

Get-AzStorageFile `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\" | Get-AzStorageFile

Interfejs wiersza polecenia platformy Azure

Aby zademonstrować sposób przekazywania pliku przy użyciu polecenia az storage file upload, najpierw utwórz plik do przekazania na dysku zapasowym usługi Cloud Shell. Poniższy przykład umożliwia utworzenie, a następnie przekazanie pliku:

cd ~/clouddrive/
date > SampleUpload.txt

az storage file upload \
    --account-name $storageAccountName \
    --account-key $storageAccountKey \
    --share-name $shareName \
    --source "SampleUpload.txt" \
    --path "myDirectory/SampleUpload.txt"

Jeśli korzystasz z interfejsu wiersza polecenia platformy Azure lokalnie, zastąp ciąg ~/clouddrive ścieżką, która istnieje na Twojej maszynie.

Po przekazaniu pliku możesz upewnić się, że plik został przekazany do udziału plików platformy Azure, korzystając z polecenia az storage file list:

az storage file list \
    --account-name $storageAccountName \
    --account-key $storageAccountKey \
    --share-name $shareName \
    --path "myDirectory" \
    --output table

Pobieranie pliku

Portal

Możesz pobrać kopię przekazanego pliku, klikając go prawym przyciskiem myszy i wybierając polecenie Pobierz. Dokładne środowisko będzie zależeć od używanego systemu operacyjnego i przeglądarki.

Program PowerShell

Możesz użyć polecenia cmdlet Get-AzStorageFileContent, aby pobrać kopię pliku przekazanego na dysk tymczasowy Cloud Shell.

# Delete an existing file by the same name as SampleDownload.txt, if it exists because you've run this example before.
Remove-Item `
    -Path "SampleDownload.txt" `
    -Force `
    -ErrorAction SilentlyContinue

Get-AzStorageFileContent `
    -Context $storageAcct.Context `
    -ShareName $shareName `
    -Path "myDirectory\SampleUpload.txt" `
    -Destination "SampleDownload.txt"

Po pobraniu pliku możesz sprawdzić, czy plik został pobrany na dysk tymczasowy programu PowerShell Cloud Shell, za pomocą polecenia Get-ChildItem.

Get-ChildItem | Where-Object { $_.Name -eq "SampleDownload.txt" }

Interfejs wiersza polecenia platformy Azure

Za pomocą polecenia az storage file download możesz pobrać kopię pliku, który został przekazany na dysk zapasowy usługi Cloud Shell:

# Delete an existing file by the same name as SampleDownload.txt, if it exists, because you've run this example before
rm -f SampleDownload.txt

az storage file download \
    --account-name $storageAccountName \
    --account-key $storageAccountKey \
    --share-name $shareName \
    --path "myDirectory/SampleUpload.txt" \
    --dest "SampleDownload.txt" \
    --output none

Czyszczenie zasobów

Portal

Gdy skończysz, usuń grupę zasobów. Usunięcie grupy zasobów powoduje usunięcie konta magazynu, udziału plików platformy Azure i innych zasobów wdrożonych w grupie zasobów.

1. Wybierz pozycję Strona główna , a następnie pozycję Grupy zasobów.
2. Wybierz grupę zasobów, którą chcesz usunąć.
3. Wybierz pozycję Usuń grupę zasobów. Zostanie otwarte okno zawierające ostrzeżenie dotyczące zasobów, które zostaną usunięte razem z grupą zasobów.
4. Wprowadź nazwę grupy zasobów, a następnie wybierz pozycję Usuń.

Program PowerShell

Gdy skończysz, możesz użyć polecenia cmdlet Remove-AzResourceGroup , aby usunąć grupę zasobów i wszystkie zasoby zawarte w grupie zasobów.

Remove-AzResourceGroup -Name myResourceGroup

Interfejs wiersza polecenia platformy Azure

Po zakończeniu az group delete możesz użyć polecenia , aby usunąć grupę zasobów i wszystkie zasoby zawarte w grupie zasobów:

az group delete --name $resourceGroupName

Następne kroki

Co to jest usługa Azure Files?