Azure Batch client library for JavaScript - version 13.0.0

Este pacote contém um SDK isomorfo (executa tanto em Node.js como em browsers) para o cliente Azure Batch.

O Azure Batch fornece agendamento de tarefas em escala de nuvem e gerenciamento de computação.

Como Começar

Ambientes atualmente suportados

Consulte a nossa política de suporte para obter mais detalhes.

Pré-requisitos

  • Uma assinatura do Azure.

Instalar o pacote @azure/batch

Instale a biblioteca cliente Azure Batch para JavaScript com npm:

npm install @azure/batch

Criar e autenticar um BatchClient

Para criar um objeto cliente para aceder à API Azure Batch, vai precisar do endpoint seu recurso Azure Batch e de um credential. O cliente Azure Batch pode usar credenciais Azure Active Directory para autenticar. Pode encontrar o endpoint para o seu recurso Azure Batch no portal do Azure.

O lote do Azure dá suporte à autenticação por meio da ID do Microsoft Entra ou da Chave Compartilhada.

Microsoft Entra ID

Pode autenticar com o Azure Entra ID usando uma credencial da biblioteca @azure/identidade ou um Token AAD existente.

Para usar o fornecedor DefaultAzureCredential mostrado abaixo, ou outros fornecedores de credenciais fornecidos com o SDK do Azure, por favor instale o pacote @azure/identity:

npm install @azure/identity

Também terá de registar uma nova candidatura AAD e conceder acesso ao Azure Batch atribuindo o papel adequado ao seu principal de serviço (nota: funções como este "Owner" não concedem as permissões necessárias).

Para mais informações sobre como criar uma Azure Aplicação AD, consulte este guia.

Usando ambientes Node.js e Node-like, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

import { BatchClient } from "@azure/batch";
import { DefaultAzureCredential } from "@azure/identity";

const client = new BatchClient("<endpoint>", new DefaultAzureCredential());

Para ambientes de navegador, use o InteractiveBrowserCredential do pacote @azure/identity para autenticar.

import { InteractiveBrowserCredential } from "@azure/identity";
import { BatchClient } from "@azure/batch";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new BatchClient("<endpoint>", credential);

Chave Partilhada

Para usar a chave partilhada para autenticar, deve primeiro npm instalar @azure/core-auth, depois fornecer o nome da conta e a chave da conta para construir uma AzureNamedKeyCredential credencial a partir @azure/core-authde .

Note-se que a autenticação por Chave de Partilha só é suportada em ambientes Node.js e semelhantes a Node.

import { AzureNamedKeyCredential } from "@azure/core-auth";
import { BatchClient } from "@azure/batch";

const credential = new AzureNamedKeyCredential("<account name>", "<account key>");
const client = new BatchClient("<endpoint>", credential);

Pacote JavaScript

Para usar essa biblioteca de cliente no navegador, primeiro você precisa usar um bundler. Para detalhes sobre como to do isto, consulte a nossa documentação de agrupamento.

Conceitos-chave

BatchClient

BatchClient é a interface principal para programadores que utilizam a biblioteca cliente Azure Batch. Explore os métodos neste objeto cliente para compreender as diferentes funcionalidades do serviço Batch Azure a que pode aceder.

Troubleshooting

Exploração florestal

Habilitar o registro em log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o registro em log pode ser habilitado em tempo de execução chamando setLogLevel no @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Para obter instruções mais detalhadas sobre como habilitar logs, você pode consultar os documentos do pacote @azure/logger.

Contributing

Se você quiser contribuir para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.

  • Last updated on