Hızlı Başlangıç: CLI'dan Azure Web PubSub örneğine Bağlan

Bu hızlı başlangıçta Azure Web PubSub örneğine bağlanma ve Azure CLI kullanarak bağlı istemcilere ileti yayımlama adımları gösterilmektedir.

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Ön koşullar

• Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  

• CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

  • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

  • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

  • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

• Bu hızlı başlangıç için Azure CLI'nın 2.22.0 veya üzeri bir sürümü gerekir. Azure Cloud Shell kullanılıyorsa en son sürüm zaten yüklüdür.

Kaynak grubu oluşturma

Kaynak grubu, Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. konumunda adlı myResourceGroup eastus bir kaynak grubu oluşturmak için az group create komutunu kullanın.

az group create --name myResourceGroup --location EastUS

Web PubSub örneği oluşturma

Webpubsub uzantısını yüklemek veya geçerli sürüme yükseltmek için az extension add komutunu çalıştırın.

az extension add --upgrade --name webpubsub

Oluşturduğunuz kaynak grubunda bir Web PubSub oluşturmak için Azure CLI az webpubsub create komutunu kullanın. Aşağıdaki komut, EastUS'ta myResourceGroup kaynak grubu altında bir Ücretsiz Web PubSub kaynağı oluşturur:

az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1

Bu komutun çıktısı yeni oluşturulan kaynağın özelliklerini gösterir. Aşağıda listelenen iki özelliği not edin:

• Kaynak Adı: Yukarıdaki parametreye --name sağladığınız ad.
• hostName: Örnekte ana bilgisayar adı şeklindedir <your-unique-resource-name>.webpubsub.azure.com/.

Bu noktada, azure hesabınız bu yeni kaynak üzerinde herhangi bir işlem gerçekleştirme yetkisi olan tek hesaptır.

Örnekle oynama

Hizmete Bağlan

Azure CLI az webpubsub client komutunu kullanarak önceki adımdan oluşturulan hizmete bir WebSocket istemci bağlantısı başlatın ve aşağıdaki bilgileri sağlayın:

• Hub adı: 1 ile 127 karakter arası bir dize. Alfabetik karakterlerle (a-z, A-Z) başlamalıdır ve yalnızca alfasayısal (0-9, a-z, A-Z) karakterler veya alt çizgi (_)içermelidir.

Hub , bağlı WebSocket bağlantılarının mantıksal kümesidir. Kavramlar hakkında ayrıntılı bilgi için Hub'lar, gruplar ve bağlantılar hakkında'ya bakın.

• Hub adı: myHub1.
• Kaynak grubu adı: myResourceGroup.
• Kullanıcı Kimliği: kullanıcı1

az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"

Komutun Web PubSub hizmetine bir WebSocket bağlantısı kurduğunu ve şimdi başarıyla bağlandığını ve benzersiz connectionIdbir ile atandığını belirten bir JSON iletisi aldığınızı görebilirsiniz:

{"type":"system","event":"connected","userId":"user1","connectionId":"<your_unique_connection_id>"}

Bununla oynayın ve kullanarak joingroup <group-name> gruplara katılmayı ve kullanarak sendtogroup <group-name>gruplara ileti göndermeyi deneyin:

joingroup group1

sendtogroup group1 hello

İletileri yayımlama ve istemcileri yönetme

Azure CLI, istemci bağlantılarını yönetmek için az webpubsub hizmet komutları da sağlar.

Başka bir CLI komutu açtığınızda, iletileri istemcilere yayınlayabilirsiniz:

• Hub adı: myHub1.
• Kaynak grubu adı: myResourceGroup.

az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"

Önceki CLI komutuna geri döndüğünüzde istemcinin şu iletiyi aldığını görebilirsiniz:

{"type":"message","from":"server","dataType":"text","data":"Hello World"}

Ayrıca seçeneği kullanarak --help tüm kullanılabilir komutları listeleyebilir ve listelenen komutlarla yürütebilirsiniz.

az webpubsub service --help

Sonraki adımlar

Bu hızlı başlangıçta, Web PubSub hizmetine bağlanma ve bağlı istemcilere ileti yayımlama hakkında temel bir fikir sağlanır.

Gerçek dünyadaki uygulamalarda SDK'ları farklı dillerde kullanabilir ve kendi uygulamanızı oluşturabilirsiniz. Ayrıca sunucusuz uygulamaları kolayca derlemeniz için İşlev uzantıları da sağlıyoruz.

Kendi uygulamanızı oluşturmaya başlamak için şu kaynakları kullanın: