Compartilhar via


Azure ContainerService client library for JavaScript - version 24.0.0

Esse pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente do Azure ContainerService.

O cliente do Serviço de Contêiner.

Código-fonte | Pacote (NPM) | Documentação | Amostras

Como começar

Ambientes com suporte no momento

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

Prerequisites

Instalar o pacote @azure/arm-containerservice

Instale a biblioteca de clientes do Azure ContainerService para JavaScript com npm:

npm install @azure/arm-containerservice

Criar e autenticar um ContainerServiceClient

Para criar um objeto cliente para acessar a API do Azure ContainerService, você precisará do endpoint do recurso do Azure ContainerService e de um credential. O cliente containerService do Azure pode usar credenciais do Azure Active Directory para autenticar. Você pode encontrar o ponto de extremidade para o recurso do Azure ContainerService nodo Portal do Azure .

Você pode autenticar com o Azure Active Directory usando uma credencial da biblioteca de de @azure/identidade ou um token do AAD existente.

Para usar o provedor DefaultAzureCredential mostrado abaixo ou outros provedores de credenciais fornecidos com o SDK do Azure, instale o @azure/identity pacote:

npm install @azure/identity

Você também precisará registrar um novo aplicativo do AAD e conceder acesso ao Azure ContainerService atribuindo a função adequada à entidade de serviço (observação: funções como "Owner" não concederão as permissões necessárias).

Para obter mais informações sobre como criar um aplicativo do Azure AD, confira este guia.

Usando ambientes semelhantes a Node.js e nó, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

import { ContainerServiceClient } from "@azure/arm-containerservice";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ContainerServiceClient(new DefaultAzureCredential(), subscriptionId);

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ContainerServiceClient } from "@azure/arm-containerservice";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ContainerServiceClient(credential, subscriptionId);

Pacote JavaScript

Para usar essa biblioteca de clientes no navegador, primeiro você precisa usar um empacotador. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agrupamento .

Conceitos principais

ContainerServiceClient

ContainerServiceClient é a interface principal para desenvolvedores que usam a biblioteca de clientes do Azure ContainerService. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço ContainerService do Azure que você pode acessar.

Troubleshooting

Logging

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 runtime chamando setLogLevel no @azure/logger:

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

setLogLevel("info");

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

Próximas etapas

Examine os exemplos de diretório para obter exemplos detalhados sobre como usar essa biblioteca.

Contributing

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

  • do SDK do Microsoft Azure para JavaScript