Mulai cepat: Menyambungkan ke instans Azure Web PubSub dari CLI
Mulai cepat ini menunjukkan kepada Anda cara menyambungkan ke instans Azure Web PubSub dan menerbitkan pesan ke klien yang terhubung menggunakan Azure CLI.
Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.
Prasyarat
Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih suka menjalankan perintah referensi CLI secara lokal, instal Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.
- Mulai cepat ini memerlukan Azure CLI versi 2.22.0 atau yang lebih baru. Jika menggunakan Azure Cloud Shell, versi terbaru sudah terinstal.
Buat grup sumber daya
Grup sumber daya adalah kontainer logis yang disebarkan dan dikelola oleh sumber daya Azure. Gunakan perintah az group create untuk membuat grup sumber daya bernama myResourceGroup
di eastus
lokasi.
az group create --name myResourceGroup --location EastUS
Membuat instans Web PubSub
Jalankan az extension add untuk menginstal atau meningkatkan ekstensi webpubsub ke versi saat ini.
az extension add --upgrade --name webpubsub
Gunakan perintah az webpubsub create Azure CLI untuk membuat Web PubSub di grup sumber daya yang telah Anda buat. Perintah berikut membuat sumber daya Web PubSub Gratis di bawah grup sumber daya myResourceGroup di EastUS:
Penting
Setiap sumber daya Web PubSub harus memiliki nama yang unik. Ganti <your-unique-resource-name> dengan nama Web PubSub Anda dalam contoh berikut.
az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
Keluaran dari perintah ini menunjukkan properti sumber daya yang baru dibuat. Perhatikan dua properti yang tercantum di bawah:
- Nama Sumber Daya: Nama yang Anda berikan untuk parameter
--name
di atas. - hostName: Dalam contoh, nama host adalah
<your-unique-resource-name>.webpubsub.azure.com/
.
Pada titik ini, akun Azure Anda adalah satu-satunya yang berwenang untuk melakukan operasi apa pun di sumber daya baru ini.
Bermain dengan instans
Menyambungkan ke layanan
Gunakan perintah klien Azure CLI az webpubsub untuk memulai koneksi klien WebSocket ke layanan yang dibuat dari langkah sebelumnya, memberikan informasi berikut:
- Nama hub: String 1 hingga 127 karakter. Harus dimulai dengan karakter alfabet
(a-z, A-Z)
dan hanya berisi karakter alfanumerik(0-9, a-z, A-Z)
atau garis bawah(_)
.
Hub adalah satu set logis dari sambungan WebSocket yang tersambung. Periksa Tentang Hub, grup, dan sambungan untuk detail tentang konsep tersebut.
Penting
Ganti <your-unique-resource-name> dengan nama sumber daya Web PubSub Anda yang dibuat dari langkah-langkah sebelumnya.
- Nama hub: myHub1.
- Nama grup sumber daya: myResourceGroup.
- ID pengguna: user1
az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"
Anda dapat melihat bahwa perintah tersebut membuat koneksi WebSocket ke layanan Web PubSub dan Anda menerima pesan JSON yang menunjukkan bahwa sekarang berhasil tersambung, dan ditugaskan dengan yang connectionId
unik:
{"type":"system","event":"connected","userId":"user1","connectionId":"<your_unique_connection_id>"}
Bermain dengan itu dan mencoba bergabung ke grup menggunakan joingroup <group-name>
dan mengirim pesan ke grup sendtogroup <group-name>
menggunakan:
joingroup group1
sendtogroup group1 hello
Menerbitkan pesan dan mengelola klien
Azure CLI juga menyediakan perintah az webpubsub service untuk mengelola sambungan klien.
Buka perintah CLI lain, dan Anda dapat menyiarkan pesan ke klien:
- Nama hub: myHub1.
- Nama grup sumber daya: myResourceGroup.
az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"
Beralih kembali ke perintah CLI sebelumnya dan Anda dapat melihat bahwa klien menerima pesan:
{"type":"message","from":"server","dataType":"text","data":"Hello World"}
Anda juga dapat mencantumkan semua perintah yang tersedia menggunakan --help
opsi dan bermain dengan perintah yang tercantum.
az webpubsub service --help
Langkah berikutnya
Mulai cepat ini memberi Anda gambaran dasar tentang cara tersambung ke layanan Web PubSub dan cara memublikasikan pesan ke klien yang tersambung.
Dalam penerapan dunia nyata, Anda dapat menggunakan SDK dalam berbagai bahasa membangun aplikasi Anda sendiri. Kami juga menyediakan ekstensi Fungsi bagi Anda untuk membangun aplikasi tanpa server dengan mudah.
Gunakan sumber daya ini untuk mulai membangun aplikasi Anda sendiri: