Update: 10/18/2017 -- ROCm v1.6.4 images now available
This repository contains a framework for building the software layers defined in the Radeon Open Compute Platform into portable docker images. The following are docker dependencies, which should be installed on the target machine.
- Docker on Ubuntu systems or Fedora systems
- Highly recommended: Docker-Compose to simplify container management
ROCm-docker quick start videos
In order to successfully use this image, the host needs the ROCm kernel with kernel modules installed and running on one of the above supported platforms. The following video demonstrates how to install the ROCm kernel on an Ubuntu platform
- Installing ROCK kernel on Ubuntu 14.04
Running a prompt in a rocm container
The following command creates a fresh ROCm container and loads a bash prompt ready for work
sudo docker run -it --rm --device="/dev/kfd" rocm/rocm-terminal
or if using docker-compose (requires docker-compose.yml generated from github repo rocm-setup.sh)
sudo docker-compose run --rm rocm
Commit container state to a new docker image
Docker containers are typically ephemeral, and discarded after closing the container with the '--rm' flag to
docker run. However, there are times when it is desirable to close a container with arbitrary work in it, and serialize back into a new docker image. This may be to to create a checkpoint in a long and complicated series of instructions, or it may be desired to share the image with others through a docker registry, such as docker hub. The following video demonstrates the commit process.
sudo docker ps -a sudo docker commit <container-name> <new-image-name> sudo docker images