42.scaleout

Scale Out

Bot Framework v4 bot Scale Out sample

This bot has been created using Bot Framework, is shows how to use a custom storage solution that supports a deployment scaled out across multiple machines.

The custom storage solution is implemented against memory for testing purposes and against Azure Blob Storage. The sample shows how storage solutions with different policies can be implemented and integrated with the framework. The solution makes use of the standard HTTP ETag/If-Match mechanisms commonly found on cloud storage technologies.

Prerequisites

• .NET SDK version 6.0

  # determine dotnet version
  dotnet --version

• Update appsettings.json with required configuration settings

  • MicrosoftAppId
  • MicrosoftAppPassword
  • ConnectionName

To try this sample

• Clone the repository

  git clone https://github.com/microsoft/botbuilder-samples.git

• Run the bot from a terminal or from Visual Studio:

  A) From a terminal, navigate to samples/csharp_dotnetcore/42.scaleout

  # run the bot
  dotnet run

  B) Or from Visual Studio

  • Launch Visual Studio
  • File -> Open -> Project/Solution
  • Navigate to samples/csharp_dotnetcore/42.scaleout folder
  • Select ScaleoutBot.csproj file
  • Press F5 to run the project

Testing the bot using Bot Framework Emulator

Microsoft Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots on localhost or running remotely through a tunnel.

• Install the latest Bot Framework Emulator from here

Connect to the bot using Bot Framework Emulator

• Launch Bot Framework Emulator
• File -> Open Bot
• Enter a Bot URL of http://localhost:3978/api/messages

Further reading

• Bot Framework Documentation
• Bot Basics
• Implementing custom storage for you bot
• Bot Storage
• HTTP ETag
• Activity processing
• Azure Bot Service Introduction
• Azure Bot Service Documentation
• .NET Core CLI tools
• Azure CLI
• Azure Portal
• Channels and Bot Connector Service