ghcr.io/prefix-dev/pixi:0.72.0-plucky

pixi-docker

本仓库包含 pixi 容器镜像的 Docker 配置。pixi 容器镜像根据使用场景基于不同的基础镜像构建。所有镜像均已在 /usr/local/bin/pixi 路径下安装 pixi，可直接使用。

/usr/local/bin/pixi

拉取镜像

镜像托管于 "GHCR"（GitHub 容器 registry）。可通过以下 Docker 命令拉取：

docker pull ghcr.io/prefix-dev/pixi:latest

针对不同基础镜像提供了多种标签：

• latest - 基于 ubuntu:noble
• focal - 基于 ubuntu:focal
• bullseye - 基于 debian:bullseye
• noble-cuda-12.9.1 - 基于 nvidia/cuda:12.9.1-base-ubuntu24.04
• noble-cuda-13.0.0 - 基于 nvidia/cuda:13.0.0-base-ubuntu24.04
• ... 以及更多

使用 shell-hook

以下示例将 pixi Docker 镜像用作多阶段构建的基础镜像。同时利用 pixi 的 shell-hook 功能定义便捷的入口点（执行 shell-hook 脚本后，环境将被激活）。

FROM ghcr.io/prefix-dev/pixi:0.40.0 AS build

# 将源代码、pixi.toml 和 pixi.lock 复制到容器中
COPY . /app
WORKDIR /app
# 运行编译/构建任务（如需要）
RUN pixi run build
# 运行 `install` 命令（或其他命令）。此操作会将依赖安装到 `/app/.pixi`
# 假设你的 pixi.toml 中定义了 `prod` 环境
RUN pixi install -e prod
# 创建用于激活环境的 shell-hook bash 脚本
RUN pixi shell-hook -e prod
> /shell-hook.sh

# 扩展 shell-hook 脚本以运行传递给容器的命令
RUN echo 'exec "$@"'
>> /shell-hook.sh

FROM ubuntu:24.04 AS production

# 仅将生产环境复制到生产容器
# 注意：路径前缀必须与构建容器中的保持一致
COPY --from=build /app/.pixi/envs/prod /app/.pixi/envs/prod
COPY --from=build /shell-hook.sh /shell-hook.sh
WORKDIR /app
EXPOSE 8000

# 将入口点设置为 shell-hook 脚本（激活环境并运行命令）
# 生产容器中不再需要 pixi
ENTRYPOINT ["/bin/bash", "/shell-hook.sh"]

CMD ["start-server"]

镜像

提供基于 ubuntu、debian 和 nvidia/cuda 的镜像。

Ubuntu

基于 https://hub.docker.com/_/ubuntu%EF%BC%8824.04%EF%BC%89%E7%9A%84%E9%95%9C%E5%83%8F%E4%B8%BA%E9%BB%98%E8%AE%A4%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E4%BA%8E latest 和 0.x.y 标签。

同时提供基于 ubuntu:focal（20.04）、ubuntu:jammy（22.04）、ubuntu:oracular（24.10）和 ubuntu:plucky（25.04）的镜像。这些镜像使用标签 focal、0.x.y-focal 等。

Debian

提供基于 https://hub.docker.com/_/debian%E3%80%81%60debian:bullseye-slim%60%EF%BC%8811%EF%BC%89%E3%80%81%60debian:bookworm%60%E3%80%81%60debian:bookworm-slim%60%EF%BC%8812%EF%BC%89%E3%80%81%60debian:trixie%60 和 debian:trixie-slim（13）的镜像。

这些镜像使用标签 bullseye、0.x.y-bullseye 等。

NVIDIA/CUDA

提供基于 https://hub.docker.com/r/nvidia/cuda 的镜像，使用标签 cuda-<version>-jammy、cuda-<version>-focal、0.x.y-cuda-<version>-jammy 等。

---

pixi-docker

本仓库包含 pixi 容器镜像的 Docker 配置。pixi 容器镜像根据使用场景基于不同的基础镜像构建。所有镜像均已在 /usr/local/bin/pixi 路径下安装 pixi，可直接使用。

拉取镜像

镜像可从 https://github.com/prefix-dev/pixi-docker/pkgs/container/pixi%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B Docker 命令拉取：

docker pull ghcr.io/prefix-dev/pixi:latest

针对不同基础镜像提供了多种标签：

• latest - 基于 ubuntu:noble
• focal - 基于 ubuntu:focal
• bullseye - 基于 debian:bullseye
• noble-cuda-12.9.1 - 基于 nvidia/cuda:12.9.1-base-ubuntu24.04
• noble-cuda-13.0.0 - 基于 nvidia/cuda:13.0.0-base-ubuntu24.04
• ... 以及更多

使用 shell-hook

以下示例将 pixi Docker 镜像用作多阶段构建的基础镜像。同时利用 pixi 的 shell-hook 功能定义便捷的入口点（执行 shell-hook 脚本后，环境将被激活）。

FROM ghcr.io/prefix-dev/pixi:0.40.0 AS build

# 将源代码、pixi.toml 和 pixi.lock 复制到容器中
COPY . /app
WORKDIR /app
# 运行编译/构建任务（如需要）
RUN pixi run build
# 运行 `install` 命令（或其他命令）。此操作会将依赖安装到 `/app/.pixi`
# 假设你的 pixi.toml 中定义了 `prod` 环境
RUN pixi install -e prod
# 创建用于激活环境的 shell-hook bash 脚本
RUN pixi shell-hook -e prod
> /shell-hook.sh

# 扩展 shell-hook 脚本以运行传递给容器的命令
RUN echo 'exec "$@"'
>> /shell-hook.sh

FROM ubuntu:24.04 AS production

# 仅将生产环境复制到生产容器
# 注意：路径前缀必须与构建容器中的保持一致
COPY --from=build /app/.pixi/envs/prod /app/.pixi/envs/prod
COPY --from=build /shell-hook.sh /shell-hook.sh
WORKDIR /app
EXPOSE 8000

# 将入口点设置为 shell-hook 脚本（激活环境并运行命令）
# 生产容器中不再需要 pixi
ENTRYPOINT ["/bin/bash", "/shell-hook.sh"]

CMD ["start-server"]

镜像

提供基于 ubuntu、debian 和 nvidia/cuda 的镜像。

Ubuntu

基于 https://hub.docker.com/_/ubuntu%EF%BC%8824.04%EF%BC%89%E7%9A%84%E9%95%9C%E5%83%8F%E4%B8%BA%E9%BB%98%E8%AE%A4%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E4%BA%8E latest 和 0.x.y 标签。

同时提供基于 ubuntu:focal（20.04）、ubuntu:jammy（22.04）、ubuntu:oracular（24.10）和 ubuntu:plucky（25.04）的镜像。这些镜像使用标签 focal、0.x.y-focal 等。

Debian

提供基于 https://hub.docker.com/_/debian%E3%80%81%60debian:bullseye-slim%60%EF%BC%8811%EF%BC%89%E3%80%81%60debian:bookworm%60%E3%80%81%60debian:bookworm-slim%60%EF%BC%8812%EF%BC%89%E3%80%81%60debian:trixie%60 和 debian:trixie-slim（13）的镜像。

这些镜像使用标签 bullseye、0.x.y-bullseye 等。

NVIDIA/CUDA

提供基于 https://hub.docker.com/r/nvidia/cuda 的镜像，使用标签 cuda-<version>-jammy、cuda-<version>-focal、0.x.y-cuda-<version>-jammy 等。