Dela via

Översikt över Azure Service Bus-emulatorn

Azure Service Bus-emulatorn erbjuder en lokal utvecklingsupplevelse för Service Bus-tjänsten. Du kan använda emulatorn för att utveckla och testa kod mot tjänsten isolerat, utan molninterferens.

Förmåner

De främsta fördelarna med att använda emulatorn är:

  • Lokal utveckling: Emulatorn ger en lokal utvecklingsupplevelse, så att du kan arbeta offline och undvika nätverksfördröjning.
  • Kostnadseffektivitet: Med emulatorn kan du testa dina program utan att medföra några kostnader för molnanvändning.
  • Isolerad testmiljö: Du kan testa koden isolerat för att säkerställa att andra aktiviteter i molnet inte påverkar testerna.
  • Optimerad inre utvecklingsloop: Du kan använda emulatorn för att snabbt prototypera och testa dina program innan du distribuerar dem till molnet.

Anteckning

Service Bus-emulatorn är tillgänglig enligt licensvillkoren för Programvara från Microsoft.

Service Bus-emulatorn är inte kompatibel med den communityägda öppen källkod Service Bus Explorer

Funktioner

Emulatorn innehåller följande funktioner:

  • Containerbaserad distribution: Den körs som en Docker-container (Linux-baserad).
  • Plattformsoberoende kompatibilitet: Du kan använda den på valfri plattform, inklusive Windows, macOS och Linux.
  • Konfigurerbarhet: Du kan hantera antalet Service Bus-entiteter med hjälp av den JSON-angivna konfigurationen.
  • Stöd för direktuppspelning: Det stöder strömmande meddelanden med hjälp av Advanced Message Queuing Protocol (AMQP).
  • Observability: Det tillhandahåller observerbarhetsfunktioner, inklusive loggning till konsol och fil.

Kända begränsningar

Den aktuella versionen av emulatorn har följande begränsningar:

  • Det går inte att strömma meddelanden med hjälp av JMS-protokollet.
  • Partitionerade entiteter är inte kompatibla med emulatorn.
  • Det stöder inte direkt hanteringsåtgärder via en SDK på klientsidan.
  • AMQP Web Sockets stöds inte. AMQP TCP är den enda transporttypen som stöds.

Anteckning

Efter en omstart av en container sparas inte data och entiteter i emulatorn.

Skillnader från molntjänsten

Eftersom Service Bus-emulatorn endast är avsedd för utveckling och test finns det funktionella skillnader mellan emulatorn och molntjänsten.

Emulatorn stöder inte dessa funktioner på hög nivå:

  • Azure-funktioner som integrering av virtuella nätverk, Integrering av Microsoft Entra-ID, aktivitetsloggar och en användargränssnittsportal
  • Autoskalningsfunktioner
  • Funktioner för geokatastrofåterställningsförmåga
  • Stöd för stora meddelanden
  • Visuella mått och aviseringar

Anteckning

Emulatorn är avsedd för utvecklings- och testscenarier, särskilt för användningsfall för sekventiell testning. Service Bus-emulatorn ska inte användas för produktionsarbetsbelastningar eftersom den inte erbjuder något serviceavtal.

Vi tillhandahåller inget officiellt stöd för emulatorn. Rapportera eventuella problem eller förslag på emulatorns GitHub-installationsplats.

Användningskvoter

Precis som Service Bus-molntjänsten tillhandahåller emulatorn följande kvoter för användning:

Fastighet / Egenskap (depending on context) Högsta värde Användaren kan konfigureras inom gränser
Antal namnområden som stöds 1 Nej
Antal entiteter (köer/ämnen) i ett namnområde 50 Ja
Antal prenumerationer per ämne 50 Ja
Antal korrelationsfilter per ämne 1 000 Ja
Antal SQL-filter 20 Ja
Längd på filtervillkor eller regelåtgärdssträng 1024 Ja
Antal uttryck per regelåtgärd 32 Ja
Antal samtidiga anslutningar till namnområdet 10 Ja
Antal samtidiga mottagningsbegäranden på entitet (kö/ämne) eller prenumerationsentitet 200 Ja
Meddelandestorlek 256 kB Nej
Kö- eller ämnesstorlek 100 MB Nej
Meddelandelivslängd 1 timme Ja

Ändringar i kvotkonfigurationen

Som standard körs emulatorn med konfigurationsfilen config.json . Du kan konfigurera de kvoter som är associerade med Service Bus genom att redigera den här filen på följande sätt, baserat på dina behov:

  • Entiteter: Du kan lägga till fler Service Bus-entiteter i enlighet med de kvoter som stöds.
  • Loggning: Emulatorn stöder loggning på en konsol, i en fil eller både och. Du kan välja enligt dina personliga önskemål.

Viktigt!

Du måste ange ändringar i JSON-konfigurationen innan du kör emulatorn. Ändringar verkställs inte omedelbart. För att ändringarna ska börja gälla måste du starta om containern.

Du kan inte byta namn på det förinställda namnområdet (name) i konfigurationsfilen.

Loggar för felsökning

Under testning hjälper konsol- eller filloggar dig att felsöka oväntade fel. Så här granskar du loggarna:

  • Konsolloggar: I Användargränssnittet för Docker-skrivbordet väljer du containernamnet.
  • Filloggar: Gå till /home/app/EmulatorLogs i containern.

Relaterat innehåll

Testa lokalt med hjälp av Azure Service Bus-emulatorn