Public | Automated Build

Last pushed: 11 days ago
Short Description
Opencast image for the ingest distribution
Full Description

Opencast Docker images

Introduction

This repository holds Dockerfiles for creating Opencast Docker images.

Installation

All images are available on Docker Hub. To install the image simply pull the distribution you want:

$ docker pull "opencast/<distribution>"

To install a specific version, use the following command:

$ docker pull "opencast/<distribution>:<version>"

Build

If you want to build the images yourself, there is a Makefile with the necessary docker build commands for all distributions. Running make in the root directory will create these images. To customize the build you can override these variables:

  • DOCKER_IMAGE_BASE<br>
    The fist part of the image name. It defaults to opencast and will be extended by the name of the Opencast distribution.
  • DOCKER_TAG<br>
    The tag of the image. Defaults to the content of VERSION.
  • REPO<br>
    The git repository to clone Opencast from. The default is the upstream repository, but you can use your own fork.
  • BRANCH<br>
    The name of the git branch to check out. Defaults to the value of DOCKER_TAG.
  • CUSTOM_DOCKER_BUILD_ARGS<br>
    Custom arguments that should be passed to docker build, e.g. you can set this to --no-cache to force an image build. By default empty.

Quick Start

A quick local test system can be started using docker-compose. After cloning this repository you can run this command from the root directory:

$ export HOSTIP=<IP address of the Docker host>
$ docker-compose -p opencast-allinone -f docker-compose/docker-compose.allinone.h2.yml up

This will run Opencast using the allinone distribution configured to use the bundled H2 Database Engine.

In the ./docker-compose directory there are also compose files for more production-like setups. docker-compose.allinone.mariadb.yml uses a MySQL database instead of H2, while docker-compose.multiserver.mariadb.yml demonstrates how to connect the different distributions. Replace the compose file in the command above if you want to use them instead. You can find more information about the compose files here.

Images

Opencast comes in different distributions. For each of the official distributions there is a specific Docker image. Each version is tagged. For example the full image name containing the admin distribution at version 2.3.4 is opencast/admin:2.3.4. Leaving the version out will install the latest one.

allinone

This image contains all Opencast modules necessary to run a full Opencast installation. It's useful for small and local test setups. If you however want to run Opencast in a distributed fashion, you probably should use a combination of admin, worker and presentation containers.

admin, worker, adminpresentation, adminworker, ingest and presentation

These images contain the Opencast modules of the corresponding Opencast distributions.

build

This images helps you set up a development environment for Opencast. For more information see here.

Usage

The images come with multiple commands. You can see a full list with description by running:

$ docker run --rm opencast/<distribution> app:help
Usage:
  app:help                Prints the usage information
  app:print:ddl           Prints SQL commands to set up the database
  app:print:activemq.xml  Prints the configuration for ActiveMQ
  app:init                Checks and configures Opencast but does not run it
  app:start               Starts Opencast
  [cmd] [args...]         Runs [cmd] with given arguments

Configuration

It's recommended to configure Opencast by using Docker Volumes:

$ docker run -v "/path/to/opencast-etc:/etc/opencast" opencast/<distribution>

The most important settings however can be configured by environment variables. You can use this functionally to generate new configuration files. For this start a new container with specific variables and execute the app:init command. This will ensure you haven't missed anything, write the configuration files and exit. Then you can copy the files to a target directory:

$ docker run --name opencast_generate_config \
  -e "ACTIVEMQ_BROKER_URL=failover://tcp://example.opencast.org:61616" \
  -e "ACTIVEMQ_BROKER_USERNAME=admin" \
  -e "ACTIVEMQ_BROKER_PASSWORD=password" \
  -e "ORG_OPENCASTPROJECT_SERVER_URL=http://localhost:8080" \
  -e "ORG_OPENCASTPROJECT_SECURITY_ADMIN_USER=admin" \
  -e "ORG_OPENCASTPROJECT_SECURITY_ADMIN_PASS=opencast" \
  -e "ORG_OPENCASTPROJECT_SECURITY_DIGEST_USER=opencast_system_account" \
  -e "ORG_OPENCASTPROJECT_SECURITY_DIGEST_PASS=CHANGE_ME" \
  opencast/<distribution> "app:init"
