Guia de início rápido: criar e usar um compartilhamento de arquivos do Azure

Ficheiros do Azure é o sistema de ficheiros na cloud fácil de utilizar da Microsoft. Você pode montar compartilhamentos de arquivos do Azure nos sistemas operacionais Windows, Linux e macOS. Este artigo mostra como criar um compartilhamento de arquivos do Azure SMB usando o portal do Azure, a CLI do Azure ou o Azure PowerShell.

Aplica-se a

Este Guia de início rápido só se aplica a compartilhamentos de arquivos do Azure SMB. Os compartilhamentos de arquivos SMB padrão e premium oferecem suporte ao armazenamento com redundância local (LRS) e ao armazenamento com redundância de zona (ZRS). Os compartilhamentos de arquivos padrão também suportam opções de armazenamento com redundância geográfica (GRS) e armazenamento com redundância geográfica (GZRS). Para obter mais informações, consulte Redundância de arquivos do Azure.

Tipo de partilhas de ficheiros	SMB	NFS
Partilhas de ficheiros Standard (GPv2), LRS/ZRS
Partilhas de ficheiros Standard (GPv2), GRS/GZRS
Partilhas de ficheiros Premium (FileStorage), LRS/ZRS

Introdução

Portal

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

PowerShell

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Azure Cloud Shell

O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.

Para iniciar o Azure Cloud Shell:

Opção	Exemplo/Ligação
Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell.
Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser.
Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure.

Para usar o Azure Cloud Shell:

1. Inicie o Cloud Shell.

2. Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou comando.

3. Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.

4. Selecione Enter para executar o código ou comando.

Se quiser instalar e usar o PowerShell localmente, você precisará do módulo Az do Azure PowerShell versão 7.0.0 ou posterior. Recomendamos a instalação da versão mais recente disponível. Para descobrir qual versão do módulo do Azure PowerShell você está executando, execute Get-InstalledModule Az. Se precisar de atualizar, veja Install Azure PowerShell module (Instalar o módulo do Azure PowerShell). Se você estiver executando o PowerShell localmente, também precisará executar para fazer Login-AzAccount logon em sua conta do Azure. Para usar a autenticação multifator, você precisará fornecer sua ID de locatário do Azure, como Login-AzAccount -TenantId <TenantId>.

CLI do Azure

Pré-requisitos

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

• Este artigo requer a versão 2.0.4 ou posterior da CLI do Azure. Se estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.

• Por padrão, os comandos da CLI do Azure retornam JavaScript Object Notation (JSON), que é a maneira padrão de enviar e receber mensagens de APIs REST. Para facilitar a utilização das respostas JSON, alguns dos exemplos neste artigo utilizam o parâmetro query nos comandos da CLI do Azure. Este parâmetro utiliza a linguagem de consulta JMESPath para analisar o JSON. Para saber mais sobre como utilizar os resultados dos comandos da CLI do Azure ao seguir a linguagem de consulta do JMESPath, veja o tutorial JMESPath.

Criar uma conta de armazenamento

Portal

Uma conta de armazenamento é um conjunto partilhado de armazenamento no qual pode implementar uma partilha de ficheiros do Azure ou outros recursos de armazenamento, como blobs ou filas. Uma conta de armazenamento pode conter um número ilimitado de partilhas. Uma partilha pode armazenar um número ilimitado de ficheiros, até aos limites de capacidade da conta de armazenamento.

Para criar uma conta de armazenamento usando o portal do Azure:

1. Em Serviços do Azure, selecione Contas de armazenamento.

2. Selecione + Criar para criar uma conta de armazenamento.

3. Em Detalhes do projeto, selecione a assinatura do Azure na qual criar a conta de armazenamento. Se tiver apenas uma subscrição, deve ser a predefinição.

4. Se quiser criar um novo grupo de recursos, selecione Criar novo e insira um nome como myexamplegroup.

5. Em Detalhes da instância, forneça um nome para a conta de armazenamento. Talvez seja necessário adicionar alguns números aleatórios para torná-lo um nome globalmente exclusivo. Um nome de conta de armazenamento deve ser todo minúsculo e números, e deve ter entre 3 e 24 caracteres. Tome nota do nome da conta de armazenamento. Vai utilizá-lo mais tarde.

6. Em Região, selecione a região na qual você deseja criar sua conta de armazenamento.

7. Em Desempenho, mantenha o valor padrão de Padrão.

8. Em Redundância, selecione Armazenamento com redundância local (LRS).

   

9. Selecione Rever para rever as suas definições. O Azure executará uma validação final.

10. Quando a validação estiver concluída, selecione Criar. Você verá uma notificação de que a implantação está em andamento.

PowerShell

PowerShell - Criar um grupo de recursos

Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos. Se você ainda não tiver um grupo de recursos do Azure, crie um novo com o cmdlet New-AzResourceGroup . Você precisa de um grupo de recursos para criar uma conta de armazenamento.

O exemplo a seguir cria um grupo de recursos chamado myResourceGroup na região Oeste dos EUA 2:

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

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

PowerShell - Criar uma conta de armazenamento

Uma conta de armazenamento é um pool compartilhado de armazenamento que você pode usar para implantar compartilhamentos de arquivos do Azure.

Este exemplo cria uma conta de armazenamento usando o cmdlet New-AzStorageAccount . A conta de armazenamento é denominada mystorageaccount<random number> e uma referência a essa conta de armazenamento é armazenada na variável $storageAcct. Os nomes das contas de armazenamento devem ser exclusivos, portanto, use Get-Random para acrescentar um número aleatório ao nome para torná-lo exclusivo.

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

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

CLI do Azure

CLI - Criar um grupo de recursos

Um grupo de recursos é um contentor lógico no qual os recursos do Azure são implementados e geridos. Se ainda não tiver um grupo de recursos do Azure, pode utilizar o comando az group create para criar um. Você precisa de um grupo de recursos para criar uma conta de armazenamento.

O exemplo a seguir cria um grupo de recursos chamado myResourceGroup no local West US 2 :

export resourceGroupName="myResourceGroup"
region="westus2"

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

CLI - Criar uma conta de armazenamento

Uma conta de armazenamento é um pool compartilhado de armazenamento no qual você pode implantar compartilhamentos de arquivos do Azure.

O exemplo a seguir cria uma conta de armazenamento usando o comando az storage account create . Os nomes das contas de armazenamento devem ser exclusivos, portanto, use $RANDOM para acrescentar um número aleatório ao nome para torná-lo exclusivo.

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

Criar uma partilha de ficheiros do Azure

Portal

Para criar uma partilha de ficheiros do Azure:

1. Selecione a conta de armazenamento a partir do dashboard.

2. Na página Conta de armazenamento, na seção Armazenamento de dados, selecione Compartilhamentos de arquivos.

   

3. No menu na parte superior da página Compartilhamentos de arquivos, selecione + Compartilhamento de arquivos. É apresentada a página Nova partilha de ficheiros.

4. Em Nome, digite myshare. Os nomes de compartilhamento de arquivos devem ser letras minúsculas, números e hífenes únicos, e devem começar e terminar com uma letra ou número minúsculo. O nome não pode conter duas hífenes consecutivas. Para obter detalhes sobre como nomear compartilhamentos de arquivos e arquivos, consulte Nomenclatura e referência de compartilhamentos, diretórios, arquivos e metadados.

5. Deixe Transação otimizada selecionada para Nível.

6. Selecione a guia Backup . Por padrão, o backup é habilitado quando você cria um compartilhamento de arquivos do Azure usando o portal do Azure. Se quiser desativar o backup para o compartilhamento de arquivos, desmarque a caixa de seleção Habilitar backup . Se quiser habilitar o backup, você pode deixar os padrões ou criar um novo Cofre dos Serviços de Recuperação na mesma região e assinatura da conta de armazenamento. Para criar uma nova política de backup, selecione Criar uma nova política.

   

7. Selecione Rever + criar e, em seguida, Criar para criar a partilha de ficheiros do Azure.

PowerShell

Agora que você criou uma conta de armazenamento, pode criar seu primeiro compartilhamento de arquivos do Azure usando o cmdlet New-AzRmStorageShare . Este exemplo cria um compartilhamento chamado myshare com uma cota de 1024 GiB. A cota pode ser no máximo 5 TiB ou 100 TiB com grandes compartilhamentos de arquivos habilitados na conta de armazenamento.

$shareName = "myshare"

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

CLI do Azure

Agora que você criou uma conta de armazenamento, pode criar seu primeiro compartilhamento de arquivos do Azure usando o comando az storage share-rm create . Este exemplo cria um compartilhamento chamado myshare com uma cota de 1024 GiB. A cota pode ser no máximo 5 TiB ou 100 TiB com grandes compartilhamentos de arquivos habilitados na conta de armazenamento.

shareName="myshare"

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

Criar um diretório

Portal

Para criar um novo diretório com o nome myDirectory na raiz da partilha de ficheiros do Azure:

1. Na página Configurações de compartilhamento de arquivos, selecione o compartilhamento de arquivos myshare. A página do compartilhamento de arquivos é aberta, indicando que nenhum arquivo foi encontrado.
2. No menu na parte superior da página, selecione + Adicionar diretório. É apresentada a página Novo diretório.
3. Digite myDirectory e selecione OK.

PowerShell

