Images
This article introduces the use of Bohrium images and the software content included in the official images.
What is image？
Image is a file storage format that contains the basic environment and other information required for running an application. Bohrium has created images suitable for different development scenarios and computing jobs according to user needs.
How to use image?
Submit computing job
When you submitting a job with Bohrium CLI , please enter the container image address corresponding to the software you need to use in the image_address field of the job.json. The image address can be viewed in the Images.
If the software we provide does not meet your requirements, you can refer to how to create a custom image for custom software installation or contact bohrium@dp.tech for assistance.
Notice: Starting from January 1, 2023, Bohrium will no longer support submitting virtual machine jobs using virtual machine images. To ensure that your job can be successfully submitted, please use the container image when submitting the job and configure the job_type field in job.json as container.
Software development/debugging
Bohrium supports starting container nodes. Compared to traditional virtualization technology, containers eliminate the need for operating system virtualization and directly encapsulate the environment and dependencies required for applications or services on the host operating system. It only takes a few seconds to start a new container instance, while traditional virtualization technologies require several minutes.
We recommend that you start a container node for software development, debugging, etc. You can select the corresponding container image when starting the container management node, as shown in Figure 2 below. You can view the official container images and virtual machine images provided in the Images.
- If you want a blank machine with a pre-installed basic environment, we recommend that you use the following container images based on your requirements for resource types and whether to run MPI or not:
| Resource type | Image Address |
|---|---|
| CPU | registry.dp.tech/dptech/ubuntu:20.04-py3.10 registry.dp.tech/dptech/ubuntu:20.04-py3.10-intel2022 |
| GPU | registry.dp.tech/dptech/ubuntu:20.04-py3.10-cuda11.6 registry.dp.tech/dptech/ubuntu:20.04-py3.10-intel2022-cuda11.6 |
If you want to customize existing scientific computing software on Bohrium or run DPGEN jobs, you can start the management node using the corresponding container image.
Since the container node itself is already a docker environment, it does not support creating another docker environment on top of it. If you have requirements for docker development, such as needing to build your own docker images. Please use the virtual machine image
LBG_Common_v2to start a virtual machine management node for development.
Images provided by Bohrium
Images for submitting jobs
The following is a list of some of the pre-installed scientific computing software on Bohrium. For more software, please visit the Images:
- DeePMD-kit
- DPGEN
- VASP: To obtain VASP authorization, please send your VASP authorization certificate to the bohrium@dp.tech
- LAMMPS
- GROMACS
- Quantum-Espresso
- ...
Images for software development
For more flexible job such as software development, compilation, debugging. You can use the basic public container image when starting the management node, which already includes commonly used development software:
| Resource type | Image Address |
|---|---|
| CPU | registry.dp.tech/dptech/ubuntu:20.04-py3.10 registry.dp.tech/dptech/ubuntu:20.04-py3.10-intel2022 |
| GPU | registry.dp.tech/dptech/ubuntu:20.04-py3.10-cuda11.6 registry.dp.tech/dptech/ubuntu:20.04-py3.10-intel2022-cuda11.6 |
All images provided by Bohrium come with the following pre-installed software:
| Software categories | Pre-installed software |
|---|---|
| Python-related | python3.10 pip Anaconda Jupyter Lab：Powerful Notebook tool |
| File management | wget, curl: file download tool unzip: file decompression tool emacs, vim: file editing tool rsync: file synchronization tool tree: directory structure viewing tool git: version control tool |
| Compilation tool | cmake build-essential: gnu compilation tool |
| System monitoring | htop: monitoring tool ncdu: used for viewing directory size net-tools: network tools |
| DP series | Lebesgue Utility: Bohrium-developed command-line interactive tool for resource management, job management, project monitoring, and other functions Dp-Dispatcher: Declare high-performance computing jobs, computing environments, and computing resources, automatically completing the entire process of job generation, submission, polling, and recycling Dpdata: scientific computing format conversion tool |
Some images come with specific pre-installed software, such as Intel-oneapi, Pytorch, TensorFlow, etc. It is reflected in the image address, you can choose based on your actual needs. For example, registry.dp.tech/dptech/ubuntu:20.04-py3.10-intel2022 comes with Intel-oneapi pre-installed.
How to create a custom image
If the software we provide does not meet your requirements, you can refer to how to create a custom image for custom software installation or contact bohrium@dp.tech for assistance.
How to Pull an Image to Local Docker
Currently, you can use the Docker CLI to pull Bohrium's public images and your own custom images (shared images from others are not supported).
Access Address
registry.bohrium.dp.tech (Please manually replace the copied registry.dp.tech domain from the Bohrium image menu, as it is not supported!)
Usage
- Docker login: Use your Bohrium account username and password to log in
docker login registry.bohrium.dp.tech
Username: xxx@dp.tech
Password:
Login Succeeded
- Docker pull: Pull the Bohrium public image
docker pull registry.bohrium.dp.tech/dptech/ubuntu:22.04-py3.10-intel2022
- Push operations are not currently supported