SKILL: Bohrium Image Management

Overview

Manage container images on the Bohrium platform. Prefer bohr CLI; fall back to the API for Dockerfile builds and version search.

Since 2023, Bohrium no longer supports VM jobs — container images are required.

Authentication

"bohrium-image": {
  "enabled": true,
  "apiKey": "YOUR_ACCESS_KEY",
  "env": { "ACCESS_KEY": "YOUR_ACCESS_KEY" }
}

Prerequisites: Install bohr CLI

# macOS
/bin/bash -c "$(curl -fsSL https://dp-public.oss-cn-beijing.aliyuncs.com/bohrctl/1.0.0/install_bohr_mac_curl.sh)"
# Linux
/bin/bash -c "$(curl -fsSL https://dp-public.oss-cn-beijing.aliyuncs.com/bohrctl/1.0.0/install_bohr_linux_curl.sh)"
source ~/.bashrc && export PATH="$HOME/.bohrium:$PATH"

List Images

bohr image list                 # Custom images (table)
bohr image list --json          # JSON

# Public images by type
bohr image list -t "Basic Image"
bohr image list -t "DeePMD-kit"
bohr image list -t "LAMMPS"
bohr image list -t "ABACUS"
bohr image list -t "CP2K"
bohr image list -t "GROMACS"
bohr image list -t "Uni-Mol"

JSON fields: imageId, name, url, status (available/building), creatorName

Quick Reference: Public Images

Base Images

Scientific Software

Pre-installed Software (All Public Images)

VM-to-Container Image Mapping

Pull Image to Local

bohr image pull registry.dp.tech/dptech/deepmd-kit:3.0.0b3-cuda12.1

Requires Docker running locally. Only public and your own custom images are supported.

Manual Docker Pull (Alternative)

Replace domain with registry.bohrium.dp.tech (not registry.dp.tech):

docker login registry.bohrium.dp.tech
docker pull registry.bohrium.dp.tech/dptech/ubuntu:22.04-py3.10-intel2022
# Push is not supported

Delete Custom Images

bohr image delete 121510
bohr image delete 121510 121395         # Batch

Image Cache

API Supplement (CLI Unsupported)

Search Public Image Versions

import os, requests
AK = os.environ.get("ACCESS_KEY", "")
HEADERS = {"accessKey": AK}

r = requests.get("https://open.bohrium.com/openapi/v2/image/public/version/search",
    headers=HEADERS, params={"keyword": "deepmd", "page": 1, "pageSize": 5})
# Returns: {items: [{version, resourceType, size, url, imageName}, ...]}

Browse Public Images

r = requests.get("https://open.bohrium.com/openapi/v2/image/public",
    headers=HEADERS, params={"page": 1, "pageSize": 10})

r = requests.get(f"https://open.bohrium.com/openapi/v2/image/public/{image_id}/version",
    headers=HEADERS, params={"page": 1, "pageSize": 10})

Build from Dockerfile

HEADERS_JSON = {**HEADERS, "Content-Type": "application/json"}

# Note: dockerfile field must be base64-encoded
import base64
dockerfile_content = "FROM ubuntu:22.04\nRUN apt-get update && apt-get install -y python3"
dockerfile_b64 = base64.b64encode(dockerfile_content.encode()).decode()

r = requests.post("https://open.bohrium.com/openapi/v2/image/private",
    headers=HEADERS_JSON, json={
        "name": "my-image", "projectId": 154, "device": "container",
        "desc": "Custom training image", "buildType": 1,
        "dockerfile": dockerfile_b64,
    })

# Validate Dockerfile (also requires base64)
check_b64 = base64.b64encode(b"FROM ubuntu:22.04\nRUN apt-get update").decode()
requests.post("https://open.bohrium.com/openapi/v2/image/dockerfile/check",
    headers=HEADERS_JSON, json={"dockerfile": check_b64})

Private Image Management

# List (must include device and type parameters)
r = requests.get("https://open.bohrium.com/openapi/v2/image/private",
    headers=HEADERS, params={"device": "container", "type": "private", "page": 1, "pageSize": 10})
# Returns: {items: [{id, name, url, status, buildType, creatorName, projectName, ...}]}

# Share / unshare
requests.post(f"https://open.bohrium.com/openapi/v2/image/{image_id}/share", headers=HEADERS_JSON)
requests.delete(f"https://open.bohrium.com/openapi/v2/image/{image_id}/share?device=container", headers=HEADERS)

Custom Image Creation

After installing software on a container node, save the environment as a custom image via the Bohrium web UI. Only the system disk is saved; /personal and /share are excluded.

Quotas

Unavailable Endpoints

Troubleshooting