Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
profile wersji Node.js i interfejsu API
Zestaw SDK Node.js ułatwia tworzenie infrastruktury aplikacji i zarządzanie nią. Profile interfejsów API w zestawie SDK Node.js pomagają w rozwiązaniu chmury hybrydowej, umożliwiając przełączanie się między globalnymi zasobami platformy Azure i zasobami usługi Azure Stack Hub. Możesz kodować jeden raz, a następnie kierować do globalnej platformy Azure i usługi Azure Stack Hub.
W tym artykule możesz użyć programu Visual Studio Code jako narzędzia programistycznego. Visual Studio Code może debugować zestaw SDK Node.js i umożliwia uruchamianie aplikacji oraz wysyłanie aplikacji do instancji Azure Stack Hub. Możesz debugować z poziomu programu Visual Studio Code lub za pomocą okna terminalu z uruchomionym poleceniem node <nodefile.js>.
Zestaw SDK Node.js
Zestaw SDK Node.js udostępnia narzędzia usługi Azure Stack Hub Resource Manager. Dostawcy zasobów w zestawie SDK obejmują zasoby obliczeniowe, sieciowe, magazyn, usługi aplikacji i usługę KeyVault. Istnieje 10 bibliotek klienta dostawcy zasobów, które można zainstalować w aplikacji node.js. Możesz również określić, który dostawca zasobów będzie używany dla profilu 2020-09-01, aby zoptymalizować pamięć dla swojej aplikacji. Każdy moduł składa się z dostawcy zasobów, odpowiedniej wersji interfejsu API i profilu interfejsu API.
Profil interfejsu API to kombinacja dostawców zasobów i wersji interfejsu API. Możesz użyć profilu interfejsu API, aby uzyskać najnowszą, najbardziej stabilną wersję każdego typu zasobu w pakiecie dostawcy zasobów.
Aby korzystać z najnowszych wersji wszystkich usług, użyj najnowszego profilu pakietów.
Aby korzystać z usług zgodnych z usługą Azure Stack Hub, użyj @azure/arm-resources-profile-hybrid-2020-09-01 lub @azure/arm-storage-profile-2020-09-01-hybrid
Pakiety NPM
Każdy dostawca zasobów ma własny pakiet. Pakiet można pobrać z rejestru npm.
Możesz znaleźć następujące pakiety:
| Dostawca zasobów | Pakiet |
|---|---|
| App Service | @azure/arm-resources-profile-2020-09-01-hybrid |
| Subskrypcje usługi Azure Resource Manager | @azure/arm-subscriptions-profile-hybrid-2020-09-01 |
| Zasady usługi Azure Resource Manager | @azure/arm-policy-profile-hybrid-2020-09-01 |
| Azure Resource Manager DNS | @azure/arm-dns-profile-2020-09-01-hybrid |
| Autoryzacja | @azure/arm-authorization-profile-2020-09-01-hybrid |
| Liczyć | @azure/arm-compute-profile-2020-09-01-hybrid |
| Przechowywanie | @azure/arm-storage-profile-2020-09-01-hybrid |
| Sieć | @azure/arm-network-profile-2020-09-01-hybrid |
| Zasoby | @azure/arm-resources-profile-hybrid-2020-09-01 |
| Usługa Keyvault | @azure/arm-keyvault-profile-2020-09-01-hybrid |
Aby użyć najnowszej wersji interfejsu API usługi, użyj najnowszego profilu określonej biblioteki klienta. Na przykład, jeśli chcesz użyć tylko najnowszej wersji interfejsu API dla usługi zasobów, skorzystaj z profilu azure-arm-resource z pakietu Biblioteka klienta zarządzania zasobami.
Użyj dedykowanych wersji interfejsu API zdefiniowanych w pakiecie dla konkretnych wersji interfejsu API dostawcy zasobów.
@azure/arm-resourceprovider-profile-2020-09-01-hybrid
Najnowszy profil utworzony dla usługi Azure Stack Hub. Użyj tego profilu, aby zapewnić jak największą zgodność z Azure Stack Hub, o ile masz wersję 1808 lub nowszą.
@azure-arm-resource
Profil składa się z najnowszych wersji wszystkich usług. Użyj najnowszych wersji wszystkich usług na platformie Azure.
Profile
W przypadku profilów zawierających daty, aby użyć innego profilu lub wersji zestawu SDK, możesz zastąpić datę w pliku @azure/arm-keyvault-profile-<date>-hybrid. Na przykład w wersji 2008 profil to 2019-03-01, a ciąg staje się @azure/arm-keyvault-profile-2019-03-01-hybrid. Należy pamiętać, że czasami zespół zestawu SDK zmienia nazwę pakietów, więc po prostu zastąpienie daty ciągu inną datą może nie działać. W poniższej tabeli przedstawiono skojarzenie profilów i wersji usługi Azure Stack.
| Wersja usługi Azure Stack | Profil |
|---|---|
| 2311 | 2020_09_01 |
| 2301 | 2020_09_01 |
| 2206 | 2020_09_01 |
| 2108 | 2020-09-01 |
| 2102 | 2020-09-01 |
| 2008 | 2019-03-01 |
Aby uzyskać więcej informacji na temat profilów usługi Azure Stack Hub i interfejsu API, zobacz Podsumowanie profilów interfejsu API.
Instalowanie zestawu SDK Node.js
Zainstaluj narzędzie Git. Aby uzyskać instrukcje, zobacz Wprowadzenie — instalowanie usługi Git.
Zainstaluj lub uaktualnij do bieżącej wersji programuNode.js. Node.js zawiera również menedżera pakietów npm JavaScript.
Zainstaluj lub uaktualnij program Visual Studio Code i zainstaluj rozszerzenieNode.js dla programu Visual Studio Code.
Zainstaluj pakiety klienta dla menedżera zasobów usługi Azure Stack Hub. Aby uzyskać więcej informacji, zobacz jak zainstalować biblioteki klienckie.
Pakiety, które należy zainstalować, zależą od wersji profilu, której chcesz użyć. Listę dostawców zasobów można znaleźć w sekcji Pakiety w sekcji npm .
Subskrypcja
Jeśli nie masz jeszcze subskrypcji, utwórz subskrypcję i zapisz identyfikator subskrypcji do późniejszego użycia. Aby uzyskać informacje o sposobie tworzenia subskrypcji, zobacz ten dokument.
Jednostka usługi
Obiekt główny usługi oraz powiązane z nim informacje dotyczące środowiska powinny zostać utworzone i zapisane w określonym miejscu. Zalecany jest podmiot usługi z rolą owner, ale w zależności od przykładu może wystarczyć rola contributor. Zapoznaj się z plikiem README w przykładowym repozytorium , aby uzyskać wymagane wartości. Te wartości można odczytać w dowolnym formacie obsługiwanym przez język zestawu SDK, na przykład z pliku JSON (którego używają nasze przykłady). W zależności od uruchamianego przykładu nie wszystkie te wartości mogą być używane. Zobacz przykładowe repozytorium , aby uzyskać zaktualizowany przykładowy kod lub więcej informacji.
Identyfikator dzierżawy
Aby znaleźć katalog lub identyfikator dzierżawy dla usługi Azure Stack Hub, postępuj zgodnie z instrukcjami w tym artykule.
Rejestrowanie dostawców zasobów
Zarejestruj wymaganych dostawców zasobów, postępując zgodnie z tym dokumentem. Ci dostawcy zasobów będą potrzebni w zależności od próbek, które chcesz uruchomić. Jeśli na przykład chcesz uruchomić przykład maszyny wirtualnej, wymagana Microsoft.Compute jest rejestracja dostawcy zasobów.
Punkt końcowy usługi Azure Stack resource manager
Azure Resource Manager (ARM) to struktura zarządzania, która umożliwia administratorom wdrażanie i monitorowanie zasobów platformy Azure oraz zarządzanie nimi. Usługa Azure Resource Manager może obsługiwać te zadania jako grupę, a nie pojedynczo, w ramach jednej operacji. Informacje o metadanych można uzyskać z punktu końcowego usługi Resource Manager. Punkt końcowy zwraca plik JSON z informacjami wymaganymi do uruchomienia kodu.
Rozważ następujące kwestie:
Element ResourceManagerEndpointUrl w zestawie Azure Stack Development Kit (ASDK) to:
https://management.local.azurestack.external/.ResourceManagerEndpointUrl w systemach zintegrowanych to:
https://management.region.<fqdn>/, gdzie<fqdn>jest w pełni kwalifikowaną nazwą domenową.Aby pobrać wymagane metadane:
<ResourceManagerUrl>/metadata/endpoints?api-version=1.0
Przykładowy kod 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"]
}
}
Przykłady
Zobacz przykładowe repozytorium, aby uzyskać aktualny przykładowy kod. Katalog główny README.md opisuje ogólne wymagania, a każdy podkatalog zawiera konkretny przykład z własnymi README.md instrukcjami uruchamiania tego przykładu.
Zobacz tutaj , aby zapoznać się z przykładową wersją 2008 lub profilem 2019-03-01 usługi Azure Stack i poniżej.
Dalsze kroki
Dowiedz się więcej o profilach interfejsu API: