使用 Visual Studio Code (VSCode) 的 Dev Containers 进行 Odoo 开发和调试是一个高效的方法,尤其是当你希望在一个清洁且一致的开发环境中工作时。以下是设置和配置 Dev Container 以在 Docker 环境中单步调试 Odoo 系统的步骤:
### 步骤 1: 准备 Docker 环境
确保你的机器上安装了 Docker 和 VSCode。同时安装 VSCode 的 “Remote - Containers” 扩展,这是使用 Dev Containers 的必要扩展。
### 步骤 2: 创建 Odoo 项目
在你的本地机器上创建一个新的项目文件夹,或者使用现有的 Odoo 项目。
### 步骤 3: 配置 Dev Container
1. **在项目根目录中创建 `.devcontainer` 目录**。
2. **创建 `devcontainer.json` 文件**,这个文件用于配置你的容器环境。以下是一个基本示例:
```json
{
"name": "Odoo Development",
"image": "odoo:14.0",
"appPort": ["8069:8069"],
"settings": {
"terminal.integrated.shell.linux": "/bin/bash"
},
"extensions": ["rebornix.ruby"],
"remoteUser": "root",
"postCreateCommand": "apt-get update && apt-get install -y git"
}
```
这个配置使用了官方的 Odoo 14 Docker 镜像。根据你的需要调整 Odoo 版本或其他配置。
3. **创建 `Dockerfile`**(如果你需要自定义 Docker 镜像):
```dockerfile
FROM odoo:14.0
USER root
RUN apt-get update && apt-get install -y git python3-dev
COPY ./requirements.txt /mnt/extra-addons/
RUN pip3 install -r /mnt/extra-addons/requirements.txt
```
根据你的项目需求调整这个 `Dockerfile`。
### 步骤 4: 配置 Odoo
确保你的 `odoo.conf` 配置文件正确设置,并且数据库参数、addons 路径等都正确无误。你可以通过 Docker volumes 来确保数据的持久化。
### 步骤 5: 启动和连接到容器
在 VSCode 中,使用 “Remote-Containers: Open Folder in Container...” 命令打开你的项目文件夹。VSCode 将构建(如果需要)并启动容器,然后将代码编辑器连接到容器。
### 步骤 6: 配置调试器
1. **创建一个 `.vscode` 文件夹**(如果尚未存在)。
2. **在 `.vscode` 文件夹中创建 `launch.json` 文件**。这个文件定义了调试配置。以下是一个基本的 Python 调试配置示例:
```json
{
"version": "0.2.0",
"configurations": [
{
"name": "Python: Odoo",
"type": "python",
"request": "launch",
"program": "/usr/bin/odoo",
"args": ["--config=/etc/odoo/odoo.conf"],
"console": "integratedTerminal"
}
]
}
```
调整 `program` 和 `args` 以匹配你的 Odoo 安装路径和配置文件位置。
### 步骤 7: 启动调试会话
在 VSCode 中,打开 “Run and Debug” 视图,选择你刚才创建的配置,然后点击开始调试。这将启动 Odoo,并允许你在 VSCode 中进行单步调试。
通过这些步骤,你可以在 Docker 容器中高效地开发和调试 Odoo,同时享受一致的开发环境。