Usar perfis de versão de API com Node.js SDK (software development kit) no Azure Stack Hub

perfis de versão de Node.js e API

Você pode usar Node.js SDK para ajudar a criar e gerenciar a infraestrutura para seus aplicativos. Os perfis de API no SDK do Node.js ajudam com suas soluções de nuvem híbrida, permitindo alternar entre recursos globais do Azure e recursos do Azure Stack Hub. Você pode codificar uma vez e, em seguida, direcionar o Azure global e o Azure Stack Hub.

Neste artigo, você pode usar o Visual Studio Code como sua ferramenta de desenvolvimento. O Visual Studio Code pode depurar o SDK do Node.js e permite que você execute o aplicativo e envie o aplicativo por push para sua instância do Azure Stack Hub. Você pode depurar do Visual Studio Code ou por meio de uma janela de terminal executando o comando node <nodefile.js>.

O SDK do Node.js

O SDK do Node.js fornece ferramentas do Azure Stack Hub Resource Manager. Os provedores de recursos no SDK incluem computação, rede, armazenamento, serviços de aplicativo e KeyVault. Há 10 bibliotecas de clientes do provedor de recursos que você pode instalar em seu aplicativo node.js. Você também pode baixar a especificação de qual provedor de recursos você usará para o perfil 2020-09-01 para otimizar a memória do aplicativo. Cada módulo consiste em um provedor de recursos, a respectiva versão da API e o perfil de API.

Um perfil de API é uma combinação de provedores de recursos e versões de API. Você pode usar um perfil de API para obter a versão mais recente e estável de cada tipo de recurso em um pacote de provedor de recursos.

• Para usar as versões mais recentes de todos os serviços, use o perfil mais recente dos pacotes.

• Para usar os serviços compatíveis com o Azure Stack Hub, use o @azure/arm-resources-profile-hybrid-2020-09-01 ou @azure/arm-storage-profile-2020-09-01-hybrid

Pacotes do NPM

Cada provedor de recursos tem seu próprio pacote. Você pode obter o pacote do registro npm.

Você pode encontrar os seguintes pacotes:

Para usar a versão mais recente da API de um serviço, use o perfil mais recente da biblioteca de clientes específica. Por exemplo, se você quiser usar apenas a versão mais recente da API do serviço de recursos, use o azure-arm-resource perfil da Biblioteca de Clientes de Gerenciamento de Recursos.

Use as versões de API específicas definidas dentro do pacote para as versões de API específicas de um provedor de recursos.

• @azure/arm-resourceprovider-profile-2020-09-01-hybrid

  Perfil mais recente criado para o Azure Stack Hub. Use esse perfil para que os serviços sejam mais compatíveis com o Azure Stack Hub, desde que você esteja com o selo 1808 ou posterior.

• @azure-arm-resource

  O perfil consiste em versões mais recentes de todos os serviços. Use as versões mais recentes de todos os serviços no Azure.

Perfis

Para perfis que contêm datas, para usar um perfil ou versão do SDK diferente, você pode substituir a data em @azure/arm-keyvault-profile-<date>-hybrid. Por exemplo, para a versão 2008, o perfil é 2019-03-01, e a cadeia de caracteres se torna @azure/arm-keyvault-profile-2019-03-01-hybrid. Observe que, às vezes, a equipe do SDK altera o nome dos pacotes, portanto, simplesmente substituir a data de uma cadeia de caracteres por uma data diferente pode não funcionar. Consulte a tabela a seguir para associação de perfis e versões do Azure Stack.

Para obter mais informações sobre o Azure Stack Hub e perfis de API, consulte o resumo dos perfis de API.

Instalar o SDK do Node.js

1. Instale o Git. Para obter instruções, consulte Introdução – Instalando o Git.

2. Instalar ou atualizar para a versão atual do Node.js. Node.js também inclui o gerenciador de pacotes JavaScript npm .

3. Instale ou atualize o Visual Studio Code e instale a extensãoNode.js para o Visual Studio Code.

4. Instale os pacotes de cliente para o Gerenciador de Recursos do Azure Stack Hub. Para obter mais informações, confira como instalar bibliotecas de clientes.

5. Os pacotes que precisam ser instalados dependem da versão de perfil que você deseja usar. Você pode encontrar uma lista de provedores de recursos na seção Pacotes no npm .

Subscrição

Se você ainda não tiver uma assinatura, crie uma assinatura e salve a ID da assinatura a ser usada posteriormente. Para obter informações sobre como criar uma assinatura, consulte este documento.

Entidade de serviço

Uma entidade de serviço e suas informações de ambiente associadas devem ser criadas e salvas em algum lugar. A entidade de serviço com owner função é recomendada, mas dependendo do exemplo, uma contributor função pode ser suficiente. Consulte o README no repositório de exemplo para os valores necessários. Você pode ler esses valores em qualquer formato compatível com a linguagem SDK, como em um arquivo JSON (que nossos exemplos usam). Dependendo do exemplo que está sendo executado, nem todos esses valores podem ser usados. Consulte o repositório de exemplo para obter o código de exemplo atualizado ou mais informações.

ID do locatário

Para localizar o diretório ou a ID do locatário do Azure Stack Hub, siga as instruções neste artigo.

Registrar provedores de recursos

Registre os provedores de recursos necessários seguindo este documento. Esses provedores de recursos serão necessários dependendo dos exemplos que você deseja executar. Por exemplo, se você quiser executar um exemplo de VM, o registro do Microsoft.Compute provedor de recursos será necessário.

Ponto de extremidade do Azure Stack Resource Manager

O ARM (Azure Resource Manager) é uma estrutura de gerenciamento que permite que os administradores implantem, gerenciem e monitorem recursos do Azure. O Azure Resource Manager pode lidar com essas tarefas como um grupo, em vez de individualmente, em uma única operação. Você pode obter as informações de metadados do ponto de extremidade do Resource Manager. O ponto de extremidade retorna um arquivo JSON com as informações necessárias para executar seu código.

Considere o seguinte:

• O ResourceManagerEndpointUrl no ASDK (Azure Stack Development Kit) é: https://management.local.azurestack.external/.

• O ResourceManagerEndpointUrl em sistemas integrados é: https://management.region.<fqdn>/, onde <fqdn> está seu nome de domínio totalmente qualificado.

• Para recuperar os metadados necessários: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

JSON de exemplo:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Exemplos

Consulte o repositório de exemplo para obter o código de exemplo atualizado. A raiz README.md descreve os requisitos gerais e cada subdiretório contém um exemplo específico sobre README.md como executar esse exemplo.

Próximas etapas

Saiba mais sobre perfis de API:

• Gerenciar perfis de versão de API no Azure Stack Hub
• Versões da API do provedor de recursos compatíveis com perfis