wolfyuan/dolphin Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

🐬 Dolphin

All-in-one solution for hosting your code

Dolphin is still under heavy development, please create an issue if you face any bugs or request a feature

Dolphin is a cool container image that prepared everything for you!

✨ Features:

• Container running with s6-overlay
• Modular design
• Support a wide variety of language
• Multi-base image and CPU architecture
• Code runs in a rootless process

---

• 🏃 Running image
• 📦️ Container images
  • Tagging format
• 🌎️ Environment variables and workflow
  • Variables that apply to every image
  • Image specific options
• 💾 Persist data inside container
• 🎩 RedHat Podman support
• 📽️ Graphics card support

🏃 Running image

bash
docker run --name dolphin-box -d \
  -e GIT_URL="[***]" \
  --restart unless-stopped \
  docker.io/wolfyuan/dolphin:node

---

Command breakdown: -e GIT_URL="[***]" - Environment variables for controlling container, see here for a full list

You can add multiple variables, like:

-e GIT_URL="[***]" -e SYSTEM_PACKAGES="automake"

So the whole command will be

bash
docker run --name dolphin-box -d \
 -e GIT_URL="[***]" \
 -e SYSTEM_PACKAGES="automake" \
 --restart unless-stopped \
 docker.io/wolfyuan/dolphin:node

--restart unless-stopped - Restart your container when it fails or you reboot your machine unless you stop it by yourself

docker.io/wolfyuan/dolphin:node - Container image, where node represents to image that's designed for this language, see here for full list

📦️ Container images

Most image supports arm based CPU unless mentioned in the note.

Tagging format

Images are tagged with this format: [Image Tag]-[Image Variants]

For example, the node image with ubuntu base will be: node-ubuntu

If you don't specify image variants, it will pull the ubuntu base

For example, pulling the node tag will pull the node-ubuntu image

🌎️ Environment variables and workflow

Applies to every image:

Environment variables:

Workflow:

1. Container starts
2. Prepare runner folders
3. Add additional system packages
4. Clone git repo with GIT_URL

Image-specific options

node

Environment variables:

Environment variables name	Description
NODE_VERSION	Node.js version to install, overrides .nvmrc
NODE_START_SCRIPT	Script to run when container finished running init script

Workflow:

1. Container start
2. Base image initialize
3. Install Node.js via NODE_VERSION or .nvmrc in your project
4. Install npm packages via the detected package manager
5. Run build script via detected package manager if presents
6. Start the Node.js process via NODE_START_SCRIPT or script in package.json via the detected package manager

📝 Note
Supported package managers: pnpm, yarn, npm

📝 Note
In package manager: pnpm > yarn > npm
In node version: NODE_VERSION > .nvmrc

python

Environment variables:

Environment variables name	Description
PYTHON_VERSION	Python version to install, overrides .python-version
PYTHON_BUILD_SCRIPT	Script to run after installing Python packages
PYTHON_START_SCRIPT	Script to run when container finished running init script
PYTHON_START_FILE	Script to run when container finished running init script

Workflow:

1. Container start
2. Base image initialize
3. Install Python via PYTHON_VERSION or .python-version in your project
4. Install python packages via pip
5. Start the Python process via PYTHON_START_SCRIPT and the script in PYTHON_START_FILE with command python3

⚠️ Warning
Due to how pyenv switch Python version, it's recommended to presist your container storage, see Presist data inside container for more info

📝 Note
When PYTHON_START_SCRIPT and PYTHON_START_FILE both exists, it will run PYTHON_START_SCRIPT first, and run PYTHON_START_FILE after previous script has finished

📝 Note
In Python version: PYTHON_VERSION > .python-version

💾 Persist data inside container

You can mount two types of directory to the Dolphin container:

• /home/dolphin: Contain your code (space), and other runtime binaries installation like nvm, pyenv

  Use this when you want to save more bandwidth

• /home/dolphin/space

  Use this when you want to prevent rebuilding your project

To mount the directory, append these arguments when starting the Docker container:

bash
-v /path/to/your/host/folder:/home/dolphin

or

bash
-v /path/to/your/host/folder:/home/dolphin/space

🎩 RedHat Podman support

It SHOULD work, maybe

📽️ Graphics card support

I haven't tried it, but your application will be run in a rootless environment, so it might not work.