Opencast Admin UI

The Opencast Admin UI is a graphical interface included by Opencast to give admins an easy way of managing their Opencast instance.

Quickstart

Commands to hack into your console to get to testing pull requests ASAP:

git clone [email protected]:opencast/opencast-admin-interface.git opencast-admin-interface-demo
cd opencast-admin-interface-demo
npm ci
cd app
npm ci
cd ..
npm run proxy-server http://stable.opencast.org opencast_system_account CHANGE_ME

Open a second tab:

npm run client

Open a third tab to checkout the pull request you want to test. You need to know the pull request number!:

git fetch origin pull/{PULL REQUEST NUMBER HERE}/head:some-branch-name-of-your-choosing
git checkout some-branch-name-of-your-choosing

Development

Before starting, get the project dependencies by running npm ci beforehand both in the root and /app directory.

To test with real data run:

npm run proxy-server http://stable.opencast.org *opencast_digest_username* *opencast_digest_password*

This will start a proxy server at localhost:5000. It will automatically proxy requests to a Opencast instance at http://stable.opencast.org. You can change the url to at a different Opencast if you wish (e.g. http://localhost.8080 for a local Opencast installation). Note that http is required.

You can then start the client in a different tab by running:

npm run client

This will start a client server in the development mode. Open http://localhost:3000 to view it in the browser.

---

Alternatively you can spin up a mock instance of the admin ui with:

npm start

This uses mock data instead of a real Opencast. This means certain features will not work when using this mode.

How to cut a release for Opencast

1. [NOT YET FUNCTIONAL] (Optional) Run the Update translations workflow, to make sure all changes from crowdin are included in the next release.
2. Switch to the commit you want to turn into the release
3. Create and push a new tag

    DATE=$(date +%Y-%m-%d)
    git tag -m Release -s "$DATE"
    git push upstream "$DATE":"$DATE"

4. Wait for the Create release draft workflow to finish
   • It will create a new GitHub release draft
   • Review and publish the draft
5. Submit a pull request against Opencast
   • Update the release
   • Adjust the documentation if necessary
   • Verify that the new release runs in Opencast, then create the pull request.

Opencast API used by the Admin UI

The Admin UI accesses all endpoints in Opencast located under

• /admin-ng/*

If you want to use current version of the frontend with an earlier Opencast version, you will have to cherry pick the relevant commits from the Opencast repository yourself.

Translating the Admin UI

TBA

Configuration

The Admin UI frontend cannot be directly configured. Rather, it adapts to the various configurations in the Opencast backend. TODO: Throw in some links to the docs, which ones?