Tasks

🚀 开发容器用于MCP任务服务器

本项目提供了一系列配置文件，借助VS Code的Remote - Containers扩展，能够为MCP任务服务器搭建出一致且高效的开发环境。

🚀 快速开始

先决条件

• 在您的机器上安装Docker。
• 在您的机器上安装Visual Studio Code。
• 在VS Code中安装Remote - Containers扩展。

操作步骤

1. 在VS Code中打开此仓库。
2. 当收到提示时，点击“在容器中重新打开”，或者通过命令_palette (F1)运行“远程 - 容器：在容器中重新打开”命令。
3. VS Code会自动构建容器并设置开发环境，首次操作可能需要几分钟时间。
4. 容器构建完成后，您将获得一个配置完备的Java开发环境，其中包含了所有必要的扩展和工具。

✨ 主要特性

• Java 21环境：配备Spring Boot开发环境，为Java开发提供强大支持。
• PostgreSQL数据库：可用于本地开发，方便进行数据存储和管理。
• Docker - in - Docker支持：能够运行容器化应用程序，增强开发的灵活性。
• Git集成：便于进行版本控制和代码管理。
• 预安装扩展：推荐的VS Code扩展已预安装，提升开发效率。
• 代码工具配置：配置了代码格式化和linting工具，保证代码质量。
• Gradle构建工具：用于项目的构建和管理。
• ZSH终端：搭配Oh My Zsh，提供更好的终端使用体验。

📦 安装指南

按照上述快速开始中的先决条件和操作步骤进行安装和配置，即可完成开发环境的搭建。

💻 使用示例

自定义环境

可以通过修改以下文件来自定义开发环境：

• devcontainer.json：用于配置VS Code设置、扩展和容器设置。
• Dockerfile：可使用额外工具或配置自定义容器图像。
• docker-compose.yml：用于添加或修改服务，例如数据库或其他依赖项。
• .zshrc：通过别名和配置自定义shell环境。

有用命令

开发容器提供了几个实用的别名：

Gradle 命令

• gw：运行Gradle包装器
• gwb：运行Gradle构建
• gwt：运行Gradle测试
• gwc：运行Gradle清理
• gwcb：运行Gradle清理构建
• gwct：运行Gradle清理测试
• gwi：运行Spring Boot应用程序

Docker 命令

• d：代表Docker
• dc：代表Docker Compose
• dps：代表Docker ps
• di：代表Docker images

Git 命令

• gs：查看Git状态
• ga：执行Git添加操作
• gc：执行Git提交操作
• gp：执行Git推操作
• gl：执行Git拉取操作
• gco：切换Git分支
• gb：查看Git分支

🔧 技术细节

本开发容器的核心在于利用VS Code的Remote - Containers扩展，结合Docker和相关配置文件，构建出一个标准化的开发环境。通过devcontainer.json、Dockerfile、docker-compose.yml等文件的协同工作，实现了对开发环境的灵活配置和管理。同时，为了提升开发效率，还提供了一系列有用的命令别名。

📚 详细文档

故障排除

如果您在开发容器中遇到任何问题，可以按照以下步骤进行排查：

1. 使用“远程 - 容器：重建容器”命令尝试重新构建容器。
2. 检查Docker日志中的任何错误信息。
3. 确保您的Docker Desktop分配了足够的系统资源。
4. 确保主机机器上的所有所需端口处于可用状态。