Menggunakan Profil versi API dengan kit pengembangan perangkat lunak (SDK) Node.js di Azure Stack Hub

Artikel
10/30/2024

Node.js dan profil versi API

Anda dapat menggunakan SDK Node.js untuk membantu membangun dan mengelola infrastruktur untuk aplikasi Anda. Profil API di SDK Node.js membantu solusi cloud hibrid Anda dengan memungkinkan Anda beralih antara sumber daya Azure global dan sumber daya Azure Stack Hub. Anda dapat membuat kode sekali dan kemudian menargetkan Azure global dan Azure Stack Hub.

Pada artikel ini, Anda dapat menggunakan Visual Studio Code sebagai alat pengembangan Anda. Visual Studio Code dapat men-debug SDK Node.js dan memungkinkan Anda menjalankan aplikasi dan mendorong aplikasi ke instans Azure Stack Hub Anda. Anda dapat men-debug dari Visual Studio Code atau melalui jendela terminal yang menjalankan perintah node <nodefile.js>.

SDK Node.js

SDK Node.js menyediakan alat Resource Manager Azure Stack Hub. Penyedia sumber daya di SDK termasuk komputasi, jaringan, penyimpanan, layanan aplikasi, dan KeyVault. Ada 10 pustaka klien penyedia sumber daya yang dapat Anda pasang di aplikasi node.js Anda. Anda juga dapat mengunduh penyedia sumber daya mana yang akan Anda gunakan untuk 2020-09-01-profile untuk mengoptimalkan memori untuk aplikasi Anda. Setiap modul terdiri dari penyedia sumber daya, versi API masing-masing, dan profil API.

Profil API adalah kombinasi dari penyedia sumber daya dan versi API. Anda dapat menggunakan profil API untuk mendapatkan versi terbaru yang paling stabil dari setiap jenis sumber daya dalam paket penyedia sumber daya.

Untuk menggunakan versi terbaru dari semua layanan, gunakan profil paket terbaru.
Untuk menggunakan layanan yang kompatibel dengan Azure Stack Hub, gunakan @azure/arm-resources-profile-hybrid-2020-09-01 atau @azure/arm-storage-profile-2020-09-01-hybrid

Paket NPM

Setiap penyedia sumber daya memiliki paketnya sendiri. Anda bisa mendapatkan paket tersebut dari registri npm.

Anda dapat menemukan paket-paket berikut:

Penyedia sumber daya	Paket
App Service	@azure/arm-resources-profile-2020-09-01-hybrid
Langganan Azure Resource Manager	@azure/arm-subscriptions-profile-hybrid-2020-09-01
Kebijakan Azure Resource Manager	@azure/arm-policy-profile-hybrid-2020-09-01
DNS Azure Resource Manager	@azure/arm-dns-profile-2020-09-01-hybrid
Authorization	@azure/arm-authorization-profile-2020-09-01-hybrid
Compute	@azure/arm-compute-profile-2020-09-01-hybrid
Penyimpanan	@azure/arm-storage-profile-2020-09-01-hybrid
Jaringan	@azure/arm-network-profile-2020-09-01-hybrid
Sumber	@azure/arm-resources-profile-hybrid-2020-09-01
Keyvault	@azure/arm-keyvault-profile-2020-09-01-hybrid

Untuk menggunakan layanan versi API terbaru, gunakan profil Terbaru dari pustaka klien tertentu. Misalnya, jika Anda ingin menggunakan versi API terbaru dari layanan sumber daya saja, gunakan azure-arm-resourceprofil Pustaka Klien Manajemen Sumber Daya. Paket .

Gunakan versi API tertentu yang ditentukan di dalam paket untuk versi API tertentu dari penyedia sumber daya.

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

Profil Terbaru yang dibuat untuk Azure Stack Hub. Gunakan profil ini agar layanannya menjadi paling kompatibel dengan Azure Stack Hub selama Anda menggunakan tanda 1808 atau lebih jauh.
@azure-arm-resource

Profil terdiri dari versi terbaru dari semua layanan. Gunakan versi terbaru pada semua layanan di Azure.

Profil

