jfxs/devcontainer-uv

devcontainer uv

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

一个基于devcontainer https://github.com/devcontainers/images/tree/main/src/base-debian%E5%B9%B6%E9%9B%86%E6%88%90https://github.com/astral-sh/uv%E7%9A%84%E5%AE%B9%E5%99%A8%E9%95%9C%E5%83%8F%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8%E5%AE%B9%E5%99%A8%E5%86%85%E8%BF%9B%E8%A1%8CPython%E5%BC%80%E5%8F%91%EF%BC%9A

• 支持amd64和arm64的多架构镜像
• 通过比较软件物料清单（SBOM）变更实现自动更新
• 使用https://github.com/sigstore/cosign%E8%BF%9B%E8%A1%8C%E9%95%9C%E5%83%8F**%E7%AD%BE%E5%90%8D**
• 通过https://github.com/anchore/syft%E6%B7%BB%E5%8A%A0**%E8%BD%AF%E4%BB%B6%E7%89%A9%E6%96%99%E6%B8%85%E5%8D%95%EF%BC%88SBOM%EF%BC%89%E8%AF%81%E6%98%8E**
• 在Docker Hub和Quay.io均有镜像分发

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

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，包含以下软件：

https://hub.docker.com/r/jfxs/devcontainer-uv%E6%8F%90%E4%BE%9B%E6%9C%80%E6%96%B0%E5%8F%91%E5%B8%83%E9%95%9C%E5%83%8F%E7%9A%84%E8%AF%A6%E7%BB%86%E4%BF%A1%E6%81%AF%E3%80%82

版本控制

Docker标签定义规则：

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

格式：<uv_version>-<increment>

示例：0.5.2-001

签名与证明验证

https://github.com/sigstore/cosign%E5%85%AC%E9%92%A5%EF%BC%9A

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。