Migrera en lokalt installerad Socket.IO app som ska hanteras fullständigt i Azure

I den här artikeln migrerar du en Socket.IO chattapp till Azure med hjälp av Web PubSub för Socket.IO.

Förutsättningar

Skapa en Web PubSub för Socket.IO resurs

1. Gå till Azure-portalen.

2. Sök efter socket.io och välj sedan Web PubSub för Socket.IO.

3. Välj en plan och välj sedan Skapa.

   

Migrera appen

För migreringsprocessen i den här guiden använder du en exempelchattapp som finns på Socket.IO:s webbplats. Du måste göra några mindre ändringar i både koden på serversidan och på klientsidan för att slutföra migreringen.

Serversidan

1. Leta upp index.js i koden på serversidan.

2. @azure/web-pubsub-socket.io Lägg till paketet:

   npm install @azure/web-pubsub-socket.io
   

3. Importera paketet:

   const { useAzureSocketIO } = require("@azure/web-pubsub-socket.io");
   

4. Leta upp koden på serversidan där du skapade Socket.IO-servern och lägg till användAzureSocketIO(...):

   Råa anslutningssträng visas endast i den här artikeln i demonstrationssyfte. Skydda alltid dina åtkomstnycklar i produktionsmiljöer. Använd Azure Key Vault för att hantera och rotera dina nycklar på ett säkert sätt och skydda anslutningen med WebPubSubServiceClient.

   const io = require("socket.io")();
   useAzureSocketIO(io, {
       hub: "eio_hub", // The hub name can be any valid string.
       connectionString: process.argv[2]
   });
   

   Viktigt!

   Metoden useAzureSocketIO är asynkron och utför initieringssteg för att ansluta till Web PubSub. Du kan använda await useAzureSocketIO(...) eller använda useAzureSocketIO(...).then(...) för att se till att appservern börjar hantera begäranden när initieringen har slutförts.

5. Om du använder följande server-API:er lägger du till async innan du använder dem eftersom de är asynkrona med Web PubSub för Socket.IO:

   • server.socketsJoin
   • server.socketsLeave
   • socket.join
   • socket.leave

   Om det till exempel finns kod som den här:

   io.on("connection", (socket) => { socket.join("room abc"); });
   

   Uppdatera den till:

   io.on("connection", async (socket) => { await socket.join("room abc"); });
   

   Det här chattexemplet använder inte någon av dessa API:er. Så du behöver inte göra några ändringar.

Kundsidan

1. Hitta slutpunkten till resursen på Azure Portal.

   

2. Gå till ./public/main.js i koden på klientsidan.

3. Hitta var Socket.IO-klienten skapas. Ersätt dess slutpunkt med Socket.IO-slutpunkten i Azure och lägg till alternativet path:

   const socket = io("<web-pubsub-for-socketio-endpoint>", {
       path: "/clients/socketio/hubs/eio_hub",
   });