Untuk menggunakan profil atau versi SDK yang berbeda pada profil yang berisi tanggal, ganti tanggal di @azure/arm-keyvault-profile-<date>-hybrid. Misalnya, untuk versi 2008, profilnya adalah 2019-03-01, dan string menjadi @azure/arm-keyvault-profile-2019-03-01-hybrid. Perhatikan bahwa terkadang tim SDK mengubah nama paket, jadi hanya mengganti tanggal string dengan tanggal yang berbeda mungkin tidak berhasil. Lihat tabel berikut untuk asosiasi profil dan versi Azure Stack.

Versi 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

Untuk informasi selengkapnya tentang Azure Stack Hub serta profil API, lihat Ringkasan profil API.

Memasang SDK Node.js

Pasang Git. Untuk mengetahui petunjuknya, lihat Memulai - Memasang Git.
Pasang atau tingkatkan ke versi Node.jssaat ini. Node.js juga menyertakan manajer paket JavaScript npm.
Pasang atau tingkatkan Visual Studio Code dan pasang ekstensi Node.js untuk Visual Studio Code.
Pasang paket klien untuk Resource Manager Azure Stack Hub. Untuk informasi selengkapnya, lihat cara memasang pustaka klien.
Paket yang perlu dipasang bergantung pada versi profil yang ingin Anda gunakan. Anda dapat menemukan daftar penyedia sumber daya di bagian Paket di npm.

Langganan

Jika Anda belum memiliki langganan, buat langganan dan simpan ID langganan yang akan digunakan nanti. Untuk informasi tentang cara membuat langganan, lihat dokumen ini.

Perwakilan Layanan

Perwakilan layanan dan informasi lingkungan terkait harus dibuat dan disimpan di suatu tempat. Perwakilan layanan dengan peran owner direkomendasikan, tetapi tergantung sampel, peran contributor mungkin sudah cukup. Lihat README di repositori sampel untuk nilai yang diperlukan. Anda dapat membaca nilai-nilai ini dalam format apa pun yang didukung oleh bahasa SDK seperti dari file JSON (yang digunakan dalam sampel kami). Bergantung pada sampel yang dijalankan, tidak semua nilai ini dapat digunakan. Lihat repositori sampel untuk mengetahui kode sampel terbaru atau informasi lebih lanjut.

ID Penyewa

Ikuti petunjuk dalam artikel ini untuk menemukan direktori atau ID penyewa untuk Azure Stack Hub Anda.

Mendaftarkan penyedia sumber daya

Daftarkan penyedia sumber daya yang diperlukan dengan mengikuti dokumen ini. Penyedia sumber daya ini akan diperlukan, tergantung sampel yang ingin Anda jalankan. Misalnya, jika Anda ingin menjalankan sampel mesin virtual, pendaftaran penyedia sumber daya Microsoft.Compute diperlukan.

Titik akhir Azure Stack resource manager

Azure Resource Manager (ARM) adalah kerangka kerja manajemen yang memungkinkan administrator untuk menyebarkan, mengelola, dan memantau sumber daya Azure. Azure Resource Manager dapat menangani tugas-tugas ini sebagai grup, bukan secara individu, dalam satu operasi. Anda bisa mendapatkan info metadata dari titik akhir Resource Manager. Titik akhir mengembalikan file JSON dengan info yang diperlukan untuk menjalankan kode Anda.

Pertimbangkan hal berikut:

ResourceManagerEndpointUrl di Azure Stack Development Kit (ASDK) adalah: https://management.local.azurestack.external/.
ResourceManagerEndpointUrl dalam sistem terintegrasi adalah: https://management.region.<fqdn>/, dengan <fqdn> adalah nama domain Anda yang sepenuhnya memenuhi syarat.
Untuk mengambil metadata yang diperlukan: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0

JSON Sampel:

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

Sampel

Lihat repositori sampel untuk mengetahui kode sampel terbaru. Akar README.md menjelaskan persyaratan umum, dan setiap subdirektori berisi sampel tertentu dengan README.md masing-masing tentang cara menjalankan sampel tersebut.

Lihat di sini untuk mengetahui sampel yang berlaku pada versi 2008 atau profil 2019-03-01 Azure Stack dan di bawah ini.

Langkah berikutnya

Pelajari selengkapnya tentang profil API:

Bagikan melalui