Szybki start: tworzenie i używanie udziału plików platformy Azure
Artykuł
Azure Files to łatwy w użyciu system plików w chmurze firmy Microsoft. Udziały plików platformy Azure można zainstalować w systemach operacyjnych Windows, Linux i macOS. W tym artykule pokazano, jak utworzyć udział plików SMB platformy Azure przy użyciu witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.
Dotyczy
Ten przewodnik Szybki start dotyczy tylko udziałów plików platformy Azure protokołu SMB. Udziały plików SMB w warstwie Standardowa i Premium obsługują magazyn lokalnie nadmiarowy (LRS) i magazyn strefowo nadmiarowy (ZRS). Standardowe udziały plików obsługują również opcje magazynu geograficznie nadmiarowego (GRS) i magazynu geograficznie nadmiarowego (GZRS). Aby uzyskać więcej informacji, zobacz Nadmiarowość usługi Azure Files.
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
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
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. Aby uruchomić kod w tym artykule, możesz użyć wstępnie zainstalowanych poleceń usługi Cloud Shell 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 lub polecenia. Wybranie pozycji Wypróbuj nie powoduje automatycznego skopiowania kodu lub polecenia do usługi 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 użyć usługi Azure Cloud Shell:
Uruchom usługę Cloud Shell.
Wybierz przycisk Kopiuj w bloku kodu (lub bloku poleceń), aby skopiować kod lub polecenie.
Wklej kod lub polecenie do sesji usługi Cloud Shell, wybierając klawisze Ctrl+Shift V w systemach Windows i Linux lub wybierając pozycję Cmd+Shift++V w systemie macOS.
Wybierz klawisz Enter, aby uruchomić kod lub polecenie.
Jeśli chcesz zainstalować program PowerShell i korzystać z niego lokalnie, potrzebujesz modułu Az programu Azure PowerShell w wersji 7.0.0 lub nowszej. Zalecamy zainstalowanie najnowszej dostępnej wersji. Aby dowiedzieć się, która wersja modułu programu Azure PowerShell jest uruchomiona, wykonaj polecenie Get-InstalledModule Az. Jeśli konieczne będzie uaktualnienie, zobacz Instalowanie modułu Azure PowerShell. Jeśli korzystasz z programu PowerShell lokalnie, musisz również uruchomić polecenie Login-AzAccount , aby zalogować się do konta platformy Azure. Aby użyć uwierzytelniania wieloskładnikowego, musisz podać identyfikator dzierżawy platformy Azure, taki jak Login-AzAccount -TenantId <TenantId>.
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 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ć inne opcje logowania, zobacz Logowanie się przy użyciu interfejsu 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. W przypadku korzystania z usługi Azure Cloud Shell najnowsza wersja jest już zainstalowana.
Domyślnie polecenia interfejsu wiersza polecenia platformy Azure zwracają kod JavaScript Object Notation (JSON), który jest standardowym sposobem wysyłania i odbierania komunikatów z interfejsów 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.
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 witryny Azure Portal:
W obszarze Usługi platformy Azure wybierz pozycję Konta magazynu.
Wybierz pozycję + Utwórz , aby utworzyć konto magazynu.
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ą.
Jeśli chcesz utworzyć nową grupę zasobów, wybierz pozycję Utwórz nową i wprowadź nazwę, taką jak myexamplegroup.
W obszarze Szczegóły wystąpienia podaj nazwę konta magazynu. Może być konieczne dodanie kilku losowych liczb, aby była to globalnie unikatowa nazwa. Nazwa konta magazynu musi zawierać wszystkie małe litery i cyfry i musi zawierać od 3 do 24 znaków. Zanotuj nazwę konta magazynu. Użyjesz go później.
W obszarze Region wybierz region, w którym chcesz utworzyć konto magazynu.
W obszarze Wydajność zachowaj wartość domyślną standardu.
W obszarze Nadmiarowość wybierz pozycję Magazyn lokalnie nadmiarowy (LRS).
Wybierz pozycję Przejrzyj , aby przejrzeć ustawienia. Platforma Azure uruchomi ostateczną walidację.
Po zakończeniu walidacji wybierz pozycję Utwórz. Powinno zostać wyświetlone powiadomienie, że wdrożenie jest w toku.
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:
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<losową liczbę> 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ć losową liczbę do nazwy, aby była unikatowa.
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 wdrożyć 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ć losową liczbę do nazwy, aby była unikatowa.
Aby utworzyć udział plików platformy Azure, wykonaj następujące czynności:
Wybierz konto magazynu na pulpicie nawigacyjnym.
Na stronie konta magazynu w sekcji Magazyn danych wybierz pozycję Udziały plików.
W menu w górnej części strony Udziały plików wybierz pozycję + Udział plików. Zostanie rozwinięta strona Nowy udział plików.
W polu Nazwa wpisz myshare. Nazwy udziałów plików muszą być małymi literami, cyframi i pojedynczymi łącznikami oraz muszą zaczynać się i kończyć małą literą lub cyfrą. Nazwa nie może zawierać dwóch kolejnych łączników. Aby uzyskać szczegółowe informacje na temat nazewnictwa udziałów plików i plików, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych.
Pozostaw opcję Transakcja zoptymalizowana pod kątem warstwy.
Wybierz kartę Kopia zapasowa. Domyślnie kopia zapasowa jest włączona podczas tworzenia udziału plików platformy Azure przy użyciu witryny Azure Portal. Jeśli chcesz wyłączyć kopię zapasową udziału plików, usuń zaznaczenie pola wyboru Włącz kopię zapasową . Jeśli chcesz włączyć tworzenie kopii zapasowej, możesz pozostawić wartości domyślne lub utworzyć nowy magazyn usługi Recovery Services w tym samym regionie i subskrypcji co konto magazynu. Aby utworzyć nowe zasady tworzenia kopii zapasowych, wybierz pozycję Utwórz nowe zasady.
Wybierz pozycję Przejrzyj i utwórz , a następnie pozycję Utwórz , aby utworzyć udział plików platformy Azure.
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 tworzony jest udział o nazwie myshare z limitem przydziału 1024 GiB. Limit przydziału może wynosić maksymalnie 5 TiB lub 100 TiB z dużymi udziałami plików włączonymi na koncie magazynu.
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 tworzony jest udział o nazwie myshare z limitem przydziału 1024 GiB. Limit przydziału może wynosić maksymalnie 5 TiB lub 100 TiB z dużymi udziałami plików włączonymi na koncie magazynu.
Aby utworzyć nowy katalog o nazwie myDirectory w katalogu głównym udziału plików platformy Azure:
Na stronie Ustawienia udziału plików wybierz udział plików myshare . Zostanie otwarta strona udziału plików wskazująca , że nie znaleziono żadnych plików.
W menu w górnej części strony wybierz pozycję + Dodaj katalog. Zostanie rozwinięta strona Nowy katalog.
Wpisz myDirectory , a następnie wybierz przycisk OK.
Aby utworzyć nowy katalog o nazwie myDirectory w katalogu głównym udziału plików platformy Azure, użyj polecenia cmdlet New-AzStorageDirectory.
Aby utworzyć nowy katalog o nazwie myDirectory w katalogu głównym udziału plików platformy Azure, użyj polecenia az storage directory create:
Uwaga
Jeśli nie podasz poświadczeń za pomocą poleceń, interfejs wiersza polecenia platformy Azure wykona zapytanie dotyczące klucza konta magazynu. Możesz również podać klucz konta magazynu za pomocą polecenia przy użyciu zmiennej, takiej jak --account-key $storageAccountKey lub w postaci zwykłego tekstu, takiej jak --account-key "your-storage-account-key-here".
Najpierw musisz utworzyć lub wybrać plik do przekazania. Zrób to, cokolwiek oznacza, że pasujesz. Po wybraniu pliku, który chcesz przekazać, wykonaj następujące kroki:
Wybierz katalog myDirectory. Zostanie otwarty panel myDirectory.
W menu u góry wybierz pozycję Przekaż. Zostanie otwarty panel Przekazywanie plików.
Wybierz ikonę folderu, aby otworzyć okno, aby przeglądać pliki lokalne.
Wybierz plik, a następnie wybierz pozycję Otwórz.
Na stronie Przekazywanie plików zweryfikuj nazwę pliku, a następnie wybierz pozycję Przekaż.
Po zakończeniu plik powinien być widoczny na liście na stronie myDirectory.
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 ciąg ~/CloudDrive/ ścieżką, która istnieje na maszynie.
Po przekazaniu pliku możesz użyć polecenia cmdlet Get-AzStorageFile , aby sprawdzić, czy plik został przekazany do udziału plików 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 \
--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 \
--share-name $shareName \
--path "myDirectory" \
--output table
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.
# 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 użyć Get-ChildItem polecenia cmdlet , aby zobaczyć, że plik został pobrany na dysk tymczasowy usługi PowerShell w usłudze Cloud Shell.
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 \
--share-name $shareName \
--path "myDirectory/SampleUpload.txt" \
--dest "./SampleDownload.txt" \
--output none
Gdy skończysz, usuń grupę zasobów. Usunięcie grupy zasobów spowoduje usunięcie konta magazynu, udziału plików platformy Azure i wszystkich innych zasobów wdrożonych w grupie zasobów.
Jeśli na koncie magazynu istnieją blokady, najpierw należy je usunąć. Przejdź do konta magazynu i wybierz pozycję Ustawienia> Locks. Jeśli zostaną wyświetlone jakiekolwiek blokady, usuń je.
Może być również konieczne usunięcie magazynu usługi Azure Backup Recovery Services przed zezwoleniem na usunięcie grupy zasobów.
Wybierz pozycję Strona główna, a następnie pozycję Grupy zasobów.
Wybierz grupę zasobów, którą chcesz usunąć.
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.
Wprowadź nazwę grupy zasobów, a następnie wybierz pozycję Usuń.
