Rychlý start: Připojení k instanci Azure Web PubSub z rozhraní příkazového řádku
V tomto rychlém startu se dozvíte, jak se připojit k instanci Azure Web PubSub a publikovat zprávy připojeným klientům pomocí Azure CLI.
Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet Azure před tím, než začnete.
Požadavky
Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Rychlý start pro Bash v Azure Cloud Shellu.
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.
Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.
Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
- Tento rychlý start vyžaduje verzi 2.22.0 nebo vyšší v Azure CLI. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.
Vytvoření skupiny zdrojů
Skupina prostředků je logický kontejner, ve kterém se nasazují a spravují prostředky Azure. Pomocí příkazu az group create vytvořte skupinu prostředků s názvem myResourceGroup v eastus umístění.
az group create --name myResourceGroup --location EastUS
Vytvoření instance Web PubSub
Spuštěním příkazu az extension add nainstalujte nebo upgradujte rozšíření webpubsub na aktuální verzi.
az extension add --upgrade --name webpubsub
Pomocí příkazu az webpubsub az webpubsub vytvořte web pubSub ve skupině prostředků, kterou jste vytvořili. Následující příkaz vytvoří prostředek Free Web PubSub ve skupině prostředků myResourceGroup v eastUS:
Důležité
Každý prostředek Web PubSub musí mít jedinečný název. V následujících příkladech nahraďte <název_prostředku-unique-resource názvem> podsítě Web PubSub.
az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
Výstup tohoto příkazu zobrazuje vlastnosti nově vytvořeného prostředku. Poznamenejte si hodnoty dvou vlastností uvedených níže:
- Název prostředku: Název, který jste zadali výše uvedenému parametru
--name. - hostName: V příkladu je
<your-unique-resource-name>.webpubsub.azure.com/název hostitele .
V tuto chvíli je váš účet Azure jediným autorizovaným k provádění jakýchkoli operací s tímto novým prostředkem.
Hrát s instancí
Připojení ke službě
Pomocí příkazu azure CLI az webpubsub client spusťte připojení klienta WebSocket ke službě vytvořené v předchozím kroku a zadejte následující informace:
- Název centra: Řetězec 1 až 127 znaků. Měl by začínat abecedním znakem
(a-z, A-Z)a obsahovat pouze alfanumerické(0-9, a-z, A-Z)znaky nebo podtržítko(_).
Centrum je logická sada připojených připojení WebSocket. Podrobnosti o konceptech najdete v tématu o centrech, skupinách a připojeních .
Důležité
Nahraďte <název-jedinečný-prostředek> názvem prostředku Web PubSub vytvořeným z předchozích kroků.
- Název centra: myHub1.
- Název skupiny prostředků: myResourceGroup.
- ID uživatele: user1
az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"
Můžete vidět, že příkaz vytvořil připojení WebSocket ke službě Web PubSub a obdrželi jste zprávu JSON, která indikuje, že je nyní úspěšně připojena, a je přiřazena jedinečným connectionId:
{"type":"system","event":"connected","userId":"user1","connectionId":"<your_unique_connection_id>"}
Hrajte s ním a zkuste se připojit ke skupinám pomocí joingroup <group-name> a odesílat zprávy do skupin pomocí sendtogroup <group-name>:
joingroup group1
sendtogroup group1 hello
Publikování zpráv a správa klientů
Azure CLI také poskytuje příkazy služby az webpubsub pro správu připojení klientů.
Otevřete další příkaz rozhraní příkazového řádku a můžete vysílat zprávy klientům:
- Název centra: myHub1.
- Název skupiny prostředků: myResourceGroup.
az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"
Přepněte zpět na předchozí příkaz rozhraní příkazového řádku a uvidíte, že klient obdržel zprávu:
{"type":"message","from":"server","dataType":"text","data":"Hello World"}
Můžete také zobrazit seznam všech dostupných příkazů pomocí --help možnosti a přehrát si s uvedenými příkazy.
az webpubsub service --help
Další kroky
V tomto rychlém startu získáte základní představu o tom, jak se připojit ke službě Web PubSub a jak publikovat zprávy do připojených klientů.
V reálných aplikacích můžete používat sady SDK v různých jazycích a vytvářet vlastní aplikace. Poskytujeme také rozšíření funkcí, která vám umožní snadno vytvářet bezserverové aplikace.
Pomocí těchto prostředků můžete začít vytvářet vlastní aplikaci: