logo
0
0
WeChat Login
Forkfromyamingnetwork/ide, behindmain47 commits
设置Docker镜像中文环境和时区,优化环境变量配置

IDE 开发环境镜像

概述

本项目提供预配置的开发环境Docker镜像,包含完整的代码编写环境和工具链,支持:

  • 多系统支持(Debian、AlmaLinux等)
  • 多架构支持(amd64、arm64)
  • 预装开发工具(VSCode、Git等)
  • 易于自定义和扩展

CI状态 流水线状态

注意:使用前请确保已安装Docker并具有适当的权限 注意:当前默认latest镜像为docker.cnb.cool/yamingnetwork/ide:latest(Debian 13),要使用Debian12请使用标签:docker.cnb.cool/yamingnetwork/ide:12注意: 所有镜像均支持多架构(amd64/arm64),ARMv8架构使用相同的标签。

快速开始

使用预构建镜像

$:
  vscode:
    - docker:
        image: docker.cnb.cool/yamingnetwork/ide:latest
      runner:
        cpus: 8
      services:
        - vscode
        - docker

环境变量配置

基本配置

在密钥仓库创建 .env.git.yml 文件并配置以下变量:

# Git配置
GITHUB_USER=your_username
GITHUB_EMAIL=your_email@example.com
GITHUB_TOKEN=your_personal_access_token

通过imports导入配置

$:
  vscode:
    - docker:
        image: docker.cnb.cool/yamingnetwork/ide/almalinux:10
      runner:
        cpus: 8      
      services:
        - vscode
        - docker
      imports: https://cnb.cool/<你的密钥仓库>/-/blob/<分支信息>/.env.git.yml
      stages:
        - name: 配置 Git 全局信息
          script: |
            git config --global user.name "$GITHUB_USER"
            git config --global user.email "$GITHUB_EMAIL"
            git config --global credential.helper store
            echo "https://$GITHUB_USER:$GITHUB_TOKEN@github.com" > ~/.git-credentials
            chmod 600 ~/.git-credentials

变量命名规范

变量名规则示例
仅包含字母、数字和下划线GITHUB_USER
不以数字开头USER_1
区分大小写Api_Key

镜像使用指南

标准镜像

$:
  vscode:
    - docker:
        image: docker.cnb.cool/yamingnetwork/ide:latest

RHEL系列镜像支持8 9 10

$:
  vscode:
    - docker:
        image: docker.cnb.cool/yamingnetwork/ide/almalinux:8
# AlmaLinux 9
image: docker.cnb.cool/yamingnetwork/ide/almalinux:9
# AlmaLinux 10
image: docker.cnb.cool/yamingnetwork/ide/almalinux:10

自定义构建

构建标准镜像命令

docker build \
  --build-arg BASE_IMAGE=debian:12 \
  -f .ide/Dockerfile.debian \
  -t docker.cnb.cool/yamingnetwork/ide:latest .

支持的基础镜像

镜像名称描述
debian:13Debian Trixie (latest)
debian:12Debian Bookworm
ubuntu:22.04Ubuntu Jammy
ubuntu:24.04Ubuntu Noble
almalinux:8AlmaLinux 8
almalinux:9AlmaLinux 9
almalinux:10AlmaLinux 10

高级配置

Git凭证配置示例以GitHub克隆私有仓库为例

stages:
  - name: 配置Git凭证
    script: |
      git config --global user.name "$GITHUB_USER"
      git config --global user.email "$GITHUB_EMAIL"
      echo "https://$GITHUB_USER:$GITHUB_TOKEN@github.com" > ~/.git-credentials
      chmod 600 ~/.git-credentials

多阶段配置示例

$:
  vscode:
    - docker:
        image: docker.cnb.cool/yamingnetwork/ide/almalinux:10
      runner:
        cpus: 8      
      services:
        - vscode
        - docker
      imports: https://cnb.cool/<你的密钥仓库地址>/-/blob/<仓库分支>/.env.git.yml
      stages:
        - name: 配置 Git 全局信息
          script: |
            git config --global user.name "$GITHUB_USER"
            git config --global user.email "$GITHUB_EMAIL"
            git config --global credential.helper store
            echo "https://$GITHUB_USER:$GITHUB_TOKEN@github.com" > ~/.git-credentials
            chmod 600 ~/.git-credentials
        - name: 更新系统软件包
          script: |
            dnf update -y
            dnf install -y custom-package 

为有测试本地模型需求添加ollama

  • 默认模型存放目录设置为:
/workspace/models
  • 配置云开发环境启动
      env:
        CNB_WELCOME_EXECUTE_COMMAND: |
          ollama ls
      stages:
        - name: start ollama
          script: |
            export OLLAMA_FLASH_ATTENTION=1
            nohup ollama serve > /dev/null 2>&1 &

提示:更多配置示例请参考项目文档

About

Debian12 创建的ide