Guida introduttiva: Connessione all'istanza di PubSub Web di Azure dall'interfaccia della riga di comando
Questa guida introduttiva illustra come connettersi all'istanza di PubSub Web di Azure e pubblicare messaggi ai client connessi usando l'interfaccia della riga di comando di Azure.
Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
Prerequisiti
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere con l'interfaccia della riga di comando di Azure.
Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
- Questa guida introduttiva richiede la versione 2.22.0 o successiva dell'interfaccia della riga di comando di Azure. Se si usa Azure Cloud Shell, la versione più recente è già installata.
Creare un gruppo di risorse
Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite le risorse di Azure. Usare il comando az group create per creare un gruppo di risorse denominato myResourceGroup nel eastus percorso.
az group create --name myResourceGroup --location EastUS
Creare un'istanza di Web PubSub
Eseguire az extension add per installare o aggiornare l'estensione webpubsub alla versione corrente.
az extension add --upgrade --name webpubsub
Usare il comando az webpubsub create dell'interfaccia della riga di comando di Azure per creare un Web PubSub nel gruppo di risorse creato. Il comando seguente crea una risorsa Web PubSub gratuita nel gruppo di risorse myResourceGroup in EastUS:
Importante
Ogni risorsa Web PubSub deve avere un nome univoco. Sostituire <your-unique-resource-name> con il nome di Web PubSub negli esempi seguenti.
az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1
L'output di questo comando mostra le proprietà della risorsa appena creata. Prendere nota delle due proprietà elencate di seguito:
- Nome risorsa: nome specificato al
--nameparametro precedente. - hostName: nell'esempio il nome host è
<your-unique-resource-name>.webpubsub.azure.com/.
A questo punto, l'account Azure è l'unico autorizzato a eseguire qualsiasi operazione su questa nuova risorsa.
Riprodurre con l'istanza
Connettersi al servizio
Usare il comando az webpubsub client dell'interfaccia della riga di comando di Azure per avviare una connessione client WebSocket al servizio creato nel passaggio precedente, fornendo le informazioni seguenti:
- Nome hub: stringa da 1 a 127 caratteri. Deve iniziare con caratteri
(a-z, A-Z)alfabetici e contenere solo caratteri alfanumerici(0-9, a-z, A-Z)o caratteri di sottolineatura(_).
Hub è un set logico delle connessioni WebSocket connesse. Per informazioni dettagliate sui concetti, vedere Informazioni su Hub, gruppi e connessioni .
Importante
Sostituire <your-unique-resource-name> con il nome della risorsa Web PubSub creata nei passaggi precedenti.
- Nome hub: myHub1.
- Nome del gruppo di risorse: myResourceGroup.
- ID utente: user1
az webpubsub client start --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --user-id "user1"
È possibile notare che il comando ha stabilito una connessione WebSocket al servizio Web PubSub e che è stato ricevuto un messaggio JSON che indica che è ora connesso correttamente e che viene assegnato con un oggetto univoco connectionId:
{"type":"system","event":"connected","userId":"user1","connectionId":"<your_unique_connection_id>"}
Provare a partecipare ai gruppi usando joingroup <group-name> e inviare messaggi ai gruppi usando sendtogroup <group-name>:
joingroup group1
sendtogroup group1 hello
Pubblicare messaggi e gestire i client
L'interfaccia della riga di comando di Azure fornisce anche i comandi az webpubsub service per gestire le connessioni client.
Aprire un altro comando dell'interfaccia della riga di comando ed è possibile trasmettere messaggi ai client:
- Nome hub: myHub1.
- Nome del gruppo di risorse: myResourceGroup.
az webpubsub service broadcast --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --hub-name "myHub1" --payload "Hello World"
Tornare al comando dell'interfaccia della riga di comando precedente ed è possibile vedere che il client ha ricevuto il messaggio:
{"type":"message","from":"server","dataType":"text","data":"Hello World"}
È anche possibile elencare tutti i comandi disponibili usando --help l'opzione e riprodurre con i comandi elencati.
az webpubsub service --help
Passaggi successivi
Questa guida introduttiva offre un'idea di base su come connettersi al servizio Web PubSub e su come pubblicare messaggi nei client connessi.
Nelle applicazioni reali è possibile usare gli SDK in diversi linguaggi per creare un'applicazione personalizzata. Sono inoltre disponibili estensioni per le funzioni per creare facilmente applicazioni serverless.
Usare queste risorse per iniziare a creare un'applicazione personalizzata: