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

Node.js e perfis de versionamento de API

Você pode usar Node.js SDK para ajudar a criar e gerenciar a infraestrutura de 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 recursos globais do Azure e recursos do Azure Stack Hub. Você pode programar uma vez e depois direcionar tanto o Azure global quanto 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 para sua instância do Azure Stack Hub. Você pode depurar a partir do Visual Studio Code ou através de uma janela de terminal executando o comando node <nodefile.js>.

O SDK 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 cliente do provedor de recursos que você pode instalar em seu aplicativo node.js. Você também pode baixar para especificar qual provedor de recursos você usará para o perfil 2020-09-01, a fim de otimizar a memória para seu aplicativo. Cada módulo consiste em um provedor de recursos, a respetiva versão da API e o perfil da 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 fazer uso das 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. Pode obter o pacote do repositório 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 cliente específica. Por exemplo, se quiser utilizar apenas a última versão da API do serviço de gestão de recursos, deverá usar o azure-arm-resource perfil do pacote Biblioteca do Cliente de Gestão 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 este perfil para que os serviços sejam mais compatíveis com o Azure Stack Hub, desde que esteja na versão 1808 ou posterior.

• @azure-braço-recurso

  O perfil consiste das 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 contenham datas, para usar um perfil ou versão diferente do SDK, você pode substituir a data no @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. 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 o Visual Studio Code e instale a extensãoNode.js para Visual Studio Code.

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

5. Os pacotes que precisam ser instalados dependem da versão do perfil que você gostaria de usar. Você pode encontrar uma lista de provedores de recursos na seçã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 assinatura, consulte este documento.

Entidade de serviço

Uma entidade de serviço e as suas informações de ambiente correspondentes devem ser criadas e guardadas em algum lugar. A entidade de serviço com owner função é recomendada, mas, dependendo da amostra, uma contributor função pode ser suficiente. Consulte o LEIA-ME no repositório de exemplo para obter os valores necessários. Você pode ler esses valores em qualquer formato suportado pela linguagem SDK, como a partir de um arquivo JSON (que nossos exemplos usam). Dependendo da amostra que está a ser executada, nem todos estes valores podem ser utilizados. Consulte 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 a ID do locatário para seu 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 gerenciador de recursos do Azure Stack

O Azure Resource Manager (ARM) é 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 os metadados do ponto final do Gerenciador de Recursos. 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 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 totalmente qualificado.

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

Exemplo de JSON:

{
   "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 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.

Próximos passos

Saiba mais sobre perfis de API:

• Gerenciar perfis de versão da API no Azure Stack Hub
• Versões da API do provedor de recursos suportadas por perfis