Master AzCopy: Baixar, Instalar e Autenticar – techsyncer

O tool AzCopy é uma ferramenta gratuita e útil que permite copiar e mover dados de e para o armazenamento Azure. É uma excelente utilidade de linha de comando que pode automatizar e simplificar o processo, mas requer alguma configuração. Vamos ver como baixar o AzCopy e começar.

Neste artigo, você aprenderá como preparar seu sistema para usar o AzCopy. Isso inclui baixar e autenticar a ferramenta para ter acesso ao armazenamento Azure. Quando terminar, estará pronto para usar o AzCopy para gerenciar os dados de armazenamento Azure.

A versão mais recente e suportada do AzCopy, até o momento desta redação, é o AzCopy v10. O AzCopy está disponível para Windows, Linux e macOS. Neste artigo, abordaremos apenas a utilidade AzCopy para Windows.

Pré-requisitos

Você aprenderá na prática como realizar algumas tarefas diferentes neste artigo. Se deseja acompanhar, certifique-se de atender aos seguintes pré-requisitos.

Uma assinatura Azure. Se ainda não tiver, você pode solicitar uma assinatura de avaliação.
Conta de Armazenamento do Azure. Consulte Criar uma conta de armazenamento para saber mais.
Um locatário do Azure AD criado com uma conta de usuário parte dos grupos Contribuinte de Dados do Blob de Armazenamento ou Proprietário de Dados do Blob de Armazenamento
Windows PowerShell 5.1 ou PowerShell Core 6+ (opcional se estiver baixando o AzCopy via script do PowerShell)

Baixe o AzCopy: Manualmente

Há algumas maneiras diferentes de baixar o AzCopy. Vamos primeiro fazer isso manualmente. Você pode usar este método se não pretende instalar o AzCopy em muitos computadores de uma só vez.

Acesse este URL – https://aka.ms/downloadazcopy-v10-windows e ele deve iniciar o download do arquivo zip. Depois de baixado, extraia o arquivo zip para a C:\AzCopy ou uma pasta de sua escolha.

Por fim, adicione o diretório de instalação ao caminho do sistema. Consulte o artigo Como definir o caminho e as variáveis de ambiente no Windows se precisar saber como fazer isso. Adicionar o caminho da pasta ao PATH do Windows permite que você chame o executável azcopy sempre que estiver em qualquer diretório de trabalho no prompt de comando.

Baixe o AzCopy via Script do PowerShell

Se você pretende instalar o AzCopy em muitas máquinas ou simplesmente precisa fornecer instruções para que outra pessoa o instale, você pode usar o PowerShell também. O uso de um script do PowerShell simplifica o processo para um único script.

Crie um novo script do PowerShell e copie/cole o conteúdo abaixo nele. Você pode ter uma ideia do que cada seção do script está fazendo ao inspecionar os comentários embutidos.

Por padrão, o script abaixo irá baixar o AzCopy na pasta C:\AzCopy. Se desejar alterar isso, ao executar o script, use o parâmetro InstallPath ou simplesmente altere o caminho padrão no próprio script.

$InstallPath = 'C:\AzCopy'

# Limpeza do Destino
if (Test-Path $InstallPath) {
    Get-ChildItem $InstallPath | Remove-Item -Confirm:$false -Force
}

# Compacte o Destino
$zip = "$InstallPath\AzCopy.Zip"

# Crie a pasta de instalação (por exemplo, C:\AzCopy)
$null = New-Item -Type Directory -Path $InstallPath -Force

# Baixe o AzCopy zip para Windows
Start-BitsTransfer -Source "https://aka.ms/downloadazcopy-v10-windows" -Destination $zip

# Expanda o arquivo Zip
Expand-Archive $zip $InstallPath -Force

# Mova para $InstallPath
Get-ChildItem "$($InstallPath)\*\*" | Move-Item -Destination "$($InstallPath)\" -Force

# Limpeza - exclua o ZIP e a pasta antiga
Remove-Item $zip -Force -Confirm:$false
Get-ChildItem "$($InstallPath)\*" -Directory | ForEach-Object { Remove-Item $_.FullName -Recurse -Force -Confirm:$false }

# Adicione InstallPath ao Caminho do Sistema se ainda não existir
if ($env:PATH -notcontains $InstallPath) {
    $path = ($env:PATH -split ";")
    if (!($path -contains $InstallPath)) {
        $path += $InstallPath
        $env:PATH = ($path -join ";")
        $env:PATH = $env:PATH -replace ';;', ';'
    }
    [Environment]::SetEnvironmentVariable("Path", ($env:path), [System.EnvironmentVariableTarget]::Machine)
}

Depois que o script for executado, você pode confirmar que o AzCopy foi baixado com sucesso. Ainda no console do PowerShell, liste os arquivos no caminho de instalação executando Get-ChildItem -Path $InstallPath substituindo pela pasta que você utilizou.

Se tudo correu bem, você deverá ver o utilitário azcopy.exe e um arquivo de texto de licença.

Você também pode confirmar que o caminho de instalação foi adicionado à variável de caminho do sistema executando $env:Path -split ";" e observando que a pasta de instalação aparece no final da lista.

No exemplo abaixo, C:\AzCopy está listado, o que significa que o local foi adicionado com sucesso.

Autenticando AzCopy

A tarefa de baixar o AzCopy deve estar completa. Mas antes de poder executar qualquer tarefa, é necessário autenticar-se na sua assinatura do Azure para acessar o Armazenamento do Azure primeiro.

Existem duas maneiras de autenticar o AzCopy em suas contas de armazenamento do Azure – Azure Active Directory ou por meio de um token de Assinatura de Acesso Compartilhado (SAS). Neste artigo, vamos nos concentrar em usar o Azure AD. Se você gostaria de aprender como criar um token SAS para autenticação dessa forma, confira Como Gerar um Token SAS do Azure para Acessar Contas de Armazenamento.

O método mais comum para autenticar o AzCopy é via Azure AD. Ao usar o Azure AD, você tem várias opções. Algumas dessas opções são:

Login Interativo – O usuário é solicitado a fazer login usando o navegador.
Principal de Serviço + senha – Para login não interativo. Recomendado para automação e script.
Principal de Serviço + certificado – Para login não interativo. Recomendado para automação e script.

Neste artigo, você aprenderá como autenticar via login interativo. Para fazer isso, primeiro, abra um prompt de comando ou PowerShell e execute o comando abaixo. O parâmetro --tenant-id é opcional, mas recomendado, especialmente se sua conta de login estiver associada a mais de um locatário do Azure.

> azcopy login --tenant-id "TENANT-ID"`

Se precisar de ajuda para encontrar o ID do locatário do Azure AD, confira, este artigo.

Uma vez executado, você será solicitado a abrir um navegador e navegar até https://login.microsoftonline.com/common/oauth2/deviceauth e inserir o código exibido. Você pode ver como será isso abaixo.

*Enter the code from AzCopy into the browser*

Depois de inserir o código no navegador, clique em Avançar e prossiga para fazer login na sua conta.

Quando o login for concluído, você deverá ver o status mostrado no navegador e no terminal, semelhante ao que é mostrado na captura de tela abaixo.

Resumo

No final, agora você tem o conhecimento necessário sobre como baixar e autenticar o AzCopy em sua máquina.

Agora que você possui todo esse conhecimento, deve estar pronto para colocar o AzCopy em ação! Se quiser experimentar o AzCopy, vá para o próximo artigo Como Gerenciar Arquivos Entre o Armazenamento Local e o Azure com o AzCopy para aprender como usar o AzCopy para gerenciar e transferir dados entre o armazenamento local e o Azure.