$ docker cp opencast_generate_config:/opencast/etc opencast-config
$ docker rm opencast_generate_config

Make sure to use the correct Opencast distribution as there are small differences.

Opencast

  • ORG_OPENCASTPROJECT_SERVER_URL Optional<br>
    The HTTP-URL where Opencast is accessible. The default is http://<Fully Qualified Host Name>:8080.
  • ORG_OPENCASTPROJECT_SECURITY_ADMIN_USER Required<br>
    Username of the admin user.
  • ORG_OPENCASTPROJECT_SECURITY_ADMIN_PASS Required<br>
    Password of the admin user.
  • ORG_OPENCASTPROJECT_SECURITY_DIGEST_USER Required<br>
    Username for the communication between Opencast nodes and capture agents.
  • ORG_OPENCASTPROJECT_SECURITY_DIGEST_PASS Required<br>
    Password for the communication between Opencast nodes and capture agents.
  • ORG_OPENCASTPROJECT_DOWNLOAD_URL Optional<br>
    The HTTP-URL to use for downloading media files, e.g. for the player. Defaults to ${org.opencastproject.server.url}/static.

For an installation with multiple nodes you can also set:

  • ORG_OPENCASTPROJECT_FILE_REPO_URL Optional<br>
    HTTP-URL of the file repository. Defaults to ${org.opencastproject.server.url} in the allinone distribution and ${org.opencastproject.admin.ui.url} for every other one.
  • PROP_ORG_OPENCASTPROJECT_ADMIN_UI_URL Required for all but allinone<br>
    HTTP-URL of the admin node.
  • PROP_ORG_OPENCASTPROJECT_ENGAGE_UI_URL Required for all but allinone<br>
    HTTP-URL of the engage node.

ActiveMQ

  • ACTIVEMQ_BROKER_URL Required<br>
    URL to ActiveMQ instances using the format specified in the Opencast documentation, e.g. failover://tcp://example.opencast.org:61616
  • ACTIVEMQ_BROKER_USERNAME Required<br>
    ActiveMQ username.
  • ACTIVEMQ_BROKER_PASSWORD Required<br>
    Password of the ActiveMQ user.

Database

  • ORG_OPENCASTPROJECT_DB_VENDOR Optional<br>
    The type of database to use. Currently you can set this to either H2 or MySQL. The default is H2.
  • ORG_OPENCASTPROJECT_DB_DDL_GENERATION Optional<br>
    Specifies whether Opencast should create the database tables or not. It defaults to false. In case of H2 it is always set to true.
  • NUMER_OF_TIMES_TRYING_TO_CONNECT_TO_DB Optional<br>
    Specifies how often Opencast is going to try to connect to the specified database before giving up. The waiting time between tries is 5 seconds. The default number of tries is 25. This configuration only applies if the database is not H2.

H2

There are no additional environment variables you can set if you are using the H2 database.

MySQL

  • ORG_OPENCASTPROJECT_DB_JDBC_URL Required<br>
    JDBC connection string.
  • ORG_OPENCASTPROJECT_DB_JDBC_USER Required<br>
    Database username.
  • ORG_OPENCASTPROJECT_DB_JDBC_PASS Required<br>
    Password of the database user.

Miscellaneous

  • TIMEZONE Optional<br>
    Set the timezone within the container. Valid timezones are represented by files in /usr/share/zoneinfo/, for example Europe/Berlin. The default is UTC.

Data

The data directory is located at /data. Use Docker Volumes to mount this directory on your host.

Languages

Opencast makes use of Tesseract to recognize text in videos (ORC) and Hunspell to identify spelling mistakes. For this both need additional files namely traningsdata and dictionaries respectively. These images come with files for the English and German language. If you need other or more languages you can use Docker Volumes to mount them in the appropriate directories /usr/share/tessdata and /usr/share/hunspell.

References

Docker Pull Command
Owner
opencast
Source Repository

Comments (0)