Condividi tramite

Usare i profili di versione api con Node.js software development kit (SDK) nell'hub di Azure Stack

  • Articolo

profili di versione Node.js e API

È possibile usare Node.js SDK per creare e gestire l'infrastruttura per le app. I profili API nell'SDK di Node.js consentono di usare le soluzioni cloud ibride consentendo di passare tra risorse globali di Azure e risorse dell'hub di Azure Stack. È possibile eseguire il codice una sola volta e quindi usare l'hub di Azure e Azure Stack globale.

In questo articolo è possibile usare Visual Studio Code come strumento di sviluppo. Visual Studio Code può eseguire il debug dell'SDK di Node.js e consente di eseguire l'app e eseguire il push dell'app nell'istanza dell'hub di Azure Stack. È possibile eseguire il debug da Visual Studio Code o tramite una finestra del terminale che esegue il comando node <nodefile.js>.

SDK di Node.js

L'SDK di Node.js fornisce strumenti di Resource Manager hub di Azure Stack. I provider di risorse nell'SDK includono calcolo, rete, archiviazione, servizi app e KeyVault. Esistono 10 librerie client del provider di risorse che è possibile installare nell'applicazione node.js. È anche possibile scaricare specificare quale provider di risorse usare per il profilo 2020-09-01 per ottimizzare la memoria per l'applicazione. Ogni modulo è costituito da un provider di risorse, dalla rispettiva versione DELL'API e dal profilo API.

Un profilo API è una combinazione di provider di risorse e versioni API. È possibile usare un profilo API per ottenere la versione più recente e stabile di ogni tipo di risorsa in un pacchetto del provider di risorse.

  • Per usare le versioni più recenti di tutti i servizi, usare il profilo più recente dei pacchetti.

  • Per usare i servizi compatibili con l'hub di Azure Stack, usare il @azure/arm-resources-profile-hybrid-2020-09-01 o @azure/arm-storage-profile-2020-09-01-hybrid

Pacchetti NPM

Ogni provider di risorse ha il proprio pacchetto. È possibile ottenere il pacchetto dal registro npm.

È possibile trovare i pacchetti seguenti:

Provider di risorse Pacchetto
Servizio app @azure/arm-resources-profile-2020-09-01-hybrid
Sottoscrizioni di Azure Resource Manager @azure/arm-subscriptions-profile-hybrid-2020-09-01
Criteri di Resource Manager di Azure @azure/arm-policy-profile-hybrid-2020-09-01
DNS di Azure Resource Manager @azure/arm-dns-profile-2020-09-01-hybrid
Autorizzazione @azure/arm-authorization-profile-2020-09-01-hybrid
Calcolo @azure/arm-compute-profile-2020-09-01-hybrid
Archiviazione @azure/arm-storage-profile-2020-09-01-hybrid
Rete @azure/arm-network-profile-2020-09-01-hybrid
Risorse @azure/arm-resources-profile-hybrid-2020-09-01
Keyvault @azure/arm-keyvault-profile-2020-09-01-hybrid

Per usare la versione più recente dell'API di un servizio, usare il profilo più recente della libreria client specifica. Ad esempio, se si vuole usare la versione più recente del servizio risorse, usare il azure-arm-resource profilo della libreria client di Gestione risorse.

Usare le versioni API specifiche definite all'interno del pacchetto per le versioni API specifiche di un provider di risorse.

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

    Profilo più recente compilato per l'hub di Azure Stack. Usare questo profilo per i servizi per essere più compatibili con l'hub di Azure Stack fino a quando si è in 1808 stamp o altro ancora.

  • @azure-arm-resource

    Il profilo è costituito da versioni più recenti di tutti i servizi. Usare le versioni più recenti di tutti i servizi in Azure.

Profiles

