Menggunakan Profil versi API dengan kit pengembangan perangkat lunak (SDK) Node.js di Azure Stack Hub
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:
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk