Skip to content

Latest commit

 

History

History
31 lines (24 loc) · 2.89 KB

deploy.md

File metadata and controls

31 lines (24 loc) · 2.89 KB

QuizzR deployment

The following repo is an online quiz platform. It is written using dotnet with Blazor Webassembly on the front end and SignalR on the backend. It uses Azure Entra B2C to authenticate admin users (to allow the creation and running of quizzes).

The project consists of...

  • /QuizExperiment.Admin - The quiz application (split into 2 parts client and server)
  • /Env - Bicep scripts for deploying the resources to Azure to host your own instance
  • /github/workflows - Github Actions from deploying the application (and infrastructure)

Running in your own AD B2C Instance

  1. Fork this repo
  2. Create an Azure AD B2C instance (see this for more info)
  3. Following the instructions for configuring your instance to talk to your B2C tenant (see this for more info), you will only need to configure the client settings in the appsettings.json file)
  4. Create and add Azure credentials to a github secret called AZURE_CREDENTIALS. (see this for more info) The user will need to have permisions to create a new resource group, deploy resources to it and push an application to app service.
  5. Change the prefix assigned to the resource in main.bicep.
  6. Update the QRCodeImageUrl and ClientJoinLink in appsettings.json, this is the url to the client application, to generate the QR code I used https://www.the-qrcode-generator.com/
  7. Change the LOCATION, RESOURCEGROUP, APPNAME environment variables in main.bicep.
  8. Update the ConnectionString property in the Server/appsettings.json with your prefix to reference your SignalR resource that will be deployed.
  9. Commit the changes, this should cause the action to run and deploy everything
  10. Create and present new quizzes using .azurewebsites.net/manage, players can join using .azurewebsites.net

How to run a quiz

  1. Create a quiz using the /manage url.
  2. Once created present it using the the link on the /manage page or the "Save and Present" option in the editor.
  3. Share the presenter screen in the online meeting.
  4. Players join using the root (/)` url.
  5. Once the required number of players have joined, press "Start" on the presenter screen, each question will be presented. The question will end either when the timer expires or all the registered players have answered.
  6. Once all questions have been asked the leaderboard will be shown.