Para criar um novo diretório chamado myDirectory na raiz do compartilhamento de arquivos do Azure, use o cmdlet New-AzStorageDirectory.

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

CLI do Azure

Para criar um novo diretório com o nome myDirectory na raiz da partilha de ficheiros do Azure, utilize o comando az storage directory create:

Nota

Se você não fornecer credenciais com seus comandos, a CLI do Azure consultará sua chave de conta de armazenamento. Você também pode fornecer a chave da conta de armazenamento com o comando usando uma variável como --account-key $storageAccountKey ou em texto sem formatação, como --account-key "your-storage-account-key-here".

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

Carregar um ficheiro

Portal

Primeiro, você precisa criar ou selecionar um arquivo para carregar. Faça isso por qualquer meio que achar melhor. Quando tiver decidido o ficheiro que pretende carregar, siga estes passos:

1. Selecione o diretório myDirectory . É aberto o painel myDirectory.

2. No menu na parte superior, selecione Carregar. É aberto o painel Carregar ficheiros.

   

3. Selecione o ícone de pasta para abrir uma janela para procurar seus arquivos locais.

4. Selecione um arquivo e, em seguida, selecione Abrir.

5. Na página Carregar ficheiros, verifique o nome do ficheiro e, em seguida, selecione Carregar.

6. Quando terminar, o ficheiro deve aparecer na lista na página myDirectory.

PowerShell

Para demonstrar como carregar um arquivo usando o cmdlet Set-AzStorageFileContent , primeiro precisamos criar um arquivo dentro da unidade de trabalho do PowerShell Cloud Shell para carregar.

Este exemplo coloca a data e hora atuais num novo ficheiro no disco e, em seguida, carrega o ficheiro para a partilha de ficheiros.

# 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"

Se você estiver executando o PowerShell localmente, substitua ~/CloudDrive/ por um caminho que existe em sua máquina.

Depois de carregar o arquivo, você pode usar o cmdlet Get-AzStorageFile para verificar se o arquivo foi carregado em seu compartilhamento de arquivos do Azure.

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

CLI do Azure

Para demonstrar como carregar um ficheiro com o comando az storage file upload, primeiro crie um ficheiro para carregar na unidade temporária do Cloud Shell. No exemplo seguinte, irá criar e carregar o ficheiro:

cd ~/clouddrive/
date > SampleUpload.txt

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

Se estiver a executar a CLI do Azure localmente, substitua ~/clouddrive por um caminho existente no seu computador.

Depois de carregar o ficheiro, pode utilizar o comando az storage file list para assegurar que o ficheiro foi carregado para a partilha de ficheiros do Azure:

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

Transferir um ficheiro

Portal

Pode transferir uma cópia do ficheiro que carregou clicando com o botão direito do rato no ficheiro e selecionando Transferir. A experiência exata dependerá do sistema operacional e do navegador que você está usando.

PowerShell

Você pode usar o cmdlet Get-AzStorageFileContent para baixar uma cópia do arquivo carregado na unidade de trabalho do 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"

Depois de baixar o arquivo, você pode usar o Get-ChildItem cmdlet para ver se o arquivo foi baixado para a unidade de trabalho do PowerShell Cloud Shell.

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

CLI do Azure

Pode utilizar o comando az storage file download para transferir uma cópia do ficheiro que carregou para a unidade temporária do 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

Clean up resources (Limpar recursos)

Portal

Quando terminar, exclua o grupo de recursos. A exclusão do grupo de recursos exclui a conta de armazenamento, o compartilhamento de arquivos do Azure e quaisquer outros recursos implantados dentro do grupo de recursos.

Se houver bloqueios na conta de armazenamento, você precisará removê-los primeiro. Navegue até a conta de armazenamento e selecione Bloqueios de configurações>. Se algum bloqueio estiver listado, exclua-o.

Também pode ser necessário excluir o cofre dos Serviços de Recuperação de Backup do Azure antes de ter permissão para excluir o grupo de recursos.

1. Selecione Página Inicial e, em seguida, Grupos de recursos.
2. Selecione o grupo de recursos que pretende eliminar.
3. Selecione Eliminar grupo de recursos. É aberta uma janela com um aviso sobre os recursos que serão eliminados com o grupo de recursos.
4. Introduza o nome do grupo de recursos e, em seguida, selecione Eliminar.

PowerShell

Quando terminar, você poderá usar o cmdlet Remove-AzResourceGroup para excluir o grupo de recursos e todos os recursos contidos no grupo de recursos.

Remove-AzResourceGroup -Name myResourceGroup

CLI do Azure

Quando terminar, você poderá usar o az group delete comando para excluir o grupo de recursos e todos os recursos contidos no grupo de recursos:

az group delete --name $resourceGroupName

Próximos passos

O que são os Ficheiros do Azure?