Skip to content
This repository has been archived by the owner on May 16, 2023. It is now read-only.

Files

Latest commit

Oct 28, 2022
affc811 · Oct 28, 2022

History

History
116 lines (83 loc) · 4.54 KB

DEPLOYMENT_GUIDE.md

File metadata and controls

116 lines (83 loc) · 4.54 KB

Microsoft Learn LTI Tool Deployment Instructions

Table of Contents

  1. Clone the repo: link
  2. Deploy to Azure Subscription using the script: link
  3. Configure the tool: link

Prerequisites

To begin, you will need:

Note: Please ensure you reboot your machine after the installation of the Prerequisities

Follow these steps to deploy the Microsoft Learn LTI tool:

Clone the repo

  1. Go to the repo Click code button on the repo Clone Repo
  2. Simply click the code button and select Open with GitHub Desktop or Download Zip to clone contents of the repo.

If you are using Git

  1. Open a command prompt
  2. Make a new directory Learn-Lti
  3. Move to Learn-Lti directory
  4. Use Git to clone the repo (You need Git installed
  5. Enter in the command in the Git console
    • git clone https://github.com/microsoft/Learn-LTI.git
    • This will clone the repo into the current directory Learn-Lti

You have now cloned the repo

After Cloning

  • In the cloned repo, inside the deployment directory Learn-Lti, execute the file run.bat.
  • run.bat bypasses signing requirements and runs Deploy.ps1 automatically.
  • You should now see the Microsoft Learn LTI Tool script popup. run.start.png

Deploy to Azure Subscription using the script

Login to Azure

The script will ask you to login to Azure by navigating to the Azure Login Page on your browser.

Choose Subscription

Type in the name of the Azure subscription that you hold (this is a prerequisite necessary for deployment).

If you're unsure about whether your account has a subscription, check here.

Choose Location

The following regions are supported:

  • eastasia
  • southeastasia
  • centralus
  • eastus
  • eastus2
  • westus
  • southcentralus
  • northeurope
  • westeurope
  • japaneast
  • brazilsouth
  • australiaeast
  • canadacentral
  • uksouth
  • westcentralus
  • westus2
  • koreacentral

Locate your region from the list above. Then type it into the script and hit "Enter".

Deployment.1

Your region determines three things:

  • Compliance and Data Residency
  • Service Availability
  • Pricing

For information regarding your region, check here.

Azure Autoconfigure

The Deploy.ps1 script will automatically provision and configure the required resources for you.

⚠️ Tool Registration URL

The Script will display the Tool Registration URL after completion. Please copy the URL and keep it handy since it will be required while configuring the tool in the LMS.

Deployment.4

Open the tool registration page from your browser and take note of the following parameters.

  • Login URL
  • Launch URL
  • Domain URL
  • Public Key
  • Public JWK
  • Public JWK Set URL

Deployment.5

Congratulations! Your instance of the tool should now be deployed on Azure!

If your deployment failed, click here for help.

Once the tool has been successfully deployed, the next step is to configure the tool on your institution's LMS.