Utilizar a versão da API Perfis com Node.js software development kit (SDK) no Azure Stack Hub

  • Artigo

Node.js e perfis de versão da API

Pode utilizar Node.js SDK para ajudar a criar e gerir a infraestrutura das suas aplicações. Os perfis de API no SDK Node.js ajudam com as suas soluções de cloud híbrida, permitindo-lhe alternar entre os recursos globais do Azure e os recursos do Azure Stack Hub. Pode codificar uma vez e, em seguida, direcionar o Azure global e o Azure Stack Hub.

Neste artigo, pode utilizar o Visual Studio Code como ferramenta de desenvolvimento. O Visual Studio Code pode depurar a Node.js SDK e permite-lhe executar a aplicação e enviar a aplicação para a instância do Azure Stack Hub. Pode depurar a partir do Visual Studio Code ou através de uma janela de terminal com o comando node <nodefile.js>.

O SDK Node.js

O SDK Node.js fornece ferramentas de Resource Manager do Azure Stack Hub. Os fornecedores de recursos no SDK incluem computação, rede, armazenamento, serviços de aplicações e KeyVault. Existem 10 bibliotecas de cliente do fornecedor de recursos que pode instalar na sua aplicação node.js. Também pode transferir especificar o fornecedor de recursos que irá utilizar para o perfil 2020-09-01 para otimizar a memória da sua aplicação. Cada módulo é composto por um fornecedor de recursos, a respetiva versão da API e o perfil da API.

Um perfil de API é uma combinação de fornecedores de recursos e versões de API. Pode utilizar um perfil de API para obter a versão mais recente e estável de cada tipo de recurso num pacote de fornecedor de recursos.

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

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

Pacotes NPM

Cada fornecedor de recursos tem o seu próprio pacote. Pode obter o pacote a partir do registo npm.

Pode encontrar os seguintes pacotes:

Fornecedor de recursos Pacote
Serviço de Aplicações @azure/arm-resources-profile-2020-09-01-hybrid
Subscrições 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 do Azure Resource Manager @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
Armazenamento @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
Cofre de Chaves @azure/arm-keyvault-profile-2020-09-01-hybrid

Para utilizar a versão mais recente da API de um serviço, utilize o perfil Mais Recente da biblioteca de cliente específica. Por exemplo, se quiser utilizar apenas a versão mais recente da API do serviço de recursos, utilize o azure-arm-resource perfil da Biblioteca de Clientes de Gestão de Recursos.

Utilize as versões de API específicas definidas no pacote para as versões de API específicas de um fornecedor de recursos.

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

    Perfil mais recente criado para o Azure Stack Hub. Utilize este perfil para que os serviços sejam mais compatíveis com o Azure Stack Hub, desde que esteja no carimbo 1808 ou mais.

  • @azure-arm-resource

    O perfil é composto por versões mais recentes de todos os serviços. Utilize as versões mais recentes de todos os serviços no Azure.

Perfis

Para perfis que contenham datas, para utilizar um perfil ou versão do SDK diferente, pode substituir a data em @azure/arm-keyvault-profile-<date>-hybrid. Por exemplo, para a versão de 2008, o perfil é 2019-03-01e a cadeia torna-se @azure/arm-keyvault-profile-2019-03-01-hybrid. Tenha em atenção que, por vezes, a equipa do SDK altera o nome dos pacotes, pelo que simplesmente substituir a data de uma cadeia por uma data diferente poderá não funcionar. Veja a tabela seguinte para associar 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 2019-03-01

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

Instalar o SDK do Node.js

  1. Instale o Git. Para obter instruções, veja Introdução - Instalar o Git.

  2. Instale ou atualize para a versão atual do Node.js. Node.js também inclui o gestor 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 do Resource Manger do Azure Stack Hub. Para obter mais informações, veja como instalar bibliotecas de cliente.

  5. Os pacotes que precisam de ser instalados dependem da versão de perfil que pretende utilizar. Pode encontrar uma lista de fornecedores de recursos na secção Pacotes no npm .

Subscrição

Se ainda não tiver uma subscrição, crie uma subscrição e guarde o ID da subscrição para ser utilizado mais tarde. Para obter informações sobre como criar uma subscrição, veja este documento.

Service principal (Principal de serviço)

Um principal de serviço e as respetivas informações de ambiente associadas devem ser criadas e guardadas algures. O principal de serviço com owner função é recomendado, mas dependendo do exemplo, uma função contributor pode ser suficiente. Veja o README no repositório de exemplo para obter os valores necessários. Pode ler estes valores em qualquer formato suportado pela linguagem SDK, como a partir de um ficheiro JSON (que os nossos exemplos utilizam). Consoante o exemplo que está a ser executado, nem todos estes valores podem ser utilizados. Veja o repositório de exemplo para obter código de exemplo atualizado ou mais informações.

ID do inquilino

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

Registar fornecedores de recursos

Registe os fornecedores de recursos necessários ao seguir este documento. Estes fornecedores de recursos serão necessários consoante os exemplos que pretende executar. Por exemplo, se quiser executar um exemplo de VM, é necessário o registo do Microsoft.Compute fornecedor de recursos.

Ponto final do gestor de recursos do Azure Stack

O Azure Resource Manager (ARM) é uma arquitetura de gestão que permite aos administradores implementar, gerir e monitorizar recursos do Azure. O Azure Resource Manager pode processar estas tarefas como um grupo, em vez de individualmente, numa única operação. Pode obter as informações de metadados a partir do ponto final Resource Manager. O ponto final devolve um ficheiro JSON com as informações necessárias para executar o código.

Considere o seguinte:

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

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

  • Para obter 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"]
      }
}

Amostras

Veja o repositório de exemplo para obter o código de exemplo atualizado até à data. A raiz README.md descreve os requisitos gerais e cada subdiretório contém uma amostra específica com o seu próprio README.md sobre como executar esse exemplo.

Veja aqui o exemplo aplicável à versão 2008 ou perfil 2019-03-01 do Azure Stack e abaixo.

Passos seguintes

Saiba mais sobre os perfis de API: