Biblioteca de clientes do Red Hat OpenShift do Azure para JavaScript – versão 1.0.0-beta.1

  • Artigo

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

API rest para o Red Hat OpenShift 4 do Azure

NPM (pacote de | de código-fonte) | documentação de referência da API | Exemplos

Introdução

Ambientes com suporte no momento

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

Pré-requisitos

Instalar o pacote @azure/arm-redhatopenshift

Instale a biblioteca de clientes do Red Hat OpenShift do Azure para JavaScript com npm:

npm install @azure/arm-redhatopenshift

Criar e autenticar um AzureRedHatOpenShiftClient

Para criar um objeto cliente para acessar a API do Red Hat OpenShift no Azure, você precisará do endpoint do recurso do Red Hat OpenShift do Azure e de um credential. O cliente Red Hat OpenShift do Azure pode usar credenciais do Azure Active Directory para autenticar. Você pode encontrar o ponto de extremidade para o recurso do Red Hat OpenShift no 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 pacote @azure/identity:

npm install @azure/identity

Você também precisará registrar um novo aplicativo do AAD e conceder acesso ao Red Hat OpenShift do Azure atribuindo a função adequada à entidade de serviço (observação: funções como "Owner" não concederão as permissões necessárias). Defina os valores da ID do cliente, da ID do locatário e do segredo do cliente do aplicativo AAD como variáveis de ambiente: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

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

const { AzureRedHatOpenShiftClient } = require("@azure/arm-redhatopenshift");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

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

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new AzureRedHatOpenShiftClient(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 .

Principais conceitos

AzureRedHatOpenShiftClient

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

Solucionando problemas

Log

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:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

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

Próximas etapas

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

Contribuindo

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

impressões