DEPLOYMENT_GUIDE.md

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:

• Azure CLI readme about Azure CLI
  • We currently recommend using Microsoft Azure CLI version 2.27.0
  • To download the MSI installer for specific version, change the version segment in URL https://azcliprod.blob.core.windows.net/msi/**version**.msi and download it. Available versions can be found at Azure CLI release notes.
• DotNet Core SDK .NET Core 3.1
• Node.js
• Powershell
• Git
• An Azure subscription

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
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.

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".

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.

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

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.