Base and R2DT Docker Images
This project uses a combination of two Docker images:
base_image and the R2DT image. The
base_image contains all non-Python dependencies of R2DT, while the R2DT image includes the necessary Python packages.
The build process for the base image is detailed in base_image/Dockerfile. It uses GCC to compile C/C++ code and installs additional dependencies, such as Perl-related tools.
Once built, the base image is uploaded to Docker Hub under the name
Rebuilding the base image is rare and is necessary only when an R2DT dependency is updated and needs integration into the R2DT build.
View rnacentral/r2dt-base on Docker Hub →
The R2DT image is constructed using the Dockerfile located in the repository’s root folder. It inherits from
This approach ensures that the R2DT image remains compact, containing only the Python and R2DT dependencies, excluding the extensive build tools used in the base image. Most changes in the Python code can be made using the prebuilt dependencies and do not require recompilation of C/C++ code.
View rnacentral/r2dt on Docker Hub →
When updating the base image, follow these steps:
Create a branch from
developand make necessary changes to
Build the base image locally and test it. Update the
FROMdirective in the R2DT’s image Dockerfile to reference the locally built base image. Use the
just bbuildcommand to build the base image locally.
Submit a pull request, triggering image build via GitHub Actions. The resulting base image will be tagged with your pull request ID (e.g.,
If you plan to use the newly built image in subsequent R2DT development, notify the repository maintainers. Ask them to tag your image as a new release version using the corresponding workflow. Only repository maintainers have permission to run this workflow. Update the
FROMdirective in the R2DT’s image Dockerfile to reference the newly tagged base image.
Note: When changes to both base and R2DT images are required, it is recommended to submit separate pull requests. This allows the base image to be built with the new version on Dockerhub before the R2DT image is built with the updated base image.