Per i profili contenenti date, per usare un profilo SDK o una versione diversa, è possibile sostituire la data in @azure/arm-keyvault-profile-<date>-hybrid. Ad esempio, per la versione 2008, il profilo è 2019-03-01e la stringa diventa @azure/arm-keyvault-profile-2019-03-01-hybrid. Si noti che a volte il team SDK modifica il nome dei pacchetti, quindi è sufficiente sostituire la data di una stringa con una data diversa potrebbe non funzionare. Vedere la tabella seguente per l'associazione di profili e versioni di Azure Stack.

Versione di Azure Stack Profilo
2311 2020_09_01
2301 2020_09_01
2206 2020_09_01
2108 2020-09-01
2102 2020-09-01
2008 2019-03-01

Per altre informazioni sui profili dell'hub e delle API di Azure Stack, vedere Riepilogo dei profili API.

Installare Node.js SDK

  1. Installare Git. Per istruzioni, vedere Introduzione - Installazione di Git.

  2. Installare o eseguire l'aggiornamento alla versione corrente di Node.js. Node.js include anche la gestione pacchetti JavaScript npm .

  3. Installare o aggiornare Visual Studio Code e installare l'estensioneNode.js per Visual Studio Code.

  4. Installare i pacchetti client per Azure Stack Hub Resource Manger. Per altre informazioni, vedere come installare le librerie client.

  5. I pacchetti che devono essere installati dipendono dalla versione del profilo da usare. È possibile trovare un elenco di provider di risorse nella sezione Pacchetti in npm .

Subscription

Se non si ha già una sottoscrizione, creare una sottoscrizione e salvare l'ID sottoscrizione da usare in un secondo momento. Per informazioni su come creare una sottoscrizione, vedere questo documento.

Entità servizio

È necessario creare e salvare un'entità servizio e le relative informazioni sull'ambiente associate. L'entità servizio con owner ruolo è consigliata, ma a seconda dell'esempio, un contributor ruolo può essere sufficiente. Per i valori necessari, vedere README nel repository di esempio . È possibile leggere questi valori in qualsiasi formato supportato dal linguaggio SDK, ad esempio da un file JSON (che vengono usati dagli esempi). A seconda dell'esecuzione dell'esempio, non tutti questi valori possono essere usati. Vedere il repository di esempio per il codice di esempio aggiornato o altre informazioni.

ID tenant

Per trovare la directory o l'ID tenant per l'hub di Azure Stack, seguire le istruzioni riportate in questo articolo.

Registrare i provider di risorse

Registrare i provider di risorse necessari seguendo questo documento. Questi provider di risorse saranno necessari a seconda degli esempi da eseguire. Ad esempio, se si vuole eseguire un esempio di macchina virtuale, è necessaria la registrazione del Microsoft.Compute provider di risorse.

Endpoint di Azure Stack resource manager

Azure Resource Manager (ARM) è un framework di gestione che consente agli amministratori di distribuire, gestire e monitorare le risorse di Azure. Azure Resource Manager può gestire queste attività come gruppo, anziché singolarmente, in una singola operazione. È possibile ottenere le informazioni sui metadati dall'endpoint di Resource Manager. L'endpoint restituisce un file JSON con le informazioni necessarie per eseguire il codice.

Considerare quanto segue:

  • ResourceManagerEndpointUrl in Azure Stack Development Kit (ASDK) è: https://management.local.azurestack.external/.

  • ResourceManagerEndpointUrl nei sistemi integrati è: https://management.region.<fqdn>/, dove <fqdn> è il nome di dominio completo.

  • Per recuperare i metadati necessari: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

JSON di esempio:

{
   "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"]
      }
}

Esempi

Vedere il repository di esempio per il codice di esempio aggiornato. La radice README.md descrive i requisiti generali e ogni sottocartella contiene un esempio specifico con il proprio README.md su come eseguire tale esempio.

Per l'esempio applicabile alla versione 2008 o al profilo 2019-03-01 di Azure Stack, vedere qui.

Passaggi successivi

Altre informazioni sui profili API: