jfxs/devcontainer-uv Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

devcontainer uv

![流水线状态]([***]

一个基于devcontainer Debian镜像并集成uv的容器镜像，用于在容器内进行Python开发：

• 支持amd64和arm64的多架构镜像
• 通过比较软件物料清单（SBOM）变更实现自动更新
• 使用Cosign进行镜像签名
• 通过Syft添加软件物料清单（SBOM）证明
• 在Docker Hub和Quay.io均有镜像分发

![GitLab]([***] 主仓库

![Docker Hub]([***] Docker Hub registry

![Quay.io]([***] Quay.io registry

该镜像为zsh shell用户提供优化体验，同时也包含bash shell。

核心功能与特性

架构与分发

• 多架构支持：amd64、arm64
• 多平台分发：Docker Hub、Quay.io

安全与维护

• 自动更新：基于SBOM变更检测
• 镜像签名：使用Cosign确保完整性
• SBOM证明：通过Syft生成软件物料清单

开发工具

• 集成uv：Python包管理器
• 内置task：任务运行工具
• 支持zsh/bash：优化开发环境

使用场景

• Python项目容器化开发环境
• VS Code远程容器开发
• 跨平台一致的开发环境配置
• 需要自动化任务管理的Python项目

使用方法

VSCode开发配置

通过.devcontainer/devcontainer.json配置容器内开发：

json
{
  "image": "jfxs/devcontainer-uv",
  ...
}

本地运行

shell
docker run -it --rm -v $(pwd):/workdir --user vscode:vscode jfxs/devcontainer-uv /bin/zsh

Task工具使用

该镜像包含task工具用于运行命令。

示例：

安装Ruff开发依赖后，在Taskfile.yml中添加以下内容：

yaml
  lint:
    desc: "使用Ruff进行Python代码检查"
    cmds:
      - uv run ruff check
    silent: true

  format:
    desc: "使用Ruff格式化Python代码"
    cmds:
      - uv run ruff check --fix
      - uv run ruff format
    silent: true

运行命令：

shell
$ task lint
All checks passed!
$ task format
All checks passed!
1 file reformatted

内置软件版本

Docker latest标签为0.10.9-002, 0.10, 0，包含以下软件：

Dockerhub概览页提供最新发布镜像的详细信息。

版本控制

Docker标签定义规则：

• uv版本号
• 连字符
• 构建增量号（从001开始，用于区分相同uv版本的不同构建）

格式：<uv_version>-<increment>

示例：0.5.2-001

签名与证明验证

Cosign公钥：

shell
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEa3yV6+yd/l4zh/tfT6Tx+zn0dhy3
BhFqSad1norLeKSCN2MILv4fZ9GA6ODOlJOw+7vzUvzZVr9IXnxEdjoWJw==
-----END PUBLIC KEY-----

公钥也可在线获取：<[***]>

验证镜像

shell
cosign verify --key cosign.pub $IMAGE_URI

验证并获取SBOM证明

shell
cosign verify-attestation --key cosign.pub --type spdxjson $IMAGE_URI | jq '.payload | @base64d | fromjson | .predicate'

作者

• FX Soubirou - 初始开发 - GitLab仓库

许可证

本程序是自由软件：您可以根据MIT许可证（MIT）的条款重新分发和/或修改它。详情参见LICENSE。