jfxs/devcontainer-uv-npm

devcontainer uv npm

镜像概述和主要用途

这是一个基于Debian的devcontainer镜像，集成了uv和npm工具，专为在容器环境中进行Python前端开发设计。镜像支持多架构（amd64和arm64），通过软件物料清单（SBOM）变化实现自动更新，使用Cosign进行签名，并通过Syft添加SBOM证明，可在Docker Hub和Quay.io获取。

核心功能和特性

• 多架构支持：同时支持amd64和arm64架构
• 自动更新机制：通过比较SBOM变化实现镜像自动更新
• 安全保障：使用Cosign进行镜像签名，确保完整性
• 透明可追溯：通过Syft生成SBOM证明，提供软件成分透明度
• 多平台可用：镜像发布于Docker Hub和Quay.io两个容器 registry
• shell支持：优化zsh shell体验，同时包含bash shell
• 开发工具集成：内置task工具，便于运行常用开发命令

使用场景和适用范围

适用于需要在隔离容器环境中进行Python前端开发的场景，特别适合使用VSCode的devcontainer功能进行开发的用户，可提供一致的开发环境配置。

使用方法和配置说明

在VSCode中运行

创建或修改.devcontainer/devcontainer.json配置文件，以使用该镜像进行容器内开发：

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

本地运行

通过以下命令在本地启动容器并进入zsh shell：

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

Task工具使用

镜像内置task工具，可通过Taskfile.yml定义和运行开发命令。示例配置：

安装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
所有检查通过！
$ task format
所有检查通过！
1个文件已重新格式化

构建信息

Docker最新标签为0.10.2-001、0.10、0，包含以下主要软件组件：

最新镜像详细信息可查看https://hub.docker.com/r/jfxs/devcontainer-uv-npm%E3%80%82

版本控制

Docker标签遵循以下格式：

text
<uv_version>-<increment>

其中：

• <uv_version>：使用的uv版本
• <increment>：从001开始的构建序号，用于区分相同uv版本的不同构建

示例：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。