This repository hosts docker build files of software stacks and services, designed to enable Open Visual Cloud prioritized use cases such as media delivery, media analytics, cloud gaming and cloud graphics, and immersive media.

Validated docker images are available on Docker Hub.
Explore more container solutions on the Intel® oneContainer Portal.

The software stack images provide ready to use software stacks for application deployment. You can call the software executables or link with the software libraries.

• Media Delivery

• Media Analytics

• Cloud Gaming and Graphics

Ospray images are discontinued from release v21.6. Please refer to older releases for all images targeted for Cloud Gaming and Graphics.

The development images enable C++ application compilation, debugging (with the debugging, profiling tools) and optimization (with the optimization tools.) You can compile C++ applications with these images and then copy the applications to the corresponding deployment images.

The service images provides ready to use services. See their image descriptions for exposed service interfaces.

The project supports the following platforms and OS'es:

Please see Development and Test Report for the latest development statuses.

• Update kernels and firmwares: Please see each platform folder README for details.
• Install cmake and m4 if they are not available on your platform.
• Make sure your host datetime and timezone are configured properly, a prerequisite to install any Ubuntu security updates.
• Follow the instructions to setup host date and time.
• Follow the instructions to install docker.ce or docker.ee.
• If you are behind a firewall, setup proxy as follows:

sudo mkdir -p /etc/systemd/system/docker.service.d    
printf "[Service]\nEnvironment=\"HTTPS_PROXY=$https_proxy\" \"NO_PROXY=$no_proxy\"\n" | sudo tee /etc/systemd/system/docker.service.d/proxy.conf    
sudo systemctl daemon-reload     
sudo systemctl restart docker     

The docker images are published on Docker Hub with name pattern openvisualcloud/<_platform_>-<_OS_>-<_usage_>-<_image_>. Find and use the images as follows:

docker search openvisualcloud --limit=100 | grep analytics-ffmpeg #list media analytics ffmpeg images 
docker pull openvisualcloud/xeon-ubuntu1804-analytics-ffmpeg

mkdir build    
cd build     
cmake ..     
# Please build your specific platform image. A full build takes a long time.
cd Xeon/ubuntu-18.04/media/ffmpeg     
# Build on the target platform for optimal performance.
make    
ctest   

See Also: Build Options

Xeon/ubuntu-18.04/media/ffmpeg/shell.sh #<_platform_>/<_OS_>/<_usage_>/<_image_>

• You can modify any Dockerfile.m4 template for customization.
  For example, uncomment #include(transform360.m4) in Xeon/ubuntu-18.04/media/ffmpeg/Dockerfile.m4 to add essential 360 video transformation in the FFmpeg build.

After modification, please rerun cmake and make.

See Also: Build Options

It is recommended that you copy the Dockerfile(s) of your platform, OS and image directly into your project. The following shell scripts show how to sync (if needed) and build the NGINX Dockerfile (and its dependency FFmpeg):

update.sh:

DOCKER_REPO=${DOCKER_REPO="https://raw.githubusercontent.com/OpenVisualCloud/Dockerfiles/master/Xeon/ubuntu-18.04/media"}    
(echo "# xeon-ubuntu1804-media-ffmpeg" && curl ${DOCKER_REPO}/ffmpeg/Dockerfile) > Dockerfile.2    
(echo "# xeon-ubuntu1804-media-nginx" && curl ${DOCKER_REPO}/nginx/Dockerfile) > Dockerfile.1    

build.sh:

for dep in .2 .1; do   
    image=$(grep -m1 '#' "Dockerfile$dep" | cut -d' ' -f2)   
    docker build --network=host --file="Dockerfile$dep" -t "$image:latest" . $(env | grep -E '_(proxy)=' | sed 's/^/--build-arg /')   
done