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. 確保主機機器上的所有所需端口處於可用狀態。