Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
profili della versione Node.js e dell'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 le risorse globali di Azure e l'hub di Azure Stack. È possibile codificare una sola volta e quindi impostare come destinazione sia Azure globale che hub di Azure Stack.
In questo articolo è possibile usare Visual Studio Code come strumento di sviluppo. Visual Studio Code può eseguire il debug di Node.js SDK e consente di eseguire l'app ed 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 offre strumenti di Azure Stack Hub Resource Manager. I provider di risorse nell'SDK includono calcolo, rete, archiviazione, servizi app e KeyVault. Sono disponibili 10 librerie client del provider di risorse che è possibile installare nell'applicazione node.js. È anche possibile scaricare e specificare quale fornitore di risorse verrà utilizzato per il profilo 2020-09-01 per ottimizzare la memoria dell'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 un proprio pacchetto. È possibile ottenere il pacchetto dal registro npm.
È possibile trovare i pacchetti seguenti:
| Fornitore 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 Azure Resource Manager | @azure/arm-policy-profile-hybrid-2020-09-01 |
| Azure Resource Manager DNS | @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 |
| Spazio di 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 |
| Insieme di credenziali delle chiavi | @azure/arm-keyvault-profile-2020-09-01-hybrid |
Per usare la versione api più recente di un servizio, usare il profilo più recente della libreria client specifica. Ad esempio, se si vuole usare solo la versione più recente dell'API delle risorse, usare il azure-arm-resource profilo della libreria client di Gestione delle 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 garantire la massima compatibilità dei servizi con Azure Stack Hub, purché si utilizzi la versione 1808 o successiva.
@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.
Profili
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 la semplice sostituzione della 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 | 01/09/2020 |
| 2301 | 01/09/2020 |
| 2206 | 01/09/2020 |
| 2108 | 2020-09-01 |
| 2102 | 2020-09-01 |
| 2008 | 2019-03-01 |
Per altre informazioni sull'hub di Azure Stack e sui profili API, vedere Riepilogo dei profili API.
Installare il Node.js SDK
Installare Git. Per istruzioni, vedere Introduzione all'installazione di Git.
Installare o eseguire l'aggiornamento alla versione corrente di Node.js. Node.js include anche la gestione pacchetti JavaScript npm .
Installare o aggiornare Visual Studio Code e installare l'estensioneNode.js per Visual Studio Code.
Installare i pacchetti client per Gestione risorse dell'hub di Azure Stack. Per altre informazioni, vedere come installare le librerie client.
I pacchetti che devono essere installati dipendono dalla versione del profilo che si vuole usare. È possibile trovare un elenco di provider di risorse nella sezione Pacchetti in npm .
Abbonamento
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.
Service Principal
Bisogna creare un principale di servizio e salvare da qualche parte le informazioni sull'ambiente associate. È consigliabile usare un'entità servizio con il ruolo owner, ma a seconda del contesto può essere sufficiente il ruolo contributor. Per i valori richiesti, vedere il README nel repository di esempio. È possibile leggere questi valori in qualsiasi formato supportato dal linguaggio SDK, ad esempio da un file JSON (usato dagli esempi). A seconda dell'esempio in esecuzione, non tutti questi valori possono essere usati. Consultare il repository di esempio per il codice di esempio aggiornato o ulteriori informazioni.
ID del locatario
Per trovare la directory o l'ID tenant per l'hub di Azure Stack, seguire le istruzioni riportate in questo articolo.
Registrare i fornitori 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.
Tenere presente quanto segue:
Il ResourceManagerEndpointUrl in il 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
Consultare il repository di esempio per il codice di esempio aggiornato. La radice README.md descrive i requisiti generali, e ogni sottodirectory contiene un esempio specifico con il proprio README.md su come eseguire quell'esempio.
Vedere qui per l'esempio applicabile per la versione 2008 o il profilo 2019-03-01 di Azure Stack e di seguito.
Passaggi successivi
Altre informazioni sui profili API: