Compartilhar via


Usar o AzCopy em scripts e transferências agendadas

Você pode incorporar o AzCopy em scripts automatizados para operações em lotes, transferências de dados agendadas ou pipelines de integração contínua. Este artigo mostra como obter links de download estáticos para garantir a consistência da versão, criar tarefas agendadas para transferências de dados automatizadas e lidar com considerações especiais, como escape de caracteres e integração do Jenkins.

Com o tempo, o link de download do AzCopy aponta para novas versões do AzCopy. O script que baixar o AzCopy poderá parar de funcionar se uma versão mais recente do AzCopy modificar os recursos dependentes do script.

Para evitar esses problemas, obtenha um link estático (inalterado) para a versão atual do AzCopy. Assim, o script baixará a mesma versão exata do AzCopy cada vez que for executado.

Para obter um link estático, abra a página de lançamento do AzCopy. Em seguida, role pela página até localizar a versão desejada. Na lista de ativos para essa versão, clique com o botão direito do mouse no ativo desejado. No menu de contexto, selecione Copiar link. Em seguida, você pode usar essa URL em seu script para baixar e extrair o binário do AzCopy.

Observação

O link estático para binários do AzCopy pode ser alterado ao longo do tempo devido à nossa infraestrutura de entrega de conteúdo. Se você precisar usar uma versão específica do AzCopy por qualquer motivo, considere usar o AzCopy com um sistema operacional que aproveite o pacote publicado do Linux. Esse método garante que você possa instalar e manter de forma confiável a versão desejada do AzCopy.

Criar uma tarefa agendada

Você pode criar uma tarefa agendada ou trabalho de Cron que execute um script de comando AzCopy. O script identifica e carrega novos dados locais para o armazenamento em nuvem em um intervalo de tempo específico.

Os exemplos a seguir pressupõem que você configurou a autenticação do Microsoft Entra usando a variável de AZCOPY_AUTO_LOGIN_TYPE ambiente. Para saber mais, confira Autorizar com a ID do Microsoft Entra.

Copie o comando AzCopy a seguir para um editor de texto. Atualize os valores de parâmetro do comando AzCopy para os valores apropriados. Salve o arquivo como script.sh.

azcopy sync "/mnt/myfiles" "https://mystorageaccount.blob.core.windows.net/mycontainer" --recursive=true

Você pode criar um trabalho cron usando o comando Crontab . O exemplo a seguir cria um trabalho cron e especifica a expressão */5 * * * * cron que indica que o script script.sh do shell deve ser executado a cada cinco minutos.

crontab -e
*/5 * * * * sh /path/to/script.sh

Você pode agendar o script para ser executado em um momento específico diariamente, mensalmente ou anualmente. Para saber mais sobre como definir a data e hora para a execução do trabalho, consulte expressões Cron.

Caracteres especiais de escape em tokens SAS

Em arquivos em lotes que têm a extensão .cmd, você terá que fazer o escape dos caracteres % que aparecem nos tokens SAS. Adicione um caractere extra % ao lado de caracteres existentes % na cadeia de caracteres de token SAS. A sequência de caracteres resultante aparece como %%. Adicione um extra ^ antes de cada & caractere para criar a sequência ^&de caracteres.

Executar scripts usando o Jenkins

Se você planeja usar o Jenkins para executar scripts, coloque o comando a seguir no início do script.

/usr/bin/keyctl new_session

Próximas etapas

Se você tiver dúvidas, problemas ou comentários gerais, envie-os no GitHub.