Perpustakaan klien Azure Template untuk JavaScript - versi 1.0.0-beta.3

Proyek ini digunakan sebagai paket templat untuk Azure SDK untuk JavaScript. Ini dimaksudkan untuk membantu pengembang Azure SDK bootstrap paket baru, dan memberikan contoh cara mengatur kode dan dokumentasi pustaka klien untuk layanan Azure.

Memulai Langkah Pertama

Lingkungan yang didukung saat ini

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prasyarat

  • Sebuah langganan Azure.

Biasanya Anda akan menempatkan perintah shell untuk menyediakan layanan Azure yang diperlukan di sini.

Pasang paket @azure/template

Instal pustaka klien Template untuk JavaScript dengan npm:

npm install @azure/template

Dukungan peramban

Bundel JavaScript

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukan ini, silakan lihat dokumentasi bundling kami.

CORS

Anda perlu menyiapkan aturan Berbagi Sumber Daya Lintas Asal (CORS) untuk akun penyimpanan Anda jika Anda perlu mengembangkan untuk browser. Buka portal Microsoft Azure dan Azure Storage Explorer, temukan akun penyimpanan Anda, buat aturan CORS baru untuk layanan blob/antrean/file/tabel.

Misalnya, Anda dapat membuat pengaturan CORS berikut untuk penelusuran kesalahan. Tetapi harap sesuaikan pengaturan dengan hati-hati sesuai dengan kebutuhan Anda di lingkungan produksi.

  • Asal yang diizinkan: *
  • Kata kerja yang diizinkan: HAPUS,DAPATKAN,KEPALA,GABUNGKAN,POSTING,OPSI,LETAKKAN
  • Header yang diizinkan: *
  • Header yang terbuka: *
  • Usia maksimum (detik): 86400

Contoh lebih lanjut

Contoh tingkat atas biasanya mencakup hal-hal seperti membuat dan mengautentikasi Klien utama. Jika layanan Anda mendukung beberapa cara autentikasi (berbasis e.g. key dan Azure Active Directory), Anda dapat memberikan contoh terpisah dari masing-masing.

Konsep Utama

ConfigurationClient

Jelaskan klien utama Anda di sini. Bicarakan tentang operasi apa yang dapat dilakukannya dan kapan pengembang ingin menggunakannya.

Contoh tambahan

Buat bagian untuk setiap konsep layanan tingkat atas yang ingin Anda jelaskan.

Examples

Contoh Pertama

Buat beberapa contoh kode tentang bagaimana seseorang akan menggunakan pustaka Anda untuk menyelesaikan tugas umum dengan layanan.

Troubleshooting

Pengelogan

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Untuk instruksi lebih rinci tentang cara mengaktifkan log, Anda dapat melihat dokumen paket @azure/logger.

Langkah berikutnya

Silakan lihat direktori samples untuk contoh terperinci yang menunjukkan cara menggunakan pustaka klien.

Contributing

Jika Anda ingin berkontribusi ke library ini, silakan baca panduan contributor untuk mempelajari lebih lanjut cara membuat dan menguji kode.