开发容器（Devcontainers）

本仓库包含常用工具的VSCode开发容器镜像，旨在提供便捷的开发环境配置。仓库中提供两个Dockerfile，分别基于poetry和uv包管理工具，每个Dockerfile包含多个构建目标以满足不同开发需求。

核心功能与特性

构建目标

每个Dockerfile包含以下构建目标，依次叠加工具集：

1. base：基础层，包含Python 3.10/11/12、对应包管理器（poetry或uv）及pipx
2. just：在base基础上添加just命令行工具
3. terraform：在just基础上添加Terraform
4. gcloud：在terraform基础上添加gcloud CLI

镜像构建与分发

• 每月自动构建一次，确保工具版本更新
• 推送至Docker Hub
• 标签格式：linux-<PLATFORM>-ubuntu2204-py<POETRY/UV><PYTHON-VERSION>-<YYYMMDD>-<TARGET>
  示例：linux-arm64-ubuntu2204-pypoetry312-20240827-gcloud

使用场景

适用于需要快速搭建包含Python环境、包管理工具及常用开发工具（如just、Terraform、gcloud）的VSCode开发环境，尤其适合依赖这些工具链的Python项目开发。

使用方法与配置说明

镜像标签说明

标签结构中各部分含义：

• <PLATFORM>：硬件架构（如arm64、amd64）
• <POETRY/UV>：包管理器类型（pypoetry或pyuv）
• <PYTHON-VERSION>：Python版本（如310、311、312）
• <YYYMMDD>：构建日期
• <TARGET>：构建目标（base/just/terraform/gcloud）

示例 devcontainer.json 配置

以下是配合本镜像使用的典型devcontainer.json配置示例：

{
    "build": {
      "dockerfile": "Dockerfile",
      "context": "."
    },
    "containerEnv": {
      "HOME": "/home/vscode"
    },
    "customizations": {
      "vscode": {
        "extensions": [
          "ms-python.python",
          "ms-toolsai.jupyter",
          "ms-python.vscode-pylance",
          "tamasfe.even-better-toml",
          "kokakiwi.vscode-just",
          "redhat.vscode-yaml"
        ],
        "settings": {
          "python.pythonPath": "/home/vscode/workspace/.venv/bin/python"
        }
      }
    },
    "postStartCommand": "git config --global --add safe.directory ${containerWorkspaceFolder} && git config --global --add credential.useHttpPath true",
    // 可选：如需使用.env文件，保留以下配置；否则移除
    "runArgs": [
      "--env-file",
      ".devcontainer/.env"
    ],
    "workspaceFolder": "/home/vscode/workspace",
    "workspaceMount": "source=${localWorkspaceFolder},target=/home/vscode/workspace,type=bind",
    // 可选：如需在容器内使用Docker，添加以下配置（会增加构建时间）
    "features": {
      "ghcr.io/devcontainers/features/docker-in-docker:2": {}
    }
  }

配置说明

• build：指定Dockerfile路径及构建上下文
• containerEnv：设置容器内环境变量（如HOME目录）
• customizations.vscode：配置VSCode扩展及设置，确保Python环境正确关联
• postStartCommand：容器启动后执行的命令，如Git配置
• runArgs：传递给容器的运行参数，如挂载.env文件
• workspaceMount：将本地工作区挂载到容器内指定路径
• features：可选功能，如添加Docker-in-Docker支持

更多详情参见GitHub仓库。