Visão geral das ferramentas e APIs de Lote
O processamento de cargas de trabalho paralelas com o Lote do Azure normalmente é feito de forma programática usando uma das APIs do Lote. O aplicativo cliente ou serviço pode usar as APIs do Lote para se comunicar com o serviço de Lote. Com as APIs do Lote, você pode criar e gerenciar pools de nós de computação, máquinas virtuais ou serviços de nuvem. Em seguida, você pode agendar trabalhos e tarefas para serem executadas em nós.
Você pode processar, com eficiência, cargas de trabalho em grande escala para sua organização ou fornecer um front-end de serviço a seus clientes, para que eles possam executar trabalhos e tarefas - sob demanda ou agendada - em um, em centenas ou em milhares de nós. Você também pode usar o Lote do Azure como parte de um fluxo de trabalho maior, gerenciado por ferramentas como o Azure Data Factory.
Dica
Para saber mais sobre os recursos e o fluxo de trabalho usados no Lote do Azure, consulte Fluxo de trabalho e recursos do serviço de lote.
Contas do Azure para desenvolvimento de Lote
Ao desenvolver soluções de Lote, você usará as contas a seguir na sua assinatura do Azure:
- Conta do Lote: Recursos do Lote do Azure, incluindo pools, nós de computação, trabalhos e tarefas, são associados a uma conta do Lote do Azure. Quando o aplicativo faz uma solicitação ao serviço de Lote, ele autentica a solicitação usando o nome de conta do Lote do Azure, a URL da conta e uma chave de acesso ou um token do Microsoft Entra. Você pode criar uma conta do Lote no portal do Azure ou de forma programática.
- Conta de armazenamento: o Lote inclui suporte interno para trabalhar com arquivos no Armazenamento do Azure. Quase todos os cenários de Lote usam o Armazenamento de Blobs do Azure para preparar os programas que as tarefas executam e os dados que eles processam e para o armazenamento dos dados de saída que eles geram. Cada conta do Lote geralmente é associada a uma conta de armazenamento correspondente.
APIs de nível de serviço e de gerenciamento
O Lote do Azure tem dois conjuntos de APIs, um para o nível de serviço e o outro para o nível de gerenciamento. A nomenclatura costuma ser semelhante, mas retorna resultados diferentes.
Somente ações das APIs de gerenciamento são rastreadas no log de atividades. As APIs de nível de serviço ignoram a camada de Gerenciamento de Recursos do Azure (management.azure.com) e não são registradas.
Por exemplo, a API do serviço de Lote para excluir um pool é direcionada diretamente para a conta do lote: DELETE {batchUrl}/pools/{poolId}
Ao passo que a API de gerenciamento de lotes para excluir um pool é direcionada à camada management.azure.com: DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}
APIs de serviço em lote
Os aplicativos e serviços podem emitir chamadas da REST API diretamente ou usar uma ou mais das bibliotecas de cliente a seguir para executar e gerenciar as cargas de trabalho do Lote do Azure.
API | Referência de API | Baixar | Tutorial | Exemplos de código | Obter mais informações |
---|---|---|---|---|---|
REST do Lote | API REST do Azure – Documentação | N/D | - | - | Versões com suporte |
.NET do Lote | SDK do Azure para .NET – Documentação | NuGet | Tutorial | GitHub | Notas de versão |
Python em lotes | SDK do Azure para Python – Documentação | PyPI | Tutorial | GitHub | Leiame |
JavaScript do Lote | SDK do Azure para JavaScript – Documentação | npm | Tutorial | - | Leiame |
Lote Java | SDK do Azure para Java – Documentação | Maven | - | GitHub | Leiame |
APIs de Gerenciamento do Lote
As APIs do Azure Resource Manager para o Lote fornecem acesso programático a contas do Lote. Usando essas APIs, você pode gerenciar programaticamente contas, cotas, pacotes de aplicativos e outros recursos do Lote por meio do provedor Microsoft.Batch.
API | Referência de API | Baixar | Tutorial | Exemplos de código |
---|---|---|---|---|
REST do Gerenciamento do Lote | API REST do Azure – Documentação | - | - | GitHub |
.NET de Gerenciamento do Lote | SDK do Azure para .NET – Documentação | NuGet | Tutorial | GitHub |
Python de Gerenciamento do Lote | SDK do Azure para Python – Documentação | PyPI | - | - |
JavaScript do Gerenciamento de Lote | SDK do Azure para JavaScript – Documentação | npm | - | - |
Java de Gerenciamento do Lote | SDK do Azure para Java – Documentação | Maven | - | - |
Ferramentas de linha de comando do Lote
Essas ferramentas de linha de comando fornecem a mesma funcionalidade que o serviço do Lote e as APIs de gerenciamento do Lote:
- Batch PowerShell cmdlets: Os cmdlets do Lote do Azure no módulo do Azure PowerShell permitem que você gerencie recursos do Lote com o PowerShell.
- CLI do Azure: A CLI do Azure é um conjunto de ferramentas multiplataforma que fornece comandos do shell para interação com muitos serviços do Azure, incluindo o serviço de Lote e o serviço de Gerenciamento de Lote. Para mais informações, confira Gerenciar recursos de Lote com a CLI do Azure.
Outras ferramentas para desenvolvimento de aplicativos
Essas ferramentas adicionais podem ser úteis para compilar e depurar seus aplicativos e serviços do Lote.
- Portal do Azure: Crie, monitore e exclua pools, trabalhos e tarefas do Lote no portal do Azure. Você pode exibir as informações de status para esses e outros recursos ao executar seus trabalhos e até mesmo baixar arquivos de nós de computação em seus pools. Por exemplo, você pode baixar uma
stderr.txt
de uma tarefa com falha durante a solução de problemas. Você também pode baixar arquivos da área de trabalho remota (RDP) que pode usar para fazer logon em nós de computação. - Azure Batch Explorer: o Batch Explorer é uma ferramenta de cliente autônomo gratuita, rica em funcionalidades para ajudar a criar, depurar e monitorar aplicativos do Azure Batch. Baixe um pacote de instalação para Mac, Linux ou Windows.
- Gerenciador de Armazenamento do Azure: Embora não seja estritamente uma ferramenta de Lote do Azure, o Gerenciador de Armazenamento pode ser útil durante o desenvolvimento e a depuração de suas soluções de Lote.
Recursos adicionais
- Para saber mais sobre o registro de eventos do aplicativo do Lote, consulte Métricas, alertas e logs de Lote para avaliação e monitoramento de diagnóstico.
- Para obter informações de referência sobre eventos gerados pelo serviço do Lote, consulte Análise do Lote.
- Para obter informações sobre variáveis de ambiente para nós de computação, consulte Variáveis de ambiente do runtime do Lote do Azure.
Próximas etapas
- Saiba mais sobre o Fluxo de trabalho e recursos primários do serviço de lote como pools, nós, trabalhos e tarefas.
- Introdução à biblioteca do Lote do Azure para .NET para aprender a usar o C# e a biblioteca do .NET do Lote para executar uma carga de trabalho simples usando um fluxo de trabalho comum do Lote. Uma versão do Python e um tutorial do JavaScript também estão disponíveis.
- Baixe os exemplos de código no GitHub para ver como o C# e o Python podem interagir com o Lote para agendar e processar cargas de trabalho de exemplo.