Używanie profilów wersji interfejsu API z zestawem SDK (software development kit) Node.js w usłudze Azure Stack Hub
profile wersji Node.js i interfejsu API
Możesz użyć zestawu SDK Node.js, aby ułatwić 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. Kod można użyć raz, a następnie kierować zarówno globalną platformę Azure, jak i usługę Azure Stack Hub.
W tym artykule możesz użyć Visual Studio Code jako narzędzia programistycznego. Visual Studio Code może debugować zestaw SDK Node.js i umożliwia uruchamianie aplikacji i wypychanie aplikacji do wystąpienia usługi Azure Stack Hub. Możesz debugować z poziomu Visual Studio Code lub za pośrednictwem okna terminalu z uruchomionym poleceniem node <nodefile.js>.
Zestaw SDK Node.js
Zestaw SDK Node.js udostępnia narzędzia Resource Manager usługi Azure Stack Hub. 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ż pobrać, którego dostawcę zasobów użyjesz dla profilu 2020-09-01 , aby zoptymalizować pamięć 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 |
| Usługa Azure Resource Manager DNS | @azure/arm-dns-profile-2020-09-01-hybrid |
| Autoryzacja | @azure/arm-authorization-profile-2020-09-01-hybrid |
| Środowisko obliczeniowe | @azure/arm-compute-profile-2020-09-01-hybrid |
| Storage | @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 |
| 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. Jeśli na przykład chcesz użyć najnowszej wersji usługi zasobów interfejsu API, użyj azure-arm-resource profilu biblioteki klienta zarządzania zasobami.
Użyj określonych wersji interfejsu API zdefiniowanych wewnątrz pakietu dla określonych 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 usługi były najbardziej zgodne z usługą Azure Stack Hub, o ile masz sygnaturę 1808 lub więcej.
@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 użyj 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ę ciągiem @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ć. Zapoznaj się z poniższą tabelą, aby zapoznać się z skojarzeniem 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 usługę 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 Visual Studio Code i zainstaluj rozszerzenieNode.js dla 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 witrynie npm .
Subskrypcja
Jeśli nie masz jeszcze subskrypcji, utwórz subskrypcję i zapisz identyfikator subskrypcji do późniejszego użycia. Aby uzyskać informacje na temat tworzenia subskrypcji, zobacz ten dokument.
Jednostka usługi
Jednostka usługi i skojarzone z nią informacje o środowisku powinny zostać utworzone i zapisane gdzieś. Zalecana jest jednostka usługi z rolą owner , ale w zależności od próbki contributor rola może wystarczyć. 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 przebiegu próbki nie można użyć wszystkich tych wartości. Zobacz przykładowe repozytorium , aby uzyskać zaktualizowany przykładowy kod lub więcej informacji.
Identyfikator dzierżawy
Aby znaleźć katalog lub identyfikator dzierżawy 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ą zobowiązani w zależności od przykładów, które chcesz uruchomić. Jeśli na przykład chcesz uruchomić przykładową maszynę wirtualną, Microsoft.Compute wymagana 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 Resource Manager. Punkt końcowy zwraca plik JSON z informacjami wymaganymi do uruchomienia kodu.
Rozważ następujące źródła:
Element ResourceManagerEndpointUrl w zestawie Azure Stack Development Kit (ASDK) to:
https://management.local.azurestack.external/.Element ResourceManagerEndpointUrl w zintegrowanych systemach to:
https://management.region.<fqdn>/, gdzie<fqdn>jest w pełni kwalifikowaną nazwą domeny.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ć przykładowy kod aktualizacji do daty. Katalog główny README.md opisuje ogólne wymagania, a każdy podkatalog zawiera konkretny przykład z własnym README.md sposobem uruchamiania tego przykładu.
Zobacz tutaj, aby zapoznać się z przykładową wersją lub profilem 2019-03-01 usługi Azure Stack 2008 i poniżej.
Następne kroki
Dowiedz się więcej o profilach interfejsu API: