# CoolAdminCodespace

CoolAdmin 集成化开发环境,基于 Codespace,同时也可以在本地或 Linux 服务器远程运行(基于 vscode 远程开发功能), 提供了一套完整的开发、构建、部署、运维的工具链,帮助开发者快速构建、部署、运维应用。

# 仓库地址

https://github.com/cool-team-official/cool-admin-codespace (opens new window)

仓库分支说明

  • main: 主分支,codespace 使用本分支
  • local: 本地运行分支,vscode 远程开发使用本分支
  • docker-builder: docker 镜像构建分支,用于构建 docker 镜像

# 在线体验

Open in GitHub Codespaces (opens new window)

在 Codespace 中打开 (opens new window)

TIP

如果你是第一次使用 Codespace,可以参考 Codespace 官方文档 (opens new window)。 Codespace 是 GitHub 提供的在线开发环境,可以在浏览器中直接打开一个完整的开发环境,无需本地安装任何开发工具,也无需配置环境,可以直接开始开发。 当前每个 github 账号每月有 120 个 CPU 时的免费使用时间,超过后会收费,具体收费标准可以参考 https://docs.github.com/cn/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces (opens new window)

# 本地运行

如果你不想使用 Codespace,也可以在本地或 Linux 服务器上运行,只需要安装 vscode 并安装 Remote - Containers (opens new window) 插件,然后打开本仓库的local分支,vscode 会自动提示你使用远程开发,选择 Remote-Containers: Reopen in Container 即可。

TIP

因为 Windows 本地文件系统映射到容器中的性能问题,所以不建议在 Windows 本地运行,可以在 Windows 上安装 WSL2,然后在 WSL2 中运行。

当前操作系统: Debian GNU/Linux 11 (bullseye)

当前组件:

nodejs: 18.12.1
npm: 8.19.2
yarn: 1.22.19
nvm: 0.39.2
go: go1.19.3
docker: 20.10.21
Python:3.9.2

# 下载

下载local分支代码

git clone --depth=1 --branch=local https://github.com/cool-team-official/cool-admin-codespace

或者下载 zip (opens new window) 文件.

wget -O cool-admin-codespace.zip \
https://github.com/cool-team-official/cool-admin-codespace/archive/refs/heads/local.zip

TIP

如果下载速度过慢,可以使用 pgit (opens new window) 工具下载。

解压

unzip cool-admin-codespace.zip

# 使用

  1. 安装 Docker (opens new window)
  2. 安装 VSCode (opens new window)
  3. 安装 Remote - Containers (opens new window) 插件
  4. 打开项目, 点击左下角的绿色按钮, 选择 Reopen in Container 即可

# 手动拉取镜像

如果镜像摘取失败或拉取速度过慢, 可以手动拉取镜像.

# Docker Hub
docker pull gcslaoli/cool-admin-codespace
# Aliyun
docker pull registry.cn-beijing.aliyuncs.com/gcslaoli/cool-admin-codespace
Last Updated: 2022/11/13 12:30:47