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

  • Artigo

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 que você alterne entre os recursos globais do Azure e os 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 Visual Studio Code como sua ferramenta de desenvolvimento. Visual Studio Code pode depurar o SDK do Node.js e permite executar o aplicativo e efetuar push do aplicativo para sua instância do Azure Stack Hub. Você pode depurar de 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 de Resource Manager do Azure Stack Hub. Os provedores de recursos no SDK incluem computação, rede, armazenamento, serviços de aplicativos 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 especifique 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 NPM

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

Você pode encontrar os seguintes pacotes:

Provedor de recursos Pacote
Serviço de Aplicativo @azure/arm-resources-profile-2020-09-01-hybrid
Assinaturas do Azure Resource Manager @azure/arm-subscriptions-profile-hybrid-2020-09-01
Política de Resource Manager do Azure @azure/arm-policy-profile-hybrid-2020-09-01
DNS Resource Manager do Azure @azure/arm-dns-profile-2020-09-01-hybrid
Autorização @azure/arm-authorization-profile-2020-09-01-hybrid
Computação @azure/arm-compute-profile-2020-09-01-hybrid
Storage @azure/arm-storage-profile-2020-09-01-hybrid
Rede @azure/arm-network-profile-2020-09-01-hybrid
Recursos @azure/arm-resources-profile-hybrid-2020-09-01
Keyvault @azure/arm-keyvault-profile-2020-09-01-hybrid

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 do pacote Biblioteca de Clientes do 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 usando um 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 diferente do SDK, você pode substituir a data em @azure/arm-keyvault-profile-<date>-hybrid. Por exemplo, para a versão 2008, o perfil é 2019-03-01e 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.

Versão do Azure Stack Perfil
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 01/03/2019

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. Instale ou atualize para a versão atual do Node.js. Node.js também inclui o gerenciador de pacotes JavaScript npm .

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

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

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

Subscription

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 LEIAME no repositório de exemplo para obter os valores necessários. Você pode ler esses valores em qualquer formato compatível com a linguagem SDK, como de 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 a ID do diretório ou 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 aos administradores implantar, gerenciar e monitorar 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 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 (Kit de Desenvolvimento do Azure Stack) é: https://management.local.azurestack.external/.

  • O ResourceManagerEndpointUrl em sistemas integrados é: https://management.region.<fqdn>/, em que <fqdn> é o 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 com seu próprio README.md sobre como executar esse exemplo.

Consulte aqui para obter o exemplo aplicável para a versão 2008 ou perfil 2019-03-01 do Azure Stack e abaixo.

Próximas etapas

Saiba mais sobre perfis de API: