workspace-images

镜像概述和主要用途

workspace-images 是为 Gitpod 工作区设计的即用型 Docker 镜像，作为 Gitpod 的默认工作区镜像提供。所有镜像均发布于 Docker Hub，仓库路径为 gitpod/*，旨在帮助开发者快速启动预配置的 Gitpod 开发环境。

核心功能和特性

• 即用型设计：预配置必要的开发工具链和运行环境，无需额外手动配置即可直接集成到 Gitpod 工作流中
• ***默认支持：作为 Gitpod 平台的标准工作区镜像，提供深度兼容性和稳定性
• 版本标签管理：提供多版本标签以适配不同环境需求，例如 legacy-dazzle-v1 标签专为 dazzlev1 版本环境设计
• Docker Hub 分发：通过 Docker Hub 公开托管，支持标准 Docker 命令拉取和部署

使用场景和适用范围

• Gitpod 工作区的快速创建与运行
• 需要标准化开发环境的团队协作场景
• 与 Gitpod 集成的开发项目，尤其是希望利用预配置环境加速开发启动的场景
• 需要兼容旧版 dazzlev1 环境的迁移或维护工作

详细的使用方法和配置说明

获取镜像

通过 Docker Hub 拉取镜像，基础命令格式：

bash
docker pull gitpod/<镜像名称>:<标签>

示例：拉取最新版基础镜像

bash
docker pull gitpod/workspace-base:latest

版本标签说明

• 默认标签：未指定标签时默认使用 latest，对应最新稳定版本
• legacy-dazzle-v1：适用于需要兼容 dazzlev1 环境的场景，拉取命令：

  bash
  docker pull gitpod/workspace-base:legacy-dazzle-v1
  

Gitpod 集成配置

在 Gitpod 项目中通过 .gitpod.yml 文件指定使用该镜像：

yaml
# .gitpod.yml 配置示例
image:
  name: gitpod/workspace-base:latest  # 指定镜像及标签

Docker 部署方案示例

本地测试运行

拉取并交互式运行镜像：

bash
# 拉取最新版
docker pull gitpod/workspace-base:latest

# 启动交互式容器
docker run -it --rm gitpod/workspace-base:latest /bin/bash

使用 legacy-dazzle-v1 标签

bash
# 拉取 dazzlev1 兼容版本
docker pull gitpod/workspace-base:legacy-dazzle-v1

# 启动容器
docker run -it --rm gitpod/workspace-base:legacy-dazzle-v1 /bin/bash

注意事项

• 镜像贡献：欢迎通过 GitHub 仓库 提交 PR 参与改进
• 高级配置：具体环境变量和工具配置细节，请参考 Gitpod ***文档 或对应镜像的 Docker Hub 说明页