Visit Subaccount

Presents links to subaccount which owns the current course

Development Setup

TLS is enabled by the mkcert vite plugin which can be disabled through vite.config.js

Hosting

The tool does not have a back-end, it is a JavaScript Vite application. The easiest way to host is to use Cloudflare Pages & link to Github repository on the Cloudflare Pages 'Settings' pages. The following build options also need setting

• Build command: npm run build
• Build output: build
• Root directory:
• Build comments: Enabled

Installing the tool

Configuring the tool can be done with @oxctl/lti-auto-configuration.

Enter configuration

First set the required values.

npx @oxctl/lti-auto-configuration setup

Create the tool

npx @oxctl/lti-auto-configuration create

Development

The deploy to development is done automatically when a new commit is made to master.

Deployment Tests

There is a simple deployment test that is run when the tool is deployed to Beta or Production - we check that the page loads and has the expected title. This test relies on the repository having access to the organizational GitHub Actions Secret DEPLOYMENT_TESTS_OAUTH_TOKEN. Access must be granted on a repository-by-repository basis.

These variables need to be set as GitHub Actions environment variables in your repository's configuration:

• CANVAS_HOST
• DEPLOYMENT_TEST_PATH

Releasing

To release the latest code merge the master branch into the release branch Cloudflare will then deploy this to production. The best way to do this is to create a PR from master to release, this allows you to check what's going to be released. There is a GitHub action that can be manually run to do this.

Alternatively to do this locally run checkout the release branch, fetch the latest code from the origin and run:

git merge origin/master

To see what is about to go into a release you can preview the changes between master and release, then to double check a PR can be created to merge the changes, reviewed and merged (at which point the release branch is built and deployed).

Sentry

Application errors are reported using https://sentry.io for this application. There is DSN to be used for development and production and should be set up by hand as a Cloudflare (or equivalent) environment variable VITE_SENTRY_DSN.

There's no DSN for local development.

Sentry is setup as early as possible in the application to capture as many errors as possible.