mirror of
https://github.com/jackyzha0/quartz.git
synced 2025-12-24 13:24:05 -06:00
PUSH NOTE : docker 环境构建 Everest.md
This commit is contained in:
wangzipai
parent
a122554aea
commit
79363c0626
250
content/Notes/OCPP/Everest/搭建环境/docker 环境构建 Everest.md
Normal file
250
content/Notes/OCPP/Everest/搭建环境/docker 环境构建 Everest.md
Normal file
@ -0,0 +1,250 @@
|
||||
---
|
||||
date created: 2025-03-19 15:42
|
||||
date updated: 2025-04-02 11:45
|
||||
tags:
|
||||
- docker
|
||||
- Everest
|
||||
link: "false"
|
||||
share: "true"
|
||||
---
|
||||
|
||||
devcontainer 设置是开发 EVerest 项目的一种便捷方式。它使用 Docker 创建跨不同机器一致的开发环境。
|
||||
|
||||
cd /workspace/.devcontainer && docker compose up -d# 创建基于 devcontainer 的 EVerest 工作区
|
||||
|
||||
## 创建并进入工作区
|
||||
|
||||
```shell
|
||||
mkdir everest_workspace
|
||||
cd everest_workspace
|
||||
```
|
||||
|
||||
## 运行安装脚本
|
||||
|
||||
```shell
|
||||
export BRANCH="main" && bash -c "$(curl -s --variable %BRANCH=main --expand-url https://raw.githubusercontent.com/EVerest/everest-dev-environment/{{BRANCH}}/devcontainer/setup-devcontainer.sh)"
|
||||
```
|
||||
|
||||
该脚本将要求您提供以下信息：
|
||||
|
||||
1. Workspace directory: 默认为当前目录，按回车键即可保持默认。
|
||||
2. everest-dev-environment version: 默认为“main”。按 Enter 键保留默认设置。
|
||||
|
||||
mac下会出现 **realpath** 命令不支持 **-m** 选项的问题。执行`brew install coreutils`，然后将下面的行添加到你的 shell 配置文件，配置环境变量。
|
||||
|
||||
```shell
|
||||
export PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH"
|
||||
```
|
||||
|
||||
## 在 Visual Studio Code 中打开工作区
|
||||
|
||||
在 vscode 中打开这个文件夹，VS Code 将要求在容器中重新打开工作区。单击按钮“在容器中重新打开”。
|
||||
|
||||
等待安装各种依赖。
|
||||
|
||||
# everest-core
|
||||
|
||||
## 下载核心库everest-core
|
||||
|
||||
```shell
|
||||
everest clone everest-core
|
||||
```
|
||||
|
||||
或者
|
||||
|
||||
```shell
|
||||
everest clone everest-core --https
|
||||
```
|
||||
|
||||
## 编译并安装
|
||||
|
||||
```shell
|
||||
mkdir -p everest-core/build
|
||||
cd everest-core/build
|
||||
cmake ..
|
||||
make -j$(nproc) install
|
||||
```
|
||||
|
||||
这里对比[[/content/Notes/OCPP/Everest/搭建环境/构建EVerest|构建EVerest]]的内容，不需要先构建 edm 的内容。在devcontainer环境中，很多初始步骤已经完成了，这与标准安装步骤不同。
|
||||
在devcontainer中：
|
||||
|
||||
- EDM==已预安装== - edm命令已在/usr/local/bin/edm可用
|
||||
- Everest工具已预安装 - everest命令也已在~/.local/bin/everest可用
|
||||
- 环境已预配置 - devcontainer已经设置好了所需的环境变量和依赖项
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
BaseImage["基础Docker镜像<br>ghcr.io/everest/everest-ci/dev-env-base"]
|
||||
DevTools["预安装开发工具<br>(edm, everest等)"]
|
||||
DevContainer["完整开发容器"]
|
||||
Workspace["工作区目录<br>(/workspace)"]
|
||||
|
||||
BaseImage --> |构建时安装| DevTools
|
||||
DevTools --> DevContainer
|
||||
Workspace --> |挂载| DevContainer
|
||||
|
||||
style DevContainer fill:#e0f7fa,stroke:#0277bd,stroke-width:2px
|
||||
```
|
||||
|
||||
# docker 的隔离性
|
||||
|
||||
DevContainer的隔离性及其与直接在环境中开发的区别，可以通过下图清晰地理解：
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph "主机系统"
|
||||
Host["主机OS (宿主机)"]
|
||||
IDE["VSCode (IDE)"]
|
||||
|
||||
subgraph "Docker Engine"
|
||||
subgraph "DevContainer"
|
||||
Container["容器OS (Ubuntu/Linux)"]
|
||||
EVLibs["EVerest库和依赖"]
|
||||
BuildTools["构建工具 (cmake, make等)"]
|
||||
EVCore["everest-core项目文件"]
|
||||
DevEnv["开发工具 (edm, everest等)"]
|
||||
end
|
||||
end
|
||||
|
||||
Mount["共享卷 (Volume)"]
|
||||
|
||||
Host --- IDE
|
||||
IDE --- Docker
|
||||
Docker --- Container
|
||||
Host --- Mount
|
||||
Mount --- Container
|
||||
end
|
||||
|
||||
style DevContainer fill:#e0f7fa,stroke:#0277bd,stroke-width:2px
|
||||
style Docker fill:#f5f5f5,stroke:#616161,stroke-width:1px
|
||||
```
|
||||
|
||||
## DevContainer的隔离性机制
|
||||
|
||||
### Docker容器隔离
|
||||
|
||||
DevContainer利用Docker容器技术实现以下隔离：
|
||||
|
||||
- **进程隔离**: 容器内的进程与主机系统隔离运行
|
||||
- **文件系统隔离**: 容器有自己独立的文件系统
|
||||
- **网络隔离**: 容器有独立的网络命名空间
|
||||
- **资源隔离**: 可限制CPU、内存等资源使用
|
||||
|
||||
### 共享卷机制
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
subgraph "主机文件系统"
|
||||
HostDir["工作目录<br>/Users/wyq/Code/github/everest_workspace"]
|
||||
end
|
||||
|
||||
subgraph "容器文件系统"
|
||||
ContainerDir["/workspace"]
|
||||
end
|
||||
|
||||
HostDir <--> ContainerDir
|
||||
|
||||
style HostDir fill:#e3f2fd,stroke:#1565c0
|
||||
style ContainerDir fill:#e8f5e9,stroke:#2e7d32
|
||||
```
|
||||
|
||||
- 主机工作目录被"挂载"到容器的`/workspace`目录
|
||||
- **对容器中文件的修改立即反映到主机文件系统**
|
||||
- 这使您可以使用主机上的工具(如Git)来管理文件，同时在容器内构建/运行
|
||||
|
||||
### VSCode一体化
|
||||
|
||||
```mermaid
|
||||
graph LR
|
||||
VSCode["VSCode (主机)"] --> Extension["Remote-Containers<br>扩展"]
|
||||
Extension --> API["Docker API"]
|
||||
API --> Container["开发容器"]
|
||||
Container --> Shell["容器Shell"]
|
||||
Container --> Extensions["VSCode扩展<br>(在容器内运行)"]
|
||||
Container --> Debug["调试器"]
|
||||
|
||||
style VSCode fill:#bbdefb,stroke:#1976d2
|
||||
style Container fill:#c8e6c9,stroke:#388e3c
|
||||
```
|
||||
|
||||
- VSCode的Remote-Containers扩展充当桥梁
|
||||
- 编辑器UI在主机上运行，但所有命令在容器内执行
|
||||
- 调试、终端、代码补全都在容器环境中运行
|
||||
|
||||
## 与直接在主机环境开发的区别
|
||||
|
||||
| 特性 | DevContainer | 直接在主机环境 |
|
||||
| ---------- | ---------------- | --------------- |
|
||||
| **依赖管理** | 所有依赖预安装在容器中，相互隔离 | 全局安装依赖，可能产生版本冲突 |
|
||||
| **环境一致性** | 所有开发者使用完全相同的环境 | 环境因开发者配置不同而异 |
|
||||
| **环境污染** | 容器删除后不留痕迹 | 安装的工具和库留在系统中 |
|
||||
| **多项目兼容性** | 不同项目可使用不同版本的同一依赖 | 依赖版本冲突需要虚拟环境等解决 |
|
||||
| **资源使用** | 更高的存储和内存开销 | 较低的系统资源占用 |
|
||||
| **安全隔离** | 提高安全性，容器权限有限 | 工具运行在本地系统，权限较高 |
|
||||
|
||||
## EVerest特有的优势
|
||||
|
||||
对于EVerest项目，DevContainer提供了：
|
||||
|
||||
1. **预配置工具链**: 所有EVerest特有工具(如edm、everest)已预装
|
||||
2. **编译环境优化**: 已配置好所有编译依赖和标准
|
||||
3. **一致性测试**: 确保所有开发者的代码在相同环境中测试
|
||||
4. **简化协作**: 新开发者可快速上手，无需复杂的环境设置
|
||||
|
||||
这种隔离方式使得EVerest项目开发既能保持环境一致性，又不会污染您的主机系统，同时还能享受VSCode提供的现代开发体验。
|
||||
|
||||
# 连接平台
|
||||
|
||||
## 修改平台 URL
|
||||
|
||||
例如，如果想连接到地址为ws://example.com:8080的OCPP平台，可以使用以下命令：
|
||||
|
||||
```shell
|
||||
cd /workspace/everest-core/build/dist/share/everest/modules/OCPP201/component_config/standardized
|
||||
cp InternalCtrlr.json InternalCtrlr.json.bak # 备份原文件
|
||||
sed -i 's|"ocppCsmsUrl": "ws://localhost:9000"|"ocppCsmsUrl": "ws://example.com:8080"|g' InternalCtrlr.json
|
||||
```
|
||||
|
||||
## 启动 Everest
|
||||
|
||||
```shell
|
||||
./everest-core/build/run-scripts/run-sil-ocpp201.sh
|
||||
```
|
||||
|
||||
### 解决 mqtt连接问题
|
||||
|
||||
```shell
|
||||
cd /workspace/.devcontainer && docker compose up -d
|
||||
```
|
||||
|
||||
### 修复连接问题
|
||||
|
||||
|
||||
不知道哪来的野生时间格式，一直打印。
|
||||
|
||||
```c
|
||||
ocpp::DateTime to_ocpp_datetime_or_now(const std::string& datetime_string) {
|
||||
std::optional<ocpp::DateTime> timestamp;
|
||||
try {
|
||||
#ifndef UL_FIX_PATCH
|
||||
// Fix malformed datetime string format if needed
|
||||
std::string fixed_datetime = datetime_string;
|
||||
|
||||
// Check for format like "2025-03-20:02:26:05GMT" and fix it
|
||||
std::regex malformed_pattern("(\\d{4}-\\d{2}-\\d{2}):(\\d{2}:\\d{2}:\\d{2})(GMT|UTC)?");
|
||||
if (std::regex_match(datetime_string, malformed_pattern)) {
|
||||
// Replace ":" between date and time with "T" and ensure proper timezone format
|
||||
fixed_datetime = std::regex_replace(datetime_string, malformed_pattern, "$1T$2Z");
|
||||
EVLOG_info << "Fixed malformed datetime format from: " << datetime_string << " to: " << fixed_datetime;
|
||||
}
|
||||
|
||||
return ocpp::DateTime(fixed_datetime);
|
||||
#else
|
||||
return ocpp::DateTime(datetime_string);
|
||||
#endif
|
||||
} catch (const ocpp::TimePointParseException& e) {
|
||||
EVLOG_warning << "Could not parse datetime string: " << e.what() << ". Using current DateTime instead";
|
||||
}
|
||||
return ocpp::DateTime();
|
||||
}
|
||||
```
|
||||
Loading…
Reference in New Issue
